脚本管理控件ScriptManager

     这个控件可以处理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事件的服务器端处理函数。在该函数中可以修改某一条脚本的相关信息如路径、版本。