ScriptManager控件属性与方法
ScriptManager控件是ASP.NET Ajax中非常重要的一个控件,所以在使用它之前用户要对该控件的属性与方法有一定的了解,只有这样用户才能更好使用该控件来开发出符合要求的项目。它的一些重要属性与方法如表9-1所示:
表9-1 ScriptManager控件的属性与方法
属性或方法 | 说明 |
AllowCustomErrorsRedirect | 该属性为布尔类型,默认值为true,表示在异步更新发生异常时是否使用Web.config中<customErrors>节中的设定。Web.config的<customErrors>节中可以指定应用程序级别的错误处理页面,这将通过重定向至某个专门显示异常的页面来实现 |
AsyncPostBackErrorMessage | 该属性表示了异步回送过程中发生的异常将显示出的消息,我们可在ScriptManager的声明中设置这个属性 |
AsyncPostBackTimeout | 异步回传时超时限制,默认值为90,单位为秒 |
AsyncPostBackError | 异步回传发生异常时的服务端处理函数,在这里可以捕获信息并作相应的处理。 |
AuthenticationService | 客户端身份验证服务的相关引用 |
EnablePageMethods | 该属性用于设定客户端javascript直接调用服务端静态WebMethod |
EnablePartialRendering | 该属性可以使页面的某些控件或某个区域实现Ajax类型的异步回送和局部更新功能。若需要启用页面的局部更新模式,则应该将EnablePartialRendering属性设置为true,保持默认值即可 |
EnableScriptGlobalization | ScriptManager绘制的脚本是否支持不同语种,默认值为false |
EnableScriptLocalization | ScriptManager绘制的脚本是否需要本地化,默认值为false |
LoadScriptBeforeUI | 是否需要在加载UI控件前首先加载脚本,默认为false |
ProfileService | 与之相关的用户个性化信息管理类 |
ScriptMode | 指定ScriptManager发送到客户端的脚本的模式,有四种模式:Auto,Inherit,Debug,Release,默认值为Auto。具体如表9-2所示 |
ScriptPath | 设置所有的脚本块的根目录,作为全局属性,包括自定义的脚本块或者引用第三方的脚本块。如果在Scripts中的<asp:ScriptReference/>标签中设置了Path属性,它将覆盖该属性 |
Scripts | 页面所有的脚本集合 |
Services | 页面相关的Web Service |
ResolveScriptReference | 指定ResolveScriptReference事件的服务器端处理函数,在该函数中可以修改某一条脚本的相关信息如路径、版本等。 |
表9-2 ScriptMode的属性值
属性值 | 说明 |
Auto | 该属性值用于根据web.config配置中的retail配置节的值来决定脚本的模式。如果retail配置节的值为true,则把发布模式的脚本发送到客户端,反之则发送调试脚本 |
Debug | 该属性值用于当retail配置节的值不为true时,则发送debug版本的客户端脚本 |
Release | 该属性值用于当retail配置节的值不为false时,则发送Release版本的客户端脚本 |
Inherit | 该属性值意义同Auto相同 |