ScriptManager 控件概述

在部分页呈现期间，可通过执行以下操作来处理错误：

• 需要设置 AllowCustomErrorsRedirect 属性。 当异步回发过程中发生错误时，此属性将决定如何使用 Web.config 文件的自定义错误部分。

• 处理 ScriptManager 控件的 AsyncPostBackError 事件，该事件在异步回发期间出现页错误时引发。

• 设置 AsyncPostBackErrorMessage 属性，该属性是发送到浏览器的错误消息。

Microsoft AJAX Library 可向 JavaScript 添加类型系统扩展，以提供命名空间、继承、接口、枚举、映射以及字符串和数组的 Helper 函数。 这些扩展可以在客户端脚本中提供与 .NET Framework 的功能类似的功能。利用这些功能，可按一种结构化方式编写支持 Ajax 的 ASP.NET 应用程序，这不仅能提高可维护性，还简化了添加功能以及对功能分层的操作。向 ASP.NET 网页添加 ScriptManager 控件会自动包括类型系统扩展名，以便可以在客户端脚本中使用库。有关更多信息，请参见使用 Microsoft Ajax Library 创建自定义客户端脚本。

使用 ScriptManager 控件可管理您为参与部分页更新的控件创建的资源。 这些资源包括脚本、样式、隐藏字段和数组。 ScriptManager 控件的 Scripts 集合中针对浏览器中可用的每个脚本包含一个 ScriptReference 对象。 可以以声明方式或编程方式指定脚本。

ScriptManager 控件还公开一些注册方法，您可使用这些方法以编程方式管理客户端脚本和隐藏字段。 当为支持部分页更新的脚本或隐藏字段注册时，必须调用 ScriptManager 控件的注册方法。 （若要为部分页更新不需要的脚本注册，请使用 ClientScriptManager 类的方法。）

注意
页上使用 ScriptManager 控件注册的任何脚本以及所有事件处理脚本必须位于页上的 form 元素内。 否则，将不会注册或执行脚本。

有关 ClientScriptManager 控件注册方法的列表，请参见使用 Microsoft Ajax Library 创建自定义客户端脚本和 ClientScriptManager 类概述。

若要注册想要从支持 AJAX 的 ASP.NET 页调用的 Web 服务，请通过将该 Web 服务添加到 ScriptManager 控件的 Services 集合来注册它。 Microsoft Ajax Framework 为 Services 集合中的每个 ServiceReference 对象生成一个客户端代理对象。 这些代理类及其强类型成员将简化从客户端脚本使用 Web 服务的过程。

可通过编程方式将 ServiceReference 对象添加到 Services 集合中，以便在运行时注册 Web 服务。

Microsoft AJAX Library 包含用于从 JavaScript 直接调用 ASP.NET 2.0 Forms 身份验证、配置文件和角色应用程序服务的代理类。 如果要使用自定义身份验证服务，则可通过使用 ScriptManager 控件来为该服务注册。有关更多信息，请参见通过 Microsoft Ajax 使用 Forms 身份验证、通过 Microsoft Ajax 使用配置文件信息和通过 Microsoft Ajax 使用角色信息。

只能向页添加 ScriptManager 控件的一个实例。 该页可以直接包含该控件，也可以将其间接包含在嵌套的组件中，如用户控件、母版页的内容页或嵌套的母版页。 如果页已包含 ScriptManager 控件，但嵌套的组件或父组件需要 ScriptManager 控件的其他功能，则该组件可以包含 ScriptManagerProxy 控件。 例如，ScriptManagerProxy 控件使您能够添加特定于嵌套的组件的脚本和服务。