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 IPostBackEventHandler
Public Class ScriptManager
Inherits Control
Implements IPostBackDataHandler, IPostBackEventHandler
Наследование
ScriptManager
Атрибуты
Реализации

Примеры

В следующих примерах показаны различные сценарии использования 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, элемент управления отображает файл скрипта с таким именем, как scriptname.en-MX.debug.js, если файл существует. Если файл не существует, отрисовывается отладочный файл для соответствующего резервного языка и региональных параметров.

Дополнительные сведения о локализации ресурсов см. в статье Общие сведения о локализации ресурсов для библиотек компонентов.

Обработка ошибок

При возникновении ошибки страницы во время асинхронной обратной передачи 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 значение null.

(Унаследовано от Control)
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)

Выполняет поиск серверного элемента управления с заданным параметром id в текущем контейнере именования.

(Унаследовано от Control)
FindControl(String, Int32)

Выполняет поиск в текущем контейнере именования серверного элемента управления с указанным id и целым числом, указанным в параметре pathOffset, который содействует поиску. Эту версию метода FindControl не следует переопределять.

(Унаследовано от Control)
Focus()

Задает фокус ввода на элемент управления.

(Унаследовано от Control)
GetCurrent(Page)

Возвращает экземпляр ScriptManager для конкретного объекта Page.

GetDesignModeState()

Возвращает данные времени разработки для элемента управления.

(Унаследовано от Control)
GetHashCode()

Служит хэш-функцией по умолчанию.

(Унаследовано от Object)
GetRegisteredArrayDeclarations()

Возвращает коллекцию только для чтения объявлений массива ECMAScript (JavaScript), которые были ранее зарегистрированы с объектом Page.

GetRegisteredClientScriptBlocks()

Возвращает коллекцию только для чтения блоков клиентского скрипта, которые были прежде зарегистрированы с помощью элемента управления ScriptManager.

GetRegisteredDisposeScripts()

Возвращает коллекцию только для чтения скриптов dispose, которые были прежде зарегистрированы с объектом Page.

GetRegisteredExpandoAttributes()

Возвращает коллекцию только для чтения пользовательских (expando) атрибутов, которые были прежде зарегистрированы с объектом Page.

GetRegisteredHiddenFields()

Возвращает коллекцию только для чтения скрытых полей, которые были прежде зарегистрированы с объектом Page.

GetRegisteredOnSubmitStatements()

Возвращает коллекцию только для чтения операторов onsubmit, которые были прежде зарегистрированы с объектом Page.

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)

Регистрирует скрипт dispose для элемента управления, находящегося внутри элемента управления UpdatePanel. Скрипт выполняется, когда элемент управления UpdatePanel изменяется или удаляется.

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)

Явные реализации интерфейса

IControlBuilderAccessor.ControlBuilder

Описание этого члена см. в разделе ControlBuilder.

(Унаследовано от Control)
IControlDesignerAccessor.GetDesignModeState()

Описание этого члена см. в разделе GetDesignModeState().

(Унаследовано от Control)
IControlDesignerAccessor.SetDesignModeState(IDictionary)

Описание этого члена см. в разделе SetDesignModeState(IDictionary).

(Унаследовано от Control)
IControlDesignerAccessor.SetOwnerControl(Control)

Описание этого члена см. в разделе SetOwnerControl(Control).

(Унаследовано от Control)
IControlDesignerAccessor.UserData

Описание этого члена см. в разделе UserData.

(Унаследовано от Control)
IDataBindingsAccessor.DataBindings

Описание этого члена см. в разделе DataBindings.

(Унаследовано от Control)
IDataBindingsAccessor.HasDataBindings

Описание этого члена см. в разделе HasDataBindings.

(Унаследовано от Control)
IExpressionsAccessor.Expressions

Описание этого члена см. в разделе Expressions.

(Унаследовано от Control)
IExpressionsAccessor.HasExpressions

Описание этого члена см. в разделе HasExpressions.

(Унаследовано от Control)
IParserAccessor.AddParsedSubObject(Object)

Описание этого члена см. в разделе AddParsedSubObject(Object).

(Унаследовано от Control)
IPostBackDataHandler.LoadPostData(String, NameValueCollection)

Описание этого члена см. в разделе LoadPostData(String, NameValueCollection).

IPostBackDataHandler.RaisePostDataChangedEvent()

Описание этого члена см. в разделе RaisePostDataChangedEvent().

IPostBackEventHandler.RaisePostBackEvent(String)

Позволяет элементу управления ScriptManager обрабатывать событие обратной передачи и загружать предыдущее состояние веб-страницы.

Методы расширения

FindDataSourceControl(Control)

Возвращает источник данных, связанный с элементом управления данными, для заданного элемента управления.

FindFieldTemplate(Control, String)

Возвращает шаблон поля для заданного столбца в контейнере именования заданного элемента управления.

FindMetaTable(Control)

Возвращает объект метатаблицы для контейнерного элемента управления данными.

Применяется к

См. также раздел