ScriptManager控件属性与方法

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相同