ScriptManager 类
定义
重要
一些信息与预发行产品相关，相应产品在发行之前可能会进行重大修改。 对于此处提供的信息，Microsoft 不作任何明示或暗示的担保。
为 Web 和应用程序服务管理 ASP.NET Ajax 脚本库和脚本文件、局部页面呈现以及客户端代理类生成。
public ref class ScriptManager : System::Web::UI::Control, System::Web::UI::IPostBackDataHandler, System::Web::UI::IPostBackEventHandler[System.Drawing.ToolboxBitmap(typeof(EmbeddedResourceFinder), "System.Web.Resources.ScriptManager.bmp")]
public class ScriptManager : System.Web.UI.Control, System.Web.UI.IPostBackDataHandler, System.Web.UI.IPostBackEventHandler[<System.Drawing.ToolboxBitmap(typeof(EmbeddedResourceFinder), "System.Web.Resources.ScriptManager.bmp")>]
type ScriptManager = class
inherit Control
interface IPostBackDataHandler
interface IPostBackEventHandlerPublic Class ScriptManager
Inherits Control
Implements IPostBackDataHandler, IPostBackEventHandler- 继承
- 属性
- 实现
示例
以下示例演示使用 ScriptManager 控件的不同方案。
启用Partial-Page 汇报
以下示例演示如何使用 ScriptManager 控件启用部分页面更新。 在此示例中， Calendar 和 DropDownList 控件位于 控件 UpdatePanel 内。 默认情况下， 属性Always的UpdateMode值为 ， 属性true的ChildrenAsTriggers值为 。 因此，面板的子控件会导致异步回发。
<%@ Page Language="C#" %>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<script runat="server">
void DropDownSelection_Change(Object sender, EventArgs e)
{
Calendar1.DayStyle.BackColor =
System.Drawing.Color.FromName(ColorList.SelectedItem.Value);
}
protected void Calendar1_SelectionChanged(object sender, EventArgs e)
{
SelectedDate.Text =
Calendar1.SelectedDate.ToString();
}
</script>
<html xmlns="http://www.w3.org/1999/xhtml">
<head id="Head1" runat="server">
<title>UpdatePanel Example</title>
</head>
<body>
<form id="form1" runat="server">
<div>
<asp:ScriptManager ID="ScriptManager1"
runat="server" />
<asp:UpdatePanel ID="UpdatePanel1"
runat="server">
<ContentTemplate>
<asp:Calendar ID="Calendar1"
ShowTitle="True"
OnSelectionChanged="Calendar1_SelectionChanged"
runat="server" />
<div>
Background:
<br />
<asp:DropDownList ID="ColorList"
AutoPostBack="True"
OnSelectedIndexChanged="DropDownSelection_Change"
runat="server">
<asp:ListItem Selected="True" Value="White">
White </asp:ListItem>
<asp:ListItem Value="Silver">
Silver </asp:ListItem>
<asp:ListItem Value="DarkGray">
Dark Gray </asp:ListItem>
<asp:ListItem Value="Khaki">
Khaki </asp:ListItem>
<asp:ListItem Value="DarkKhaki"> D
ark Khaki </asp:ListItem>
</asp:DropDownList>
</div>
<br />
Selected date:
<asp:Label ID="SelectedDate"
runat="server">None.</asp:Label>
</ContentTemplate>
</asp:UpdatePanel>
<br />
</div>
</form>
</body>
</html>
<%@ Page Language="VB" %>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<script runat="server">
Sub DropDownSelection_Change(ByVal Sender As Object, ByVal E As EventArgs)
Calendar1.DayStyle.BackColor = _
System.Drawing.Color.FromName(ColorList.SelectedItem.Value)
End Sub
Protected Sub Calendar1_SelectionChanged(ByVal Sender As Object, ByVal E As EventArgs)
SelectedDate.Text = Calendar1.SelectedDate.ToString()
End Sub
</script>
<html xmlns="http://www.w3.org/1999/xhtml">
<head id="Head1" runat="server">
<title>UpdatePanel Example</title>
</head>
<body>
<form id="form1" runat="server">
<div>
<asp:ScriptManager ID="ScriptManager1"
runat="server" />
<asp:UpdatePanel ID="UpdatePanel1"
runat="server">
<ContentTemplate>
<asp:Calendar ID="Calendar1"
ShowTitle="True"
OnSelectionChanged="Calendar1_SelectionChanged"
runat="server" />
<div>
Background:
<br />
<asp:DropDownList ID="ColorList"
AutoPostBack="True"
OnSelectedIndexChanged="DropDownSelection_Change"
runat="server">
<asp:ListItem Selected="True" Value="White">
White </asp:ListItem>
<asp:ListItem Value="Silver">
Silver </asp:ListItem>
<asp:ListItem Value="DarkGray">
Dark Gray </asp:ListItem>
<asp:ListItem Value="Khaki">
Khaki </asp:ListItem>
<asp:ListItem Value="DarkKhaki"> D
ark Khaki </asp:ListItem>
</asp:DropDownList>
</div>
<br />
Selected date:
<asp:Label ID="SelectedDate"
runat="server">None.</asp:Label>
</ContentTemplate>
</asp:UpdatePanel>
<br />
</div>
</form>
</body>
</html>
处理Partial-Page更新错误和注册脚本
以下示例演示如何在部分页面更新期间提供自定义错误处理。 默认情况下，当部分页面更新期间发生错误时，将显示 JavaScript 消息框。 此示例演示如何通过为 AsyncPostBackError 事件提供处理程序并在 事件处理程序中设置 AsyncPostBackErrorMessage 属性来使用自定义错误处理。 还可以设置 AllowCustomErrorsRedirect 属性以指定在部分页面更新期间发生错误时如何使用 Web.config 文件的自定义错误部分。 在此示例中，使用 属性的 AllowCustomErrorsRedirect 默认值。 这意味着，如果 Web.config 文件包含 customErrors 元素，该元素将确定错误显示方式。 有关详细信息，请参阅 customErrors 元素 (ASP.NET 设置架构) 。
<%@ Page Language="C#" %>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<script runat="server">
protected void Button1_Click(object sender, EventArgs e)
{
try
{
int a = Int32.Parse(TextBox1.Text);
int b = Int32.Parse(TextBox2.Text);
int res = a / b;
Label1.Text = res.ToString();
}
catch (Exception ex)
{
if (TextBox1.Text.Length > 0 && TextBox2.Text.Length > 0)
{
ex.Data["ExtraInfo"] = " You can't divide " +
TextBox1.Text + " by " + TextBox2.Text + ".";
}
throw ex;
}
}
protected void ScriptManager1_AsyncPostBackError(object sender, AsyncPostBackErrorEventArgs e)
{
if (e.Exception.Data["ExtraInfo"] != null)
{
ScriptManager1.AsyncPostBackErrorMessage =
e.Exception.Message +
e.Exception.Data["ExtraInfo"].ToString();
}
else
{
ScriptManager1.AsyncPostBackErrorMessage =
"An unspecified error occurred.";
}
}
</script>
<html xmlns="http://www.w3.org/1999/xhtml">
<head id="Head1" runat="server">
<title>UpdatePanel Error Handling Example</title>
<style type="text/css">
#UpdatePanel1 {
width: 200px; height: 50px;
border: solid 1px gray;
}
#AlertDiv{
left: 40%; top: 40%;
position: absolute; width: 200px;
padding: 12px;
border: #000000 1px solid;
background-color: white;
text-align: left;
visibility: hidden;
z-index: 99;
}
#AlertButtons{
position: absolute; right: 5%; bottom: 5%;
}
</style>
</head>
<body id="bodytag">
<form id="form1" runat="server">
<div>
<asp:ScriptManager ID="ScriptManager1"
OnAsyncPostBackError="ScriptManager1_AsyncPostBackError" runat="server" >
<Scripts>
<asp:ScriptReference Path="ErrorHandling.js" />
</Scripts>
</asp:ScriptManager>
<asp:UpdatePanel ID="UpdatePanel1" runat="server">
<ContentTemplate>
<asp:TextBox ID="TextBox1" runat="server" Width="39px"></asp:TextBox>
/
<asp:TextBox ID="TextBox2" runat="server" Width="39px"></asp:TextBox>
=
<asp:Label ID="Label1" runat="server"></asp:Label><br />
<asp:Button ID="Button1" runat="server" OnClick="Button1_Click" Text="calculate" />
</ContentTemplate>
</asp:UpdatePanel>
<div id="AlertDiv">
<div id="AlertMessage">
</div>
<br />
<div id="AlertButtons">
<input id="OKButton" type="button" value="OK" runat="server" onclick="ClearErrorState()" />
</div>
</div>
</div>
</form>
</body>
</html>
<%@ Page Language="VB" %>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<script runat="server">
Protected Sub Button1_Click(ByVal sender As Object, ByVal e As System.EventArgs)
Try
Dim a As Int32
a = Int32.Parse(TextBox1.Text)
Dim b As Int32
b = Int32.Parse(TextBox2.Text)
Dim res As Int32 = a / b
Label1.Text = res.ToString()
Catch ex As Exception
If (TextBox1.Text.Length > 0 AndAlso TextBox2.Text.Length > 0) Then
ex.Data("ExtraInfo") = " You can't divide " & _
TextBox1.Text & " by " & TextBox2.Text & "."
End If
Throw ex
End Try
End Sub
Protected Sub ScriptManager1_AsyncPostBackError(ByVal sender As Object, ByVal e As System.Web.UI.AsyncPostBackErrorEventArgs)
If (e.Exception.Data("ExtraInfo") <> Nothing) Then
ScriptManager1.AsyncPostBackErrorMessage = _
e.Exception.Message & _
e.Exception.Data("ExtraInfo").ToString()
Else
ScriptManager1.AsyncPostBackErrorMessage = _
"An unspecified error occurred."
End If
End Sub
</script>
<html xmlns="http://www.w3.org/1999/xhtml">
<head id="Head1" runat="server">
<title>UpdatePanel Error Handling Example</title>
<style type="text/css">
#UpdatePanel1 {
width: 200px; height: 50px;
border: solid 1px gray;
}
#AlertDiv{
left: 40%; top: 40%;
position: absolute; width: 200px;
padding: 12px;
border: #000000 1px solid;
background-color: white;
text-align: left;
visibility: hidden;
z-index: 99;
}
#AlertButtons{
position: absolute; right: 5%; bottom: 5%;
}
</style>
</head>
<body id="bodytag">
<form id="form1" runat="server">
<div>
<asp:ScriptManager ID="ScriptManager1"
OnAsyncPostBackError="ScriptManager1_AsyncPostBackError" runat="server" >
<Scripts>
<asp:ScriptReference Path="ErrorHandling.js" />
</Scripts>
</asp:ScriptManager>
<asp:UpdatePanel ID="UpdatePanel1" runat="server">
<ContentTemplate>
<asp:TextBox ID="TextBox1" runat="server" Width="39px"></asp:TextBox>
/
<asp:TextBox ID="TextBox2" runat="server" Width="39px"></asp:TextBox>
=
<asp:Label ID="Label1" runat="server"></asp:Label><br />
<asp:Button ID="Button1" runat="server" OnClick="Button1_Click" Text="calculate" />
</ContentTemplate>
</asp:UpdatePanel>
<div id="AlertDiv">
<div id="AlertMessage">
</div>
<br />
<div id="AlertButtons">
<input id="OKButton" type="button" value="OK" runat="server" onclick="ClearErrorState()" />
</div>
</div>
</div>
</form>
</body>
</html>
全球化浏览器中显示的日期和时间
以下示例演示如何设置 属性， EnableScriptGlobalization 以便客户端脚本可以在浏览器中显示特定于区域性的日期和时间。 在此示例中，Culture@ Page 指令的 属性设置为 auto。 因此，在当前浏览器设置中指定的第一种语言决定了页面的区域性和 UI 区域性。 有关详细信息，请参阅 如何：为 ASP.NET 网页全球化设置区域性和 UI 区域性。
<%@ Page Language="C#" Culture="auto" %>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.1//EN" "http://www.w3.org/TR/xhtml11/DTD/xhtml11.dtd">
<html xmlns="http://www.w3.org/1999/xhtml">
<head id="Head1" runat="server">
<title>Globalization Example</title>
</head>
<body>
<form id="form1" runat="server">
<asp:ScriptManager ID="ScriptManager1" EnableScriptGlobalization="true" runat="server">
</asp:ScriptManager>
<script type="text/javascript">
function pageLoad() {
Sys.UI.DomEvent.addHandler($get("Button1"), "click", formatDate);
}
function formatDate() {
var d = new Date();
try {
$get('Label1').innerHTML = d.localeFormat("dddd, dd MMMM yyyy HH:mm:ss");
}
catch(e) {
alert("Error:" + e.message);
}
}
</script>
<asp:UpdatePanel ID="UpdatePanel1" runat="server" ChildrenAsTriggers="False" UpdateMode="Conditional">
<ContentTemplate>
<asp:Panel ID="Panel1" runat="server" GroupingText="Update Panel">
<asp:Button ID="Button1" runat="server" Text="Display Date" />
<br />
<asp:Label ID="Label1" runat="server"></asp:Label>
</asp:Panel>
</ContentTemplate>
</asp:UpdatePanel>
</form>
</body>
</html>
<%@ Page Language="VB" Culture="auto" %>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.1//EN" "http://www.w3.org/TR/xhtml11/DTD/xhtml11.dtd">
<html xmlns="http://www.w3.org/1999/xhtml">
<head id="Head1" runat="server">
<title>Globalization Example</title>
</head>
<body>
<form id="form1" runat="server">
<asp:ScriptManager ID="ScriptManager1" EnableScriptGlobalization="true" runat="server">
</asp:ScriptManager>
<script type="text/javascript">
function pageLoad() {
Sys.UI.DomEvent.addHandler($get("Button1"), "click", formatDate);
}
function formatDate() {
var d = new Date();
try {
$get('Label1').innerHTML = d.localeFormat("dddd, dd MMMM yyyy HH:mm:ss");
}
catch(e) {
alert("Error:" + e.message);
}
}
</script>
<asp:UpdatePanel ID="UpdatePanel1" runat="server" ChildrenAsTriggers="False" UpdateMode="Conditional">
<ContentTemplate>
<asp:Panel ID="Panel1" runat="server" GroupingText="Update Panel">
<asp:Button ID="Button1" runat="server" Text="Display Date" />
<br />
<asp:Label ID="Label1" runat="server"></asp:Label>
</asp:Panel>
</ContentTemplate>
</asp:UpdatePanel>
</form>
</body>
</html>
注解
本主题内容：
介绍
控件 ScriptManager 是 ASP.NET 中 Ajax 功能的核心。 控件管理页面上的所有 ASP.NET Ajax 资源。 这包括将 Microsoft Ajax 库脚本下载到浏览器，以及协调使用 UpdatePanel 控件启用的部分页面更新。 此外， ScriptManager 控件使你能够执行以下操作：
注册与部分页面更新兼容的脚本。 为了管理脚本与核心库之间的依赖关系，注册的任何脚本都加载在 Microsoft Ajax 库脚本之后。
指定是将发布脚本还是调试脚本发送到浏览器。
通过将 Web 服务注册到 控件，从脚本提供对 Web 服务 ScriptManager 方法的访问。
通过向 控件注册这些服务，从客户端脚本提供对 ASP.NET 身份验证、角色和配置文件应用程序服务 ScriptManager 的访问权限。
在浏览器中启用 ECMAScript (JavaScript) Date、 Number 和 String 函数的区域性显示。
使用 ResourceUICultures 控件的 ScriptReference 属性访问嵌入式脚本文件或独立脚本文件的本地化资源。
将实现 IExtenderControl 或 IScriptControl 接口的服务器控件注册到 控件 ScriptManager ，以便呈现客户端组件和行为所需的脚本。
Partial-Page渲染
ASP.NET 页支持部分页面呈现的能力受以下因素控制：
控件 ScriptManager 的 EnablePartialRendering 属性必须
true(默认值) 。页面上必须至少有一个 UpdatePanel 控件。
属性 SupportsPartialRendering 必须
true(默认值) 。 SupportsPartialRendering如果未显式设置属性，则其值基于浏览器功能。
可以在页面Init事件期间或之前在运行时重写 属性的值EnablePartialRendering。 如果尝试在页面 Init 的 事件发生后更改此属性， InvalidOperationException 则会引发异常。
如果支持部分页面呈现，控件将 ScriptManager 呈现脚本以启用异步回发和部分页面更新。 要更新的页面区域是使用 UpdatePanel 控件指定的。 控件 ScriptManager 处理异步回发，并仅刷新必须更新的页面区域。 有关部分页面呈现的详细信息，请参阅 分页呈现概述。 有关导致更新的条件的详细信息，请参阅 UpdatePanel 控件概述。
将 ScriptManager 控件与母版页、用户控件和其他子组件配合使用
一个页面在其层次结构中只能包含一个 ScriptManager 控件。 若要在父页已有 ScriptManager 控件时为嵌套页、用户控件或组件注册服务和脚本，请使用 ScriptManagerProxy 控件。 有关详细信息，请参阅 在母版页中使用 UpdatePanel 控件。
脚本管理和注册
控件 ScriptManager 使你能够注册随后呈现为页面的一部分的脚本。 控件 ScriptManager 注册方法可分为以下三类：
保证保留 Microsoft Ajax 库上的脚本依赖项的注册方法。
不依赖于 Microsoft Ajax 库但与 UpdatePanel 控件兼容的注册方法。
支持使用控件的 UpdatePanel 注册方法。
有关如何在 ASP.NET 中创建和使用 Ajax 脚本的详细信息，请参阅 使用 Microsoft Ajax 库创建自定义客户端脚本。
注册依赖于 Microsoft Ajax 库的脚本
可以使用以下方法来注册脚本文件，确保保留 Microsoft Ajax 库上的任何依赖项。
| 方法 | 定义 |
|---|---|
| RegisterScriptControl | 注册一个服务器控件，该控件实现 IScriptControl 用于定义 Sys.Component 客户端对象的接口。 控件 ScriptManager 呈现支持客户端对象的脚本。 |
| RegisterExtenderControl | 注册一个服务器控件，该控件实现 IExtenderControl 用于定义 Sys.Component 客户端对象的接口。 控件 ScriptManager 呈现支持客户端对象的脚本。 |
注册Partial-Page更新兼容脚本
可以使用以下方法注册不依赖于 Microsoft Ajax 库但与 UpdatePanel 控件兼容的脚本文件。 这些方法对应于 控件的 ClientScriptManager 类似方法。 如果要呈现脚本以在控件内 UpdatePanel 使用，请确保调用控件 ScriptManager 的方法。
| 方法 | 定义 |
|---|---|
| RegisterArrayDeclaration | 将值添加到 JavaScript 数组。 如果该数组不存在，则创建它。 |
| RegisterClientScriptBlock | 在 script 页面的开始 <form> 标记后呈现元素。 脚本指定为字符串参数。 |
| RegisterClientScriptInclude | 在 script 页面的开始 <form> 标记后呈现元素。 通过将 属性设置为 src 指向脚本文件的 URL 来指定脚本内容。 |
| RegisterClientScriptResource | 在 script 页面的开始 <form> 标记后呈现元素。 脚本内容是使用程序集中的资源名称指定的。 通过 src 调用从程序集中检索命名脚本的 HTTP 处理程序，使用 URL 自动填充属性。 |
| RegisterExpandoAttribute | 在指定控件的标记中呈现 (expando) 的自定义名称/值属性对。 |
| RegisterHiddenField | 呈现隐藏的字段。 |
| RegisterOnSubmitStatement | 注册为响应 form 元素 submit 的事件而执行的脚本。 属性 onSubmit 引用指定的脚本。 |
| RegisterStartupScript | 在页面的结束 </form> 标记之前呈现启动脚本块。 要呈现的脚本指定为字符串参数。 |
注册方法时，为该脚本指定类型/密钥对。 如果已注册具有相同类型/密钥对的脚本，则不会注册新脚本。 同样，如果使用已存在的类型/资源名称对注册脚本， script 则不会再次添加引用该资源的元素。 注册以前注册的属性的 expando 属性时，将引发异常。 允许重复注册数组值。
调用 RegisterClientScriptInclude 或 RegisterClientScriptResource 方法时，请避免注册执行内联函数的脚本。 请改为注册包含函数定义的脚本，例如应用程序的事件处理程序或自定义类定义。
UpdatePanel 控件的注册方法
使用控件时 UpdatePanel ，可以使用以下方法自定义分页更新。
| 方法 | 定义 |
|---|---|
| RegisterAsyncPostBackControl | 将控件注册为异步回发的触发器。 |
| RegisterDataItem | 在局部页面呈现期间将自定义数据发送到多个控件。 |
| RegisterDispose | 为控件内的 UpdatePanel 控件注册释放脚本。 在更新或删除 UpdatePanel 控件时会执行脚本。 释放方法用于属于 Microsoft Ajax 库的客户端组件，并且当组件不再使用时必须释放资源。 |
| RegisterPostBackControl | 将控件注册为完整回发的触发器。 此方法用于控件中的 UpdatePanel 控件，否则这些控件将执行异步回发。 |
Web 服务引用
可以通过创建 ServiceReference 对象并将其添加到控件的集合来 Services 注册要从客户端脚本调用的 ScriptManager Web 服务。 ASP.NET 为 ServiceReference 集合中的每个 Services 对象生成一个客户端代理对象。 可以编程方式将 对象添加到 ServiceReference 集合， Services 以在运行时注册 Web 服务。
有关如何在脚本中访问 Web 服务的详细信息，请参阅在 ASP.NET AJAX 中向客户端脚本公开 Web 服务和从 ASP.NET AJAX 中的客户端脚本调用 Web 服务。
本地化
控件 ScriptManager 在呈现页中生成指向相应本地化脚本文件的引用，这些文件是嵌入在程序集中的脚本文件或独立脚本文件。
EnableScriptLocalization当 属性设置为 true时，控件ScriptManager检索本地化资源 (，例如当前区域性) 本地化字符串（如果存在）。 控件 ScriptManager 提供以下用于使用本地化资源的功能：
嵌入程序集中的脚本文件。 控件 ScriptManager 确定要发送到浏览器的区域性特定或回退区域性脚本文件。 它通过使用区域性特定的 NeutralResourcesLanguageAttribute 程序集属性、随程序集一起打包的资源以及浏览器的 UI 区域性 (（如果有任何) ）来执行此操作。
独立脚本文件。 控件 ScriptManager 使用 ResourceUICultures 对象的 属性 ScriptReference 定义支持的 UI 区域性列表。
在调试模式下。 控件 ScriptManager 尝试呈现包含调试信息的特定于区域性的脚本文件。 例如，如果页面处于调试模式，并且当前区域性设置为 en-MX，则控件将呈现一个名称为 .en-MX.debug.js 的
scriptname脚本文件（如果该文件存在）。 如果文件不存在，则会呈现相应回退区域性的调试文件
有关如何本地化资源的详细信息，请参阅 本地化组件库的资源概述。
错误处理
在异步回发期间发生页面错误时 AsyncPostBackError ，将引发 事件。 服务器上错误发送到客户端的方式取决于 AllowCustomErrorsRedirect Web.config 文件的 属性、 AsyncPostBackErrorMessage 属性和自定义错误部分。 有关详细信息，请参阅 自定义 UpdatePanel 控件的错误处理。
声明性语法
<asp:ScriptManager
AllowCustomErrorsRedirect="True|False"
AsyncPostBackErrorMessage="string"
AsyncPostBackTimeout="integer"
AuthenticationService-Path="uri"
EnablePageMethods="True|False"
EnablePartialRendering="True|False"
EnableScriptGlobalization="True|False"
EnableScriptLocalization="True|False"
EnableTheming="True|False"
EnableViewState="True|False"
ID="string"
LoadScriptsBeforeUI="True|False"
OnAsyncPostBackError="AsyncPostBackError event handler"
OnDataBinding="DataBinding event handler"
OnDisposed="Disposed event handler"
OnInit="Init event handler"
OnLoad="Load event handler"
OnPreRender="PreRender event handler"
OnResolveScriptReference="ResolveScriptReference event handler"
OnUnload="Unload event handler"
ProfileService-LoadProperties="string"
ProfileService-Path="uri"
RoleService-LoadRoles="True|False"
RoleService-Path="uri"
runat="server"
ScriptMode="Auto|Inherit|Debug|Release"
ScriptPath="string"
SkinID="string"
SupportsPartialRendering="True|False"
Visible="True|False"
>
<AuthenticationService
Path="uri"
/>
<ProfileService
LoadProperties="string"
Path="uri"
/>
<RoleService
LoadRoles="True|False"
Path="uri"
/>
<Scripts>
<asp:ScriptReference
Assembly="string"
IgnoreScriptPath="True|False"
Name="string"
NotifyScriptLoaded="True|False"
Path="string"
ResourceUICultures="string"
ScriptMode="Auto|Debug|Inherit|Release"
/>
</Scripts>
<Services>
<asp:ServiceReference
InlineScript="True|False"
Path="string"
/>
</Services>
</asp:ScriptManager>
构造函数
| ScriptManager() |
初始化 ScriptManager 类的新实例。 |
属性
| Adapter |
获取控件的浏览器特定适配器。 (继承自 Control) |
| AjaxFrameworkAssembly |
获取页上组件所使用的 Ajax framework 程序集。 |
| AjaxFrameworkMode |
获取或设置一个值，该值指定将如何将 Microsoft Ajax 客户端库的客户端脚本包括到客户端上。 |
| AllowCustomErrorsRedirect |
获取或设置一个值，该值确定异步回发出现错误时是否使用 Web.config 文件的自定义错误部分。 |
| AppRelativeTemplateSourceDirectory |
获取或设置包含该控件的 Page 或 UserControl 对象的应用程序相对虚拟目录。 (继承自 Control) |
| AsyncPostBackErrorMessage |
获取或设置异步回发期间发生未处理的服务器异常时发送到客户端的错误消息。 |
| AsyncPostBackSourceElementID |
获取引发异步回发的控件的唯一 ID。 |
| AsyncPostBackTimeout |
获取或设置一个值，该值指示在未收到响应时异步回发超时前的时间（以秒为单位）。 |
| AuthenticationService |
获取与当前 ScriptManager 实例关联的 AuthenticationServiceManager 对象。 |
| BindingContainer |
获取包含该控件的数据绑定的控件。 (继承自 Control) |
| ChildControlsCreated |
获取一个值，该值指示是否已创建服务器控件的子控件。 (继承自 Control) |
| ClientID |
获取由 ASP.NET 生成的 HTML 标记的控件 ID。 (继承自 Control) |
| ClientIDMode |
获取或设置用于生成 ClientID 属性值的算法。 (继承自 Control) |
| ClientIDSeparator |
获取一个字符值，该值表示 ClientID 属性中使用的分隔符字符。 (继承自 Control) |
| ClientNavigateHandler |
获取或设置在客户端上处理 Sys.Application.navigate 事件的方法的名称。 |
| CompositeScript |
获取对支持网页的复合脚本的引用。 |
| Context |
为当前 Web 请求获取与服务器控件关联的 HttpContext 对象。 (继承自 Control) |
| Controls |
获取 ControlCollection 对象，该对象表示 UI 层次结构中的指定服务器控件的子控件。 (继承自 Control) |
| DataItemContainer |
如果命名容器实现 IDataItemContainer，则获取对命名容器的引用。 (继承自 Control) |
| DataKeysContainer |
如果命名容器实现 IDataKeysControl，则获取对命名容器的引用。 (继承自 Control) |
| DesignMode |
获取一个值，该值指示是否正在使用设计图面上的一个控件。 (继承自 Control) |
| EmptyPageUrl |
获取或设置空白网页的 URL。 |
| EnableCdn |
确定当前页是否从 CDN（内容分发网络）路径加载客户端脚本引用。 |
| EnableCdnFallback |
在无法访问 CDN（内容分发网络）的情况下启动脚本本地副本加载。 |
| EnableHistory |
获取或设置一个值，该值指示网页是否支持历史时间点管理。 |
| EnablePageMethods |
获取或设置一个值，该值指示能否从客户端脚本调用 ASP.NET 页中公共静态页方法。 |
| EnablePartialRendering |
获取或设置一个可部分呈现页面的值，该操作转而使你可以使用 UpdatePanel 控件来单独更新页面区域。 |
| EnableScriptGlobalization |
获取或设置一个值，该值指示 ScriptManager 控件是否呈现支持分析和格式化区域性特定的信息的脚本。 |
| EnableScriptLocalization |
获取或设置一个值，该值指示 ScriptManager 控件是否呈现脚本文件的本地化版本。 |
| EnableSecureHistoryState |
获取或设置一个值，该值指示是否加密历史记录状态字符串。 |
| EnableTheming |
获取或设置一个值，该值指示主题是否应用于该控件。 (继承自 Control) |
| EnableViewState |
获取或设置一个值，该值指示服务器控件是否向发出请求的客户端保持自己的视图状态以及它所包含的任何子控件的视图状态。 (继承自 Control) |
| Events |
获取控件的事件处理程序委托列表。 此属性为只读。 (继承自 Control) |
| HasChildViewState |
获取一个值，该值指示当前服务器控件的子控件是否具有任何已保存的视图状态设置。 (继承自 Control) |
| ID |
获取或设置分配给服务器控件的编程标识符。 (继承自 Control) |
| IdSeparator |
获取用于分隔控件标识符的字符。 (继承自 Control) |
| IsChildControlStateCleared |
获取一个值，该值指示该控件中包含的控件是否具有控件状态。 (继承自 Control) |
| IsDebuggingEnabled |
获取一个值，它指示是否将呈现客户端脚本库的调试版本。 |
| IsInAsyncPostBack |
获取一个值，该值指示是否要在部分呈现模式下执行当前回发。 |
| IsNavigating |
获取一个值，该值指示当前是否正在处理 Navigate 事件。 |
| IsTrackingViewState |
获取一个值，用于指示服务器控件是否会将更改保存到其视图状态中。 (继承自 Control) |
| IsViewStateEnabled |
获取一个值，该值指示是否为该控件启用了视图状态。 (继承自 Control) |
| LoadScriptsBeforeUI |
获取或设置一个值，该值指示是在加载页 UI 的标记之前还是在之后加载脚本。 |
| LoadViewStateByID |
获取一个值，该值指示控件是否通过 ID 而不是索引参与加载其视图状态。 (继承自 Control) |
| NamingContainer |
获取对服务器控件的命名容器的引用，此引用创建唯一的命名空间，以区分具有相同 ID 属性值的服务器控件。 (继承自 Control) |
| Page |
获取对包含服务器控件的 Page 实例的引用。 (继承自 Control) |
| Parent |
获取对页 UI 层次结构中服务器控件的父控件的引用。 (继承自 Control) |
| ProfileService |
获取与当前 ScriptManager 实例关联的 ProfileServiceManager 对象。 |
| RenderingCompatibility |
获取一个值，该值指定呈现的 HTML 将与之兼容的 ASP.NET 版本。 (继承自 Control) |
| RoleService |
获取与当前 ScriptManager 实例关联的 RoleServiceManager 对象。 |
| ScriptMode |
获取或设置一个值，该值指定是呈现客户端脚本库的调试版本还是发布版本。 |
| ScriptPath |
已过时.
获取或设置位置的根路径，该位置用来生成指向 ASP.NET Ajax 和自定义脚本文件的路径。 |
| ScriptResourceMapping |
获取一个 ScriptResourceMapping 对象。 |
| Scripts |
获取一个包含 ScriptReference 对象（每个对象表示一个呈现给客户端的脚本文件）的 ScriptReferenceCollection 对象。 |
| Services |
获取一个 ServiceReferenceCollection 对象，该对象包含 ASP.NET 在客户端上针对 Ajax 功能公开的每个 Web 服务的 ServiceReference 对象。 |
| Site |
获取容器信息，该容器在呈现于设计图面上时承载当前控件。 (继承自 Control) |
| SkinID |
获取或设置要应用于控件的外观。 (继承自 Control) |
| SupportsPartialRendering |
获取一个指示客户端是否支持局部页面呈现的值。 |
| TemplateControl |
获取或设置对包含该控件的模板的引用。 (继承自 Control) |
| TemplateSourceDirectory |
获取包含当前服务器控件的 Page 或 UserControl 的虚拟目录。 (继承自 Control) |
| UniqueID |
获取服务器控件的唯一的、以分层形式限定的标识符。 (继承自 Control) |
| ValidateRequestMode |
获取或设置指示控件是否检查来自浏览器的客户端输入是否具有潜在危险值的值。 (继承自 Control) |
| ViewState |
获取状态信息的字典，这些信息使您可以在同一页的多个请求间保存和还原服务器控件的视图状态。 (继承自 Control) |
| ViewStateIgnoresCase |
获取一个值，该值指示 StateBag 对象是否不区分大小写。 (继承自 Control) |
| ViewStateMode |
获取或设置此控件的视图状态模式。 (继承自 Control) |
| Visible |
方法
事件
| AsyncPostBackError |
当异步回发期间出现页面错误时发生。 |
| DataBinding |
当服务器控件绑定到数据源时发生。 (继承自 Control) |
| Disposed |
当从内存释放服务器控件时发生，这是请求 ASP.NET 页时服务器控件生存期的最后阶段。 (继承自 Control) |
| Init |
当服务器控件初始化时发生；初始化是控件生存期的第一步。 (继承自 Control) |
| Load |
当服务器控件加载到 Page 对象中时发生。 (继承自 Control) |
| Navigate |
当用户点击浏览器的“后退”或“前进”按钮时发生。 |
| PreRender |
在加载 Control 对象之后、呈现之前发生。 (继承自 Control) |
| ResolveCompositeScriptReference |
在向 ScriptManager 控件注册复合脚本时发生。 |
| ResolveScriptReference |
在向 ScriptManager 控件注册 Scripts 集合的成员时发生。 |
| Unload |
当服务器控件从内存中卸载时发生。 (继承自 Control) |
显式接口实现
扩展方法
| FindDataSourceControl(Control) |
返回与指定控件的数据控件关联的数据源。 |
| FindFieldTemplate(Control, String) |
返回指定控件的命名容器中指定列的字段模板。 |
| FindMetaTable(Control) |
返回包含数据控件的元表对象。 |
适用于
另请参阅
反馈
即将发布：在整个 2024 年，我们将逐步淘汰作为内容反馈机制的“GitHub 问题”，并将其取代为新的反馈系统。 有关详细信息，请参阅：https://aka.ms/ContentUserFeedback。
提交和查看相关反馈