【IT168 专稿】
源码下载
摘要:该节主要介绍ASP.NET AJAX Extensions服务器端控件 ScriptManager和ScriptManagerProxy。
ScriptManager控件包括在ASP.NET AJAX Extensions中,它提供处理页面上的所有ASP.NET AJAX组件(UpdatePanel、UpdateProgress等)的支持。并且生成相关的客户端代理脚本以便能够在客户端脚本中访问Web Service。所有需要支持ASP.NET AJAX的ASP.NET页面上只能有一个ScriptManager控件。在ScriptManager控件中我们可以指定需要的脚本库,或者指定通过JS来调用的Web Service,以及调用AuthenticationService和ProfileService,还有页面错误处理等。
总而言之,ScriptManager控件是整个ASP.NET AJAX Extensions 的调度中心,没有该控件的存在其它控件是不能工作的。如果,您对asp.net 2.0熟悉的话,应该知道WebpartManager,它的功能和ScriptManager一样。
除了ScriptManager外,还有一个ScriptManagerProxy控件,这个控件只不过是当MasterPage中已经有ScriptManager时,在Content中只能使用ScriptManagerProxy了,其它功能和ScriptManager基本上一样。因此,本文将主要介绍ScriptManager的使用。
一、ScriptManager控件主要属性/方法
|
属性/方法 |
描述 |
|
AllowCustomError |
和config中的自定义错误配置区<customErrors>相联系,是否使用配置,默认值为true |
|
AsyncPostBackErrorMessage |
异步回传发生错误时的自定义提示错误信息, |
|
AsyncPostBackTimeout |
异步回传时超时限制,默认值为90,单位为秒 |
|
EnablePartialRendering |
是否支持页面的局部更新,默认值为True,一般不需要修改 |
|
ScriptMode |
指定ScriptManager发送到客户端的脚本的模式,有四种模式:Auto,Inherit,Debug,Release,默认值为Inherit。 |
|
ScriptPath |
设置所有的脚本块的根目录,作为全局属性,包括自定义的脚本块或者引用第三方的脚本块。如果在Scripts中的<asp:ScriptReference/>标签中设置了Path属性,它将覆盖该属性。 |
|
OnAsyncPostBackError |
异步回传发生异常时的服务端处理函数,在这里可以捕获一场信息并作相应的处理。 |
|
OnResolveScriptReference |
指定ResolveScriptReference事件的服务器端处理函数,在该函数中可以修改某一条脚本的相关信息如路径、版本等。 |