ScriptManager Класс
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Управляет 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 элемента управления. По умолчанию значение UpdateMode свойства равно Always, а значение ChildrenAsTriggers свойства — true. Таким образом, дочерние элементы управления панели вызывают асинхронную обратную передачу.
<%@ 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 содержит настраиваемый элементErrors , этот элемент определяет способ отображения ошибок. Дополнительные сведения см. в разделе customErrors Element (ASP.NET Settings Schema).
<%@ 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) Date, Number и String в браузере, зависящих от языка и региональных параметров .
Доступ к ресурсам локализации для внедренных файлов скриптов или автономных файлов скриптов с помощью ResourceUICultures свойства ScriptReference элемента управления.
Зарегистрируйте серверные элементы управления, реализующие IExtenderControl или IScriptControl интерфейсы с ScriptManager элементом управления, чтобы скрипт, необходимый для клиентских компонентов и поведения, отображался.
Partial-Page отрисовка
Возможность ASP.NET страницы поддерживать отрисовку частичной страницы управляется следующими факторами:
Свойство ScriptManager элемента управления EnablePartialRendering должно быть
true(значение по умолчанию).На странице должен быть хотя бы один UpdatePanel элемент управления.
Свойство SupportsPartialRendering должно быть
true(значение по умолчанию). SupportsPartialRendering Если свойство не задано явным образом, его значение основано на возможностях браузера.
Можно переопределить значение EnablePartialRendering свойства во время выполнения во время выполнения или перед событием страницы Init . Если вы попытаетесь изменить это свойство после события страницы Init , InvalidOperationException создается исключение.
Если поддерживается отрисовка частичной страницы, ScriptManager элемент управления отрисовывает скрипт для включения асинхронных обратных вызовов и обновлений частичной страницы. Области обновляемой страницы определяются с помощью UpdatePanel элементов управления. Элемент ScriptManager управления обрабатывает асинхронные обратные передачи и обновляет только регионы страницы, которые необходимо обновить. Дополнительные сведения о частичной отрисовке страниц см. в Partial-Page обзоре отрисовки. Дополнительные сведения об условиях, вызывающих обновление, см. в разделе "Обзор элемента управления 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
Для регистрации файлов скриптов, которые не зависят от библиотеки Microsoft Ajax, можно использовать следующие методы, но совместимые с UpdatePanel элементами управления. Эти методы соответствуют аналогичным методам ClientScriptManager элемента управления. Если вы выполняете отрисовку скрипта для использования внутри UpdatePanel элемента управления, убедитесь, что методы ScriptManager элемента управления вызываются.
| Метод | Определение |
|---|---|
| RegisterArrayDeclaration | Добавляет значение в массив JavaScript. Если массив не существует, он создается. |
| RegisterClientScriptBlock |
script Отображает элемент после открывающего <form> тега страницы. Скрипт указывается как строковый параметр. |
| RegisterClientScriptInclude |
script Отображает элемент после открывающего <form> тега страницы. Содержимое скрипта указывается путем задания атрибута src URL-адресу, указывающего на файл скрипта. |
| RegisterClientScriptResource |
script Отображает элемент после открывающего <form> тега страницы. Содержимое скрипта указывается с именем ресурса в сборке. Атрибут src автоматически заполняется URL-адресом вызовом обработчика HTTP, который извлекает именованный скрипт из сборки. |
| RegisterExpandoAttribute | Отрисовывает пару атрибутов пользовательского имени и значения (расширение) в разметке для указанного элемента управления. |
| RegisterHiddenField | Отрисовывает скрытое поле. |
| RegisterOnSubmitStatement | Регистрирует скрипт, выполняемый в ответ на form событие элемента submit . Атрибут onSubmit ссылается на указанный скрипт. |
| RegisterStartupScript | Отрисовывает блок скрипта запуска непосредственно перед закрывающим </form> тегом страницы. Скрипт для отрисовки указывается как строковый параметр. |
При регистрации методов необходимо указать пару типов и ключей для этого скрипта. Если скрипт с той же парой типов и ключей уже зарегистрирован, новый скрипт не зарегистрирован. Аналогичным образом, если вы регистрируете скрипт с парой имен типа или ресурса, которая уже существует, элемент, ссылающийся на ресурс, script еще не добавлен. При регистрации атрибута expando ранее зарегистрированного атрибута создается исключение. Допускается повторяющаяся регистрация значений массива.
При вызове RegisterClientScriptIncludeRegisterClientScriptResource метода избежать регистрации скрипта, выполняющего встроенные функции. Вместо этого зарегистрируйте скрипт, содержащий определения функций, такие как обработчики событий или определения пользовательских классов для приложения.
Методы регистрации для элементов управления 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 управления определяет список языков и региональных параметров пользовательского ScriptReference интерфейса, поддерживаемых с помощью ResourceUICultures свойства объекта.
В режиме отладки. Элемент ScriptManager управления пытается отобразить файл скрипта для языка и региональных параметров, содержащий сведения об отладке. Например, если страница находится в режиме отладки, а для текущего языка и региональных параметров задано значение en-MX, элемент управления отображает файл скрипта с таким именем, как
scriptname.en-MX.debug.js, если файл существует. Если файл не существует, отладочный файл для соответствующего резервного языка и региональных параметров отрисовывается
Дополнительные сведения о локализации ресурсов см. в разделе "Общие сведения о локализации ресурсов для библиотек компонентов".
Обработка ошибок
При возникновении ошибки страницы во время асинхронной обратной передачи AsyncPostBackError событие вызывается. Способ отправки ошибок на сервере клиенту зависит от AllowCustomErrorsRedirect свойства, AsyncPostBackErrorMessage свойства и раздела пользовательских ошибок файла Web.config. Дополнительные сведения см. в разделе "Настройка обработки ошибок" для элементов управления 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, которую используют компоненты на странице. |
| 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 (сеть доставки содержимого). |
| 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) |
Вызывается после добавления дочернего Control элемента управления в Controls коллекцию объекта. (Унаследовано от Control) |
| AddHistoryPoint(NameValueCollection, String) |
Создает точку журнала и добавляет ее в стек журнала браузера с помощью указанного набора данных состояния и заголовка состояния. |
| AddHistoryPoint(String, String, String) |
Создает точку журнала и добавляет ее в стек журнала браузера, используя указанный ключ состояния, значение состояния и заголовок состояния. |
| AddHistoryPoint(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, Int32) |
Выполняет поиск текущего контейнера именования для элемента управления сервером с указанным |
| FindControl(String) |
Выполняет поиск текущего контейнера именования для элемента управления сервером с указанным |
| 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, Boolean) |
Отправляет пользовательские данные в элемент управления во время отрисовки частичной страницы и указывает, находится ли данные в формате нотации объектов JavaScript (JSON). |
| RegisterDataItem(Control, String) |
Отправляет пользовательские данные в элемент управления во время отрисовки частичной страницы. |
| RegisterDispose(Control, String) |
|
| RegisterExpandoAttribute(Control, String, String, String, Boolean) |
Регистрирует пару name/value с 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) |
Вызывается после удаления дочернего Control элемента управления из Controls коллекции объекта. (Унаследовано от Control) |
| Render(HtmlTextWriter) |
ScriptManager Отображает содержимое элемента управления в браузере с помощью указанного HtmlTextWriter объекта. |
| RenderChildren(HtmlTextWriter) |
Выводит содержимое дочерних элементов управления сервера в предоставленный HtmlTextWriter объект, который записывает содержимое для отрисовки на клиенте. (Унаследовано от Control) |
| RenderControl(HtmlTextWriter, ControlAdapter) |
Выводит содержимое элемента управления сервером в предоставленный HtmlTextWriter объект с помощью предоставленного ControlAdapter объекта. (Унаследовано от Control) |
| RenderControl(HtmlTextWriter) |
Выводит содержимое сервера управления в предоставленный HtmlTextWriter объект и сохраняет сведения о трассировке элемента управления, если трассировка включена. (Унаследовано от Control) |
| ResolveAdapter() |
Возвращает адаптер управления, отвечающий за отрисовку указанного элемента управления. (Унаследовано от Control) |
| ResolveClientUrl(String) |
Получает URL-адрес, который может использоваться браузером. (Унаследовано от Control) |
| ResolveUrl(String) |
Преобразует URL-адрес в url-адрес, который можно использовать на запрашиваемом клиенте. (Унаследовано от Control) |
| SaveControlState() |
Сохраняет все изменения состояния управления сервером, которые произошли с момента публикации страницы на сервер. (Унаследовано от Control) |
| SaveViewState() |
Сохраняет все изменения состояния представления представления сервера, которые произошли с момента отправки страницы на сервер. (Унаследовано от Control) |
| SetDesignModeState(IDictionary) |
Задает данные во время разработки для элемента управления. (Унаследовано от Control) |
| SetFocus(Control) |
Задает фокус браузера для указанного элемента управления. |
| SetFocus(String) |
Задает фокус браузера для элемента управления, указанного идентификатором. |
| SetRenderMethodDelegate(RenderMethod) |
Назначает делегат обработчика событий для отрисовки элемента управления сервером и его содержимого в родительский элемент управления. (Унаследовано от Control) |
| SetTraceData(Object, Object, Object) |
Задает данные трассировки для трассировки данных отрисовки во время разработки, используя объект трассировки, ключ данных трассировки и значение данных трассировки. (Унаследовано от Control) |
| SetTraceData(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) |
Возвращает объект метатабли для содержащего элемента управления данными. |
