ScriptManager Класс
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Управляет библиотекой скриптов AJAX для ASP.NET и файлами скриптов, частичной отрисовкой страниц и созданием прокси-класса клиента для веб-служб и служб приложений.
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. В результате первый язык, указанный в текущих параметрах браузера, определяет язык и региональные параметры и региональные параметры пользовательского интерфейса для страницы. Дополнительные сведения см. в разделе Практическое руководство. Настройка языка и региональных параметров и региональных параметров пользовательского интерфейса для ASP.NET глобализации веб-страниц.
<%@ 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 управления занимает центральное место в функциональных возможностях Ajax в ASP.NET. Элемент управления управляет всеми ASP.NET ресурсами Ajax на странице. Сюда входит скачивание скриптов библиотеки Microsoft Ajax в браузере и координация частичных обновлений страниц, которые включены с помощью UpdatePanel элементов управления. Кроме того, ScriptManager элемент управления позволяет выполнять следующие действия:
Зарегистрируйте скрипт, совместимый с частичными обновлениями страниц. Чтобы управлять зависимостями между скриптом и основной библиотекой, все зарегистрированные скрипты загружаются после скрипта библиотеки Microsoft Ajax.
Укажите, отправляются ли скрипты выпуска или отладки в браузер.
Предоставьте доступ к методам веб-службы из скрипта, зарегистрировав веб-службы в элементе ScriptManager управления .
Предоставьте доступ к ASP.NET проверка подлинности, роли и профилирование служб приложений из клиентского скрипта, зарегистрировав эти службы в элементе ScriptManager управления .
Включите отображение функций даты, числа и строки ECMAScript (JavaScript) в браузере с учетом языка и региональных параметров.
Доступ к ресурсам локализации для внедренных файлов скриптов или автономных файлов скриптов с помощью ResourceUICultures свойства ScriptReference элемента управления .
Зарегистрируйте серверные элементы управления, которые реализуют IExtenderControl интерфейсы или IScriptControl с элементом ScriptManager управления , чтобы скрипт, необходимый для клиентских компонентов и поведения, отображался.
Отрисовка Partial-Page
Возможность ASP.NET страницы для поддержки частичной отрисовки страниц контролируется следующими факторами:
Свойство ScriptManager элемента управления EnablePartialRendering должно иметь значение
true(значение по умолчанию).На странице должен быть хотя бы один UpdatePanel элемент управления.
Свойство SupportsPartialRendering должно иметь значение
true(значение по умолчанию). SupportsPartialRendering Если свойство не задано явным образом, его значение зависит от возможностей браузера.
Значение EnablePartialRendering свойства можно переопределить во время выполнения во время или до события страницы Init . При попытке изменить это свойство после события InvalidOperationException страницы Init возникает исключение.
При поддержке ScriptManager частичной отрисовки страниц элемент управления отрисовывает скрипт для включения асинхронной обратной передачи и частичного обновления страницы. Области обновляемой страницы определяются с помощью UpdatePanel элементов управления. Элемент ScriptManager управления обрабатывает асинхронные обратные передачи и обновляет только области страницы, которые необходимо обновить. Дополнительные сведения о частичной отрисовке страниц см. в разделе Общие сведения о частичной отрисовке страниц. Дополнительные сведения об условиях, вызывающих обновление, см. в разделе Общие сведения об элементе управления UpdatePanel.
Использование элемента управления ScriptManager с главными страницами, пользовательскими элементами управления и другими дочерними компонентами
Страница может содержать только один ScriptManager элемент управления в своей иерархии. Чтобы зарегистрировать службы и скрипты для вложенных страниц, пользовательских элементов управления или компонентов, если на родительской ScriptManager странице уже есть элемент управления, используйте ScriptManagerProxy элемент управления . Дополнительные сведения см. в статье Использование элемента управления UpdatePanel с главными страницами.
Управление скриптами и регистрация
Элемент ScriptManager управления позволяет регистрировать скрипт, который затем отображается как часть страницы. Методы ScriptManager регистрации элементов управления можно разбить на следующие три категории:
Методы регистрации, гарантирующие сохранение зависимостей скриптов от библиотеки Microsoft Ajax.
Методы регистрации, которые не зависят от библиотеки Microsoft Ajax, но совместимы с UpdatePanel элементами управления.
Методы регистрации, поддерживающие работу с UpdatePanel элементами управления.
Дополнительные сведения о создании и использовании скрипта Ajax в ASP.NET см. в статье Создание пользовательского клиентского скрипта с помощью библиотеки Microsoft Ajax.
Регистрация скрипта, зависят от библиотеки Microsoft Ajax
Вы можете использовать следующие методы для регистрации файлов скриптов таким образом, чтобы гарантировать, что все зависимости от библиотеки Microsoft Ajax будут сохранены.
| Метод | Определение |
|---|---|
| RegisterScriptControl | Регистрирует серверный элемент управления, реализующий IScriptControl интерфейс, используемый для определения клиентского объекта Sys.Component . Элемент ScriptManager управления отрисовывает скрипт, поддерживающий объект клиента. |
| RegisterExtenderControl | Регистрирует серверный элемент управления, реализующий IExtenderControl интерфейс, используемый для определения клиентского объекта Sys.Component . Элемент ScriptManager управления отрисовывает скрипт, поддерживающий объект клиента. |
Регистрация скриптов, совместимых с Partial-Page update
Вы можете использовать следующие методы для регистрации файлов скриптов, которые не зависят от библиотеки Microsoft Ajax, но совместимы с UpdatePanel элементами управления. Эти методы соответствуют аналогичным методам ClientScriptManager элемента управления . При отрисовке скрипта для использования в элементе UpdatePanel управления убедитесь, что вы вызываете методы ScriptManager элемента управления .
| Метод | Определение |
|---|---|
| RegisterArrayDeclaration | Добавляет значение в массив JavaScript. Если массив не существует, он создается. |
| RegisterClientScriptBlock | script Отображает элемент после открываемого <form> тега страницы. Скрипт указывается в виде строкового параметра. |
| RegisterClientScriptInclude | script Отображает элемент после открываемого <form> тега страницы. Содержимое скрипта указывается путем задания атрибуту src URL-адреса, указывающего на файл скрипта. |
| RegisterClientScriptResource | script Отображает элемент после открываемого <form> тега страницы. Содержимое скрипта указывается с именем ресурса в сборке. Атрибут src автоматически заполняется URL-адресом путем вызова обработчика HTTP, который извлекает именованный скрипт из сборки. |
| RegisterExpandoAttribute | Отображает настраиваемую пару атрибутов имя-значение (expando) в разметке для указанного элемента управления. |
| RegisterHiddenField | Отображает скрытое поле. |
| RegisterOnSubmitStatement | Регистрирует скрипт, который выполняется в ответ на form событие элемента submit . Атрибут onSubmit ссылается на указанный скрипт. |
| RegisterStartupScript | Отображает блок скрипта запуска непосредственно перед закрывающим </form> тегом страницы. Скрипт для отрисовки указывается в виде строкового параметра. |
При регистрации методов указывается пара "тип-ключ" для этого скрипта. Если сценарий с той же парой "тип-ключ" уже зарегистрирован, новый скрипт не регистрируется. Аналогичным образом, если вы регистрируете скрипт с уже существующей парой "тип-имя ресурса", элемент, script ссылающийся на ресурс, больше не добавляется. При регистрации атрибута expando ранее зарегистрированного атрибута создается исключение. Допускается повторная регистрация значений массива.
При вызове RegisterClientScriptInclude метода или RegisterClientScriptResource не регистрируйте скрипт, который выполняет встроенные функции. Вместо этого зарегистрируйте скрипт, содержащий определения функций, такие как обработчики событий или определения пользовательских классов для вашего приложения.
Методы регистрации для элементов управления UpdatePanel
Для настройки частичных обновлений страниц при использовании UpdatePanel элементов управления можно использовать следующие методы.
| Метод | Определение |
|---|---|
| RegisterAsyncPostBackControl | Регистрирует элемент управления в качестве триггера асинхронных обратных передач. |
| RegisterDataItem | Посылает пользовательские данные элементу управления во время частичной отрисовки страницы. |
| RegisterDispose | Регистрирует скрипт удаления для элемента управления, который находится внутри UpdatePanel элемента управления. Скрипт выполняется, когда элемент управления UpdatePanel изменяется или удаляется. Метод dispose используется для клиентских компонентов, которые являются частью библиотеки Microsoft Ajax и которые должны освобождать ресурсы, когда компонент больше не используется. |
| RegisterPostBackControl | Регистрирует элемент управления в качестве триггера для полной обратной передачи. Этот метод используется для элементов управления внутри UpdatePanel элемента управления, которые в противном случае выполняли бы асинхронную обратную передачу. |
Ссылки на веб-службы
Вы можете зарегистрировать веб-службу для вызова из клиентского ScriptManager скрипта, создав ServiceReference объект и добавив его в Services коллекцию элемента управления . ASP.NET создает прокси-объект клиента для каждого ServiceReference объекта в Services коллекции. Вы можете программно добавить ServiceReference объекты в коллекцию Services для регистрации веб-служб во время выполнения.
Дополнительные сведения о доступе к веб-службам в скрипте см. в разделах Предоставление веб-служб клиентскому скрипту в ASP.NET AJAX и Вызов веб-служб из клиентского скрипта в ASP.NET AJAX.
Локализация
Элемент ScriptManager управления создает ссылки на отображаемой странице, которые указывают на соответствующие локализованные файлы скриптов, которые являются либо файлами скриптов, внедренными в сборки, либо автономными файлами скриптов.
Если свойству EnableScriptLocalization присвоено значение true, ScriptManager элемент управления извлекает локализованные ресурсы (например, локализованные строки) для текущего языка и региональных параметров, если они существуют. Элемент ScriptManager управления предоставляет следующие функции для использования локализованных ресурсов:
Файлы скриптов, внедренные в сборку. Элемент ScriptManager управления определяет, какой файл скрипта для конкретного языка и региональных параметров или резервного языка и региональных параметров следует отправить в браузер. Для этого используется атрибут сборки, относящийся к языку NeutralResourcesLanguageAttribute и региональным параметрам, ресурсы, упакованные в сборку, и язык и региональные параметры пользовательского интерфейса браузера (если таковые есть).
Автономные файлы скриптов. ScriptManager Управления определяет список языков и региональных параметров пользовательского интерфейса, которые поддерживаются с помощью ResourceUICultures свойство ScriptReference объекта.
В режиме отладки. Элемент ScriptManager управления пытается отобразить файл скрипта для конкретного языка и региональных параметров, содержащий отладочную информацию. Например, если страница находится в режиме отладки и для текущего языка и региональных параметров задано значение en-MX, элемент управления отображает файл скрипта с таким именем, как
scriptnameen-MX.debug.js, если файл существует. Если файл не существует, отладочный файл для соответствующего резервного языка и региональных параметров отображается.
Дополнительные сведения о локализации ресурсов см. в статье Localizing Resources for Component Libraries Overview.
Обработка ошибок
При возникновении ошибки страницы во время асинхронной обратной передачи AsyncPostBackError возникает событие . Способ отправки ошибок на сервере клиенту зависит AllowCustomErrorsRedirect от свойства, AsyncPostBackErrorMessage свойства и раздела пользовательских ошибок файла Web.config. Обратной передачи из элемента управления, который является триггером для элемента управления.
Декларативный синтаксис
<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, компоненты которой используются на странице. |
| AjaxFrameworkMode |
Возвращает или задает значение, определяющее способ включения в клиент клиентских скриптов клиентской библиотеки Microsoft Ajax. |
| AllowCustomErrorsRedirect |
Возвращает или устанавливает значение, определяющее, используется ли пользовательский раздел ошибок файла Web.config при возникновении ошибки в асинхронной обратной передаче. |
| AppRelativeTemplateSourceDirectory |
Возвращает или задает относительно приложения виртуальный каталог объекта Page или UserControl, который содержит этот элемент управления. (Унаследовано от Control) |
| AsyncPostBackErrorMessage |
Возвращает или устанавливает сообщение об ошибке, посылаемое клиенту, когда во время асинхронной обратной передачи возникает необработанное исключение сервера. |
| AsyncPostBackSourceElementID |
Возвращает уникальный идентификатор элемента управления, вызвавшего асинхронную обратную передачу. |
| AsyncPostBackTimeout |
Возвращает или устанавливает значение, указывающее время, в секундах, перед тайм-аутом асинхронной обратной передачи, если отклик не получен. |
| AuthenticationService |
Возвращает объект AuthenticationServiceManager, связанный с текущим экземпляром ScriptManager. |
| BindingContainer |
Возвращает элемент управления, который содержит привязку данных элемента управления. (Унаследовано от Control) |
| ChildControlsCreated |
Возвращает значение, которое указывает, созданы ли дочерние элементы управления серверного элемента управления. (Унаследовано от Control) |
| ClientID |
Получает идентификатор элемента управления для HTML-разметки, созданной ASP.NET. (Унаследовано от Control) |
| ClientIDMode |
Возвращает или задает алгоритм, используемый для создания значения свойства ClientID. (Унаследовано от Control) |
| ClientIDSeparator |
Возвращает значение символа разделителя, используемого в свойстве ClientID. (Унаследовано от Control) |
| ClientNavigateHandler |
Возвращает или задает имя метода, в котором на стороне клиента обрабатывается событие Sys.Application.navigate. |
| CompositeScript |
Возвращает ссылку на составной скрипт, поддерживающий веб-страницу. |
| Context |
Возвращает объект HttpContext, связанный с серверным элементом управления для текущего веб-запроса. (Унаследовано от Control) |
| Controls |
Возвращает объект ControlCollection, который представляет дочерние элементы управления для указанного элемента управления сервера в иерархии пользовательского интерфейса. (Унаследовано от Control) |
| DataItemContainer |
Возвращает ссылку на контейнер именования, если контейнер именования реализует класс IDataItemContainer. (Унаследовано от Control) |
| DataKeysContainer |
Возвращает ссылку на контейнер именования, если контейнер именования реализует класс IDataKeysControl. (Унаследовано от Control) |
| DesignMode |
Возвращает значение, указывающее, используется ли элемент управления на поверхности разработки. (Унаследовано от Control) |
| EmptyPageUrl |
Возвращает или задает URL-адрес пустой веб-страницы. |
| EnableCdn |
Определяет, загружает ли текущая страница ссылки на клиентские скрипты из путей CDN (Content Delivery Network, сеть доставки содержимого). |
| 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 |
Возвращает или устанавливает значение, определяющее, загружаются ли шрифты до или после загрузки разметки для элементов пользовательского интерфейса страницы. |
| LoadViewStateByID |
Возвращает значение, указывающее, участвует ли элемент управления в загрузке состояния представления ID вместо индекса. (Унаследовано от Control) |
| NamingContainer |
Возвращает ссылку на контейнер именования элемента управления, создающий уникальное пространство имен для различения серверных элементов управления с одинаковыми значениями свойства ID. (Унаследовано от Control) |
| Page |
Возвращает ссылку на экземпляр Page, содержащий серверный элемент управления. (Унаследовано от Control) |
| Parent |
Возвращает ссылку на родительский элемент управления серверного элемента управления в иерархии элементов управления страницы. (Унаследовано от Control) |
| ProfileService |
Возвращает объект ProfileServiceManager, связанный с текущим экземпляром ScriptManager. |
| RenderingCompatibility |
Возвращает значение, которое задает версию ASP.NET, с которой совместим созданный HTML. (Унаследовано от Control) |
| RoleService |
Возвращает объект RoleServiceManager, связанный с текущим экземпляром ScriptManager. |
| ScriptMode |
Возвращает или устанавливает значение, указывающее, какая версия библиотек клиентских скриптов предоставляется: отладочная или версия для выпуска. |
| ScriptPath |
Устаревшие..
Возвращает или задает корневой путь расположения, используемого для построения пути к ASP.NET с функциональностью AJAX и пользовательским файлам скриптов. |
| ScriptResourceMapping |
Возвращает объект ScriptResourceMapping. |
| Scripts |
Возвращает объект ScriptReferenceCollection, содержащий объекты ScriptReference, каждый из которых представляет файл скрипта, предоставленный клиенту. |
| Services |
Возвращает объект ServiceReferenceCollection, содержащий объект ServiceReference для каждой веб-службы, предоставляемой ASP.NET на клиенте для обеспечения функциональности AJAX. |
| Site |
Возвращает сведения о контейнере, который содержит текущий элемент управления при визуализации на поверхности конструктора. (Унаследовано от Control) |
| SkinID |
Возвращает или задает обложку, применяемую к элементу управления. (Унаследовано от Control) |
| SupportsPartialRendering |
Возвращает значение, показывающее, поддерживает ли клиент частичную отрисовку страницы. |
| TemplateControl |
Возвращает или задает ссылку на шаблон, содержащий этот элемент управления. (Унаследовано от Control) |
| TemplateSourceDirectory |
Возвращает виртуальный каталог Page или UserControl, содержащий текущий серверный элемент управления. (Унаследовано от Control) |
| UniqueID |
Возвращает уникальный идентификатор серверного элемента управления в иерархии. (Унаследовано от Control) |
| ValidateRequestMode |
Возвращает или задает значение, указывающее, проверяет ли элемент управления полученный из браузера клиентский ввод на предмет потенциально опасных значений. (Унаследовано от Control) |
| ViewState |
Возвращает словарь сведений о состоянии, позволяющих сохранять и восстанавливать состояние представления серверного элемента управления при нескольких запросах одной и той же страницы. (Унаследовано от Control) |
| ViewStateIgnoresCase |
Возвращает значение, указывающее, является ли объект StateBag нечувствительным к регистру. (Унаследовано от Control) |
| ViewStateMode |
Возвращает или задает режим состояния представления данного элемента управления. (Унаследовано от Control) |
| Visible |
Переопределяет свойство Visible, унаследованное от базового класса Control, чтобы предотвратить установку этого значения. |
Методы
| AddedControl(Control, Int32) |
Вызывается после добавления дочернего элемента управления в коллекцию Controls объекта Control. (Унаследовано от Control) |
| AddHistoryPoint(NameValueCollection, String) |
Создает точку предыдущего состояния и добавляет ее в стек журнала браузера, используя указанную коллекцию данных состояния и название состояния. |
| AddHistoryPoint(String, String) |
Создает точку предыдущего состояния и добавляет ее в стек журнала браузера, используя указанный ключ состояния и его значение. |
| AddHistoryPoint(String, String, String) |
Создает точку предыдущего состояния и добавляет ее в стек журнала браузера, используя указанный ключ состояния, значение состояния и название состояния. |
| AddParsedSubObject(Object) |
Уведомляет серверный элемент управления, что элемент XML или HTML был проанализирован, и добавляет элемент в серверный элемент управления объекта ControlCollection. (Унаследовано от Control) |
| ApplyStyleSheetSkin(Page) |
Применяет свойства стиля, определенные в таблице стилей страницы, к элементу управления. (Унаследовано от Control) |
| BeginRenderTracing(TextWriter, Object) |
Запускает трассировку во время разработки данных отрисовки. (Унаследовано от Control) |
| BuildProfileTree(String, Boolean) |
Собирает сведения о серверном элементе управления и доставляет их свойству Trace, которое отображается при включенной на странице трассировке. (Унаследовано от Control) |
| ClearCachedClientID() |
Задает для кэшированного свойства ClientID значение |
| ClearChildControlState() |
Удаляет сведения о состоянии элемента управления для дочерних элементов управления серверного элемента управления. (Унаследовано от Control) |
| ClearChildState() |
Удаляет сведения о состоянии элемента управления и состоянии представления для всех дочерних элементов серверного элемента управления. (Унаследовано от Control) |
| ClearChildViewState() |
Удаляет сведения о состоянии представления для всех дочерних элементов серверного элемента управления. (Унаследовано от Control) |
| ClearEffectiveClientIDMode() |
Задает для свойства ClientIDMode текущего экземпляра элемента управления и любых его дочерних элементов управления значение Inherit. (Унаследовано от Control) |
| CreateChildControls() |
Вызывается платформой страницы ASP.NET для уведомления серверных элементов управления, использующих составную реализацию, о необходимости создания дочерних элементов управления, содержащихся в них для обратной передачи или отрисовки. (Унаследовано от Control) |
| CreateControlCollection() |
Создает новый объект ControlCollection для хранения дочерних элементов управления (литеральных и серверных) серверного элемента управления. (Унаследовано от Control) |
| DataBind() |
Привязывает источник данных к вызываемому серверному элементу управления и всем его дочерним элементам управления. (Унаследовано от Control) |
| DataBind(Boolean) |
Привязывает источник данных к вызванному серверному элементу управления и всем его дочерними элементами управления с возможностью вызова события DataBinding. (Унаследовано от Control) |
| DataBindChildren() |
Привязывает источник данных к дочерним элементам управления серверного элемента управления. (Унаследовано от Control) |
| Dispose() |
Включает серверный элемент управления для выполнения окончательной чистки до освобождения памяти. (Унаследовано от Control) |
| EndRenderTracing(TextWriter, Object) |
Завершает трассировку во время разработки данных отрисовки. (Унаследовано от Control) |
| EnsureChildControls() |
Определяет наличие у серверного элемента управления дочерних элементов управления. Если дочерних элементов управления нет, они будут созданы. (Унаследовано от Control) |
| EnsureID() |
Создает идентификатор для элементов управления, которые не имеют назначенного идентификатора. (Унаследовано от Control) |
| Equals(Object) |
Определяет, равен ли указанный объект текущему объекту. (Унаследовано от Object) |
| FindControl(String) |
Выполняет поиск серверного элемента управления с заданным параметром |
| FindControl(String, Int32) |
Выполняет поиск в текущем контейнере именования серверного элемента управления с указанным |
| Focus() |
Задает фокус ввода на элемент управления. (Унаследовано от Control) |
| GetCurrent(Page) |
Возвращает экземпляр ScriptManager для конкретного объекта Page. |
| GetDesignModeState() |
Возвращает данные времени разработки для элемента управления. (Унаследовано от Control) |
| GetHashCode() |
Служит хэш-функцией по умолчанию. (Унаследовано от Object) |
| GetRegisteredArrayDeclarations() |
Возвращает коллекцию только для чтения объявлений массива ECMAScript (JavaScript), которые были ранее зарегистрированы с объектом Page. |
| GetRegisteredClientScriptBlocks() |
Возвращает коллекцию только для чтения блоков клиентского скрипта, которые были прежде зарегистрированы с помощью элемента управления ScriptManager. |
| GetRegisteredDisposeScripts() |
Возвращает коллекцию только для чтения скриптов |
| GetRegisteredExpandoAttributes() |
Возвращает коллекцию только для чтения пользовательских (expando) атрибутов, которые были прежде зарегистрированы с объектом Page. |
| GetRegisteredHiddenFields() |
Возвращает коллекцию только для чтения скрытых полей, которые были прежде зарегистрированы с объектом Page. |
| GetRegisteredOnSubmitStatements() |
Возвращает коллекцию только для чтения операторов |
| GetRegisteredStartupScripts() |
Возвращает коллекцию только для чтения стартовых скриптов, которые были прежде зарегистрированы с объектом Page. |
| GetRouteUrl(Object) |
Возвращает URL-адрес, соответствующий набору параметров маршрута. (Унаследовано от Control) |
| GetRouteUrl(RouteValueDictionary) |
Возвращает URL-адрес, соответствующий набору параметров маршрута. (Унаследовано от Control) |
| GetRouteUrl(String, Object) |
Возвращает URL-адрес, соответствующий набору параметров маршрута и имени маршрута. (Унаследовано от Control) |
| GetRouteUrl(String, RouteValueDictionary) |
Возвращает URL-адрес, соответствующий набору параметров маршрута и имени маршрута. (Унаследовано от Control) |
| GetStateString() |
Извлекает строку, которая содержит пары "ключ-значение", представляющие состояние веб-страницы. |
| GetType() |
Возвращает объект Type для текущего экземпляра. (Унаследовано от Object) |
| GetUniqueIDRelativeTo(Control) |
Возвращает часть с префиксом свойства UniqueID указанного элемента управления. (Унаследовано от Control) |
| HasControls() |
Определяет наличие у серверного элемента управления дочерних элементов управления. (Унаследовано от Control) |
| HasEvents() |
Возвращает значение, указывающее, регистрируются ли события для элемента управления или каких-либо дочерних элементов управления. (Унаследовано от Control) |
| IsLiteralContent() |
Определяет наличие у серверного элемента управления только текстового содержимого. (Унаследовано от Control) |
| LoadControlState(Object) |
Восстанавливает сведения о состоянии элемента управления предыдущего запроса страницы, сохраненные методом SaveControlState(). (Унаследовано от Control) |
| LoadPostData(String, NameValueCollection) |
Считывает данные формы, отправленные из браузера на сервер, и определяет источник асинхронной обратной передачи. |
| LoadViewState(Object) |
Восстанавливает сведения о состоянии представления из предыдущего запроса страницы, сохраненного методом SaveViewState(). (Унаследовано от Control) |
| MapPathSecure(String) |
Извлекает физический путь, к которому ведет виртуальный путь (абсолютный или относительный). (Унаследовано от Control) |
| MemberwiseClone() |
Создает неполную копию текущего объекта Object. (Унаследовано от Object) |
| OnAsyncPostBackError(AsyncPostBackErrorEventArgs) |
Вызывает событие AsyncPostBackError. |
| OnBubbleEvent(Object, EventArgs) |
Определяет, передается ли событие серверного элемента управления вверх по иерархии серверных элементов управления пользовательского интерфейса страницы. (Унаследовано от Control) |
| OnDataBinding(EventArgs) |
Вызывает событие DataBinding. (Унаследовано от Control) |
| OnInit(EventArgs) |
Инициирует событие Init и гарантирует, что на странице существует только один элемент управления ScriptManager. |
| OnLoad(EventArgs) |
Вызывает событие Load. (Унаследовано от Control) |
| OnPreRender(EventArgs) |
Инициирует событие PreRender и регистрирует файлы скриптов и службы для частичных обновлений страниц. |
| OnResolveCompositeScriptReference(CompositeScriptReferenceEventArgs) |
Вызывает событие ResolveCompositeScriptReference. |
| OnResolveScriptReference(ScriptReferenceEventArgs) |
Инициирует событие ResolveScriptReference для каждой ссылки на скрипт, управляемый элементом управления ScriptManager. |
| OnUnload(EventArgs) |
Вызывает событие Unload. (Унаследовано от Control) |
| OpenFile(String) |
Возвращает Stream, используемое для чтения файла. (Унаследовано от Control) |
| RaiseBubbleEvent(Object, EventArgs) |
Присваивает родительскому элементу управления все источники события и сведения о них. (Унаследовано от Control) |
| RaisePostBackEvent(String) |
Обрабатывает событие обратной передачи, порожденное элементом управления ScriptManager, и загружает предыдущее состояние веб-страницы. |
| RaisePostDataChangedEvent() |
Вызывает событие для элемента управления ScriptManager, когда он выполняет обратную передачу на сервер. |
| RegisterArrayDeclaration(Control, String, String) |
Регистрирует объявление массива ECMAScript (JavaScript) с помощью элемента управления ScriptManager для использования с элементом управления, находящимся внутри элемента управления UpdatePanel, и добавляет массив к странице. |
| RegisterArrayDeclaration(Page, String, String) |
Регистрирует объявление массива ECMAScript (JavaScript) с помощью элемента управления ScriptManager для использования с элементом управления, находящимся внутри элемента управления UpdatePanel, и добавляет массив к странице. |
| RegisterAsyncPostBackControl(Control) |
Регистрирует элемент управления в качестве триггера асинхронных обратных передач. |
| RegisterClientScriptBlock(Control, Type, String, String, Boolean) |
Регистрирует блок клиентского скрипта с помощью элемента управления ScriptManager для использования с элементом управления, находящимся внутри элемента управления UpdatePanel, и добавляет блок скрипта к странице. |
| RegisterClientScriptBlock(Page, Type, String, String, Boolean) |
Регистрирует блок клиентского скрипта с помощью элемента управления ScriptManager для использования с элементом управления, находящимся внутри элемента управления UpdatePanel, и добавляет блок скрипта к странице. |
| RegisterClientScriptInclude(Control, Type, String, String) |
Регистрирует файл клиентского скрипта с помощью элемента управления ScriptManager для использования с элементом управления, находящимся внутри элемента управления UpdatePanel, и затем добавляет ссылку на файл скрипта к странице. |
| RegisterClientScriptInclude(Page, Type, String, String) |
Регистрирует клиентский скрипт с помощью элемента управления ScriptManager при каждой асинхронной обратной передаче, и затем добавляет ссылку на файл скрипта к странице. |
| RegisterClientScriptResource(Control, Type, String) |
Регистрирует встроенный в сборку клиентский скрипт с помощью элемента управления ScriptManager для использования с элементом управления, участвующем в частичной отрисовке страницы. |
| RegisterClientScriptResource(Page, Type, String) |
Регистрирует встроенный в сборку клиентский скрипт с помощью элемента управления ScriptManager при каждой асинхронной обратной передаче. |
| RegisterDataItem(Control, String) |
Посылает пользовательские данные элементу управления во время частичной отрисовки страницы. |
| RegisterDataItem(Control, String, Boolean) |
Посылает пользовательские данные элементу управления во время частичной отрисовки страницы и указывает, имеют ли данные формат JavaScript Object Notation (JSON). |
| RegisterDispose(Control, String) |
Регистрирует скрипт |
| RegisterExpandoAttribute(Control, String, String, String, Boolean) |
Регистрирует пару "имя-значение" с помощью элемента управления ScriptManager как пользовательский (expando) атрибут указанного элемента управления. |
| RegisterExtenderControl<TExtenderControl>(TExtenderControl, Control) |
Регистрирует элемент управления-расширитель с помощью текущего экземпляра ScriptManager. |
| RegisterHiddenField(Control, String, String) |
Регистрирует скрытое поле с помощью элемента управления ScriptManager для элемента управления, находящегося внутри элемента управления UpdatePanel. |
| RegisterHiddenField(Page, String, String) |
Регистрирует скрытое поле с помощью элемента управления ScriptManager во время каждой асинхронной обратной передачи. |
| RegisterNamedClientScriptResource(Control, String) |
Регистрирует встроенный в сборку клиентский скрипт по имени ресурса с помощью элемента управления ScriptManager для использования с элементом управления, участвующем в частичной отрисовке страницы. |
| RegisterNamedClientScriptResource(Page, String) |
Регистрирует встроенный в сборку клиентский скрипт по имени ресурса с помощью элемента управления ScriptManager для использования с элементом управления, участвующем в частичной отрисовке страницы. |
| RegisterOnSubmitStatement(Control, Type, String, String) |
Регистрирует код ECMAScript (JavaScript) с помощью элемента управления ScriptManager для элемента управления, используемого элементом управления UpdatePanel, выполняемым при отправке формы. |
| RegisterOnSubmitStatement(Page, Type, String, String) |
Регистрирует код ECMAScript (JavaScript) с помощью элемента управления ScriptManager для элемента управления, используемого элементом управления UpdatePanel, выполняемым при отправке формы. |
| RegisterPostBackControl(Control) |
Регистрирует элемент управления в качестве триггера обратной передачи. Этот метод используется для настройки элементов управления обратной передачи, находящихся внутри элемента управления UpdatePanel, который в противном случае выполняет асинхронные обратные передачи. |
| RegisterScriptControl<TScriptControl>(TScriptControl) |
Регистрирует элемент управления скрипта с помощью текущего экземпляра ScriptManager. |
| RegisterScriptDescriptors(IExtenderControl) |
Осуществляет обратный вызов класса ExtenderControl для возвращения скриптов экземпляра, которые должны использоваться для поддержки клиентского объекта, представляющего клиентский элемент управления, компонент или поведение. |
| RegisterScriptDescriptors(IScriptControl) |
Осуществляет вызов класса ScriptControl для возврата скриптов экземпляра, которые должны использоваться для поддержки клиентского объекта, представляющего клиентский элемент управления, компонент или поведение. |
| RegisterStartupScript(Control, Type, String, String, Boolean) |
Регистрирует стартовый блок скрипта для элемента управления, находящегося внутри UpdatePanel, используя элемент управления ScriptManager, и добавляет блок скрипта к странице. |
| RegisterStartupScript(Page, Type, String, String, Boolean) |
Регистрирует стартовый блок скрипта для каждой асинхронной обратной передачи с помощью элемента управления ScriptManager и добавляет блок скрипта к странице. |
| RemovedControl(Control) |
Вызывается после удаления дочернего элемента управления из коллекции Controls объекта Control. (Унаследовано от Control) |
| Render(HtmlTextWriter) |
Выполняет отрисовку содержимое элемента управления ScriptManager в браузере, используя указанный объект HtmlTextWriter. |
| RenderChildren(HtmlTextWriter) |
Выводит содержимое дочерних элементов серверного элемента управления в предоставленный объект HtmlTextWriter, который записывает это содержимое для подготовки к просмотру на клиенте. (Унаследовано от Control) |
| RenderControl(HtmlTextWriter) |
Выводит содержимое серверного элемента управления в указанный объект HtmlTextWriter и сохраняет сведения о трассировке элемента управления, если трассировка включена. (Унаследовано от Control) |
| RenderControl(HtmlTextWriter, ControlAdapter) |
Выводит серверный элемент управления в указанный объект HtmlTextWriter, используя указанный объект ControlAdapter. (Унаследовано от Control) |
| ResolveAdapter() |
Возвращает адаптер элемента управления, отвечающий за отрисовку определенного элемента управления. (Унаследовано от Control) |
| ResolveClientUrl(String) |
Возвращает URL-адрес, который может использоваться браузером. (Унаследовано от Control) |
| ResolveUrl(String) |
Преобразует URL-адрес в адрес, доступный для клиента. (Унаследовано от Control) |
| SaveControlState() |
Сохраняет любые изменения состояния серверного элемента управления, произошедшие после отправки страницы обратно на сервер. (Унаследовано от Control) |
| SaveViewState() |
Сохраняет любые изменения состояния просмотра серверного элемента управления, произошедшие после отправки страницы обратно на сервер. (Унаследовано от Control) |
| SetDesignModeState(IDictionary) |
Задает данные времени разработки для элемента управления. (Унаследовано от Control) |
| SetFocus(Control) |
Устанавливает фокус ввода браузера на указанном элементе управления. |
| SetFocus(String) |
Устанавливает фокус ввода браузера на элементе управления, указанном идентификатором. |
| SetRenderMethodDelegate(RenderMethod) |
Назначает делегата обработчика событий для преобразования серверного элемента управления и его содержимого для просмотра в родительский элемент управления. (Унаследовано от Control) |
| SetTraceData(Object, Object) |
Задает данные трассировки для трассировки данных отрисовки во время разработки, используя ключ данных трассировки и значение данных трассировки. (Унаследовано от Control) |
| SetTraceData(Object, Object, Object) |
Задает данные трассировки для трассировки данных отрисовки во время разработки, используя трассируемый объект, ключ данных трассировки и значение данных трассировки. (Унаследовано от Control) |
| ToString() |
Возвращает строку, представляющую текущий объект. (Унаследовано от Object) |
| TrackViewState() |
Вызывает отслеживание изменений состояния представления серверного элемента управления для сохранения в объекте StateBag серверного элемента управления. Этот объект доступен с помощью свойства ViewState. (Унаследовано от Control) |
События
| AsyncPostBackError |
Происходит при ошибке страницы во время асинхронной обратной передачи. |
| DataBinding |
Происходит при привязке серверного элемента управления к источнику данных. (Унаследовано от Control) |
| Disposed |
Происходит при освобождении памяти, занятой серверным элементом управления, т.е. на последнем этапе жизненного цикла серверного элемента управления при запросе страницы ASP.NET. (Унаследовано от Control) |
| Init |
Происходит при инициализации серверного элемента управления, который находится на первом этапе его жизненного цикла. (Унаследовано от Control) |
| Load |
Происходит при загрузке серверного элемента управления в объект Page. (Унаследовано от Control) |
| Navigate |
Происходит при нажатии пользователем в браузере кнопки Назад или Вперед. |
| PreRender |
Происходит после загрузки объекта Control, но перед отрисовкой. (Унаследовано от Control) |
| ResolveCompositeScriptReference |
Происходит, когда составной скрипт регистрируется с помощью элемента управления ScriptManager. |
| ResolveScriptReference |
Происходит, когда элемент коллекции Scripts регистрируется с помощью элемента управления ScriptManager. |
| Unload |
Происходит при выгрузке серверного элемента управления из памяти. (Унаследовано от Control) |
Явные реализации интерфейса
Методы расширения
| FindDataSourceControl(Control) |
Возвращает источник данных, связанный с элементом управления данными, для заданного элемента управления. |
| FindFieldTemplate(Control, String) |
Возвращает шаблон поля для заданного столбца в контейнере именования заданного элемента управления. |
| FindMetaTable(Control) |
Возвращает объект метатаблицы для контейнерного элемента управления данными. |
Применяется к
См. также раздел
Обратная связь
Ожидается в ближайшее время: в течение 2024 года мы постепенно откажемся от GitHub Issues как механизма обратной связи для контента и заменим его новой системой обратной связи. Дополнительные сведения см. в разделе https://aka.ms/ContentUserFeedback.
Отправить и просмотреть отзыв по