这个控件可以处理WEB页面上的所有脚本组件的页面局部更新,以及生成能够在JAVASCRIPT中访问的WEB服务相关的客户端代理脚本。
在所有需要支持asp.net ajax 的ASP.NET 页面上,只能有一个ScriptManager控件。
ScriptManger控件的静态方法及其说明:
RegisterArrayDeclaration() -- 在页面上注册一个JAVASCRIPT组数。
RegisterClientScriptBlock() -- 在页面上注册一段javascript脚本
RegisterClientScriptInclude() -- 在页面上注册一个包含javascript脚本文件
RegisterClientScriptResource() -- 在页面上注册一个包含javascript脚本的资源
RegisterExpandoAttribute() -- 在页面上注册一个名称、键对
RegisterHiddenField() -- 在页面上注册一个隐藏的域
RegisterOnSubmitStatement() -- 在页面上注册一段提交页面时执行的javascript代码
RegisterStartupScript() -- 在页面上注册一段startup的代码
GetCurrent() -- 获取当前页面的ScriptManager实例
ScriptManager控件常用的属性及其说明:
AllowCustomErrorsRediect -- 表示是否使用Web.Config中的自定义错误配置节<customErrors>.默认为true
AsyncPostBackErrorMessage -- 异步回传发生错误时自定义提示错误信息
AsyncPostBackSourceElementID -- 引发异步回发的控件的ID
AsyncPostBackTimeout -- 异步回传时超时限制,默认值为90,单位为秒
AuthenticationService -- 与当前ScriptManager实例相关的AuthenticationServiceManager对象
EnablePartialRendering -- 表示是否支持页面的局部更新,默认值为true
EnableScriptGlobaliaztion -- 表示是否启用脚本的国际化功能
EnableScriptLocalization -- 表示是否启用脚本的本地化功能
IsDebuggingEnabled -- 表示当前的HTTP请求是否为debug模式
IsInAsycnPostBack -- 表示当前的回发是否为部分更新模式
ProfileService -- 与当前ScriptManager实例相关的ProfileServiceManager对象
ScriptLoadTimeout -- 载入脚本时超时限制,单位为秒
ScriptMode -- 指定ScriptManager发送到客户端的脚本的模式。存在4种模式:Auto,Inherit,Debug,Release 默认是Auto
ScriptPath -- 设置所有脚本块的根目录(为全局属性)。如果在Scripts中的<asp:ScriptReference />标签中设置了Path属性,它将覆盖该属性。
Scripts -- 动态引入的脚本集合
Services -- 动态引入的脚本服务集合
ScriptManager控件的方法及其说明:
RegisterAsyncPostBackControl() -- 为异步回发注册一个控件
registerDataItem() -- 在部分更新过程中向控件发送自定义数据
RegisterDispose() -- 在页面中注册执行Dispose操作的脚本
RegisterExtenderControl(<(Of TExtenderControl)>) -- 向页面注册一个Extender控件
、
RegisterPostBackControl() -- 向页面注册一个启用回发作用的控件
RegisterScriptControl(<()>) -- 向页面注册一个脚本控件
RegisterScriptDescriptors() -- 调用一个ScriptControl或ExtenderControl类,并返回它的实例
ScriptManager控件的事件及其说明:
OnAsyncPostBackError: 异步回传发生异常时的服务端处理函数。在该函数中可以捕获一场信息并做相应处理
OnResolveScriptReference:指定 ResolveScriptReference事件的服务器端处理函数。在该函数中可以修改某一条脚本的相关信息如路径、版本。