ScriptManager Класс

Определение

Управляет библиотекой скриптов AJAX для ASP.NET и файлами скриптов, частичной отрисовкой страниц и созданием прокси-класса клиента для веб-служб и служб приложений.Manages ASP.NET Ajax script libraries and script files, partial-page rendering, and client proxy class generation for Web and application services.

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

Примеры

В следующих примерах показаны различные сценарии использования элемента управления ScriptManager.The following examples show different scenarios for using the ScriptManager control.

Включение частичного обновления страницEnabling Partial-Page Updates

В следующем примере показано, как использовать элемент управления ScriptManager для включения частичного обновления страницы.The following example shows how to use the ScriptManager control to enable partial-page updates. В этом примере Calendar и элемент управления DropDownList находятся внутри элемента управления UpdatePanel.In this example, a Calendar and a DropDownList control are inside an UpdatePanel control. По умолчанию значением свойства UpdateMode является Always, а значение свойства ChildrenAsTriggerstrue.By default, the value of the UpdateMode property is Always, and the value of the ChildrenAsTriggers property is true. Поэтому дочерние элементы управления панели вызывают асинхронную обратную передачу.Therefore, child controls of the panel cause an asynchronous postback.


<%@ 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>

Обработка ошибок частичного обновления страниц и регистрация скриптаHandling Partial-Page Update Errors and Registering Script

В следующем примере показано, как обеспечить пользовательскую обработку ошибок во время частичного обновления страницы.The following example shows how to provide custom error handling during partial-page updates. По умолчанию при возникновении ошибки во время частичного обновления страницы отображается окно сообщения JavaScript.By default, when an error occurs during partial-page updates, a JavaScript message box is displayed. В этом примере демонстрируется использование пользовательской обработки ошибок путем предоставления обработчика для события AsyncPostBackError и установки свойства AsyncPostBackErrorMessage в обработчике событий.This example demonstrates how to use custom error handling by providing a handler for the AsyncPostBackError event, and by setting the AsyncPostBackErrorMessage property in the event handler. Можно также задать свойство AllowCustomErrorsRedirect, чтобы указать, каким способом пользовательский раздел ошибок в файле Web. config будет использоваться при возникновении ошибки во время частичного обновления страницы.You can also set the AllowCustomErrorsRedirect property to specify how the custom errors section of the Web.config file is used when an error occurs during partial-page updates. В этом примере используется значение по умолчанию свойства AllowCustomErrorsRedirect.In this example, the default value of the AllowCustomErrorsRedirect property is used. Это означает, что если файл Web. config содержит элемент customErrors , то этот элемент определяет, как отображаются ошибки.This means that if the Web.config file contains a customErrors element, that element determines how errors are displayed. Дополнительные сведения см. в разделе элемент customErrors (схема параметров ASP.NET).For more information, see 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>

Глобализация даты и времени, отображаемых в браузереGlobalizing the Date and Time That Are Displayed in the Browser

В следующем примере показано, как задать свойство EnableScriptGlobalization, чтобы клиентский скрипт мог отображать в браузере дату и время, связанные с языком и региональными параметрами.The following example shows how to set the EnableScriptGlobalization property so that client script can display a culture-specific date and time in the browser. В этом примере атрибуту Culture директивы @ Page присвоено значение auto.In the example, the Culture attribute of the @ Page directive is set to auto. В результате, первый язык, указанный в текущих параметрах браузера, определяет язык и региональные параметры пользовательского интерфейса для страницы.As a result, the first language that is specified in the current browser settings determines the culture and UI culture for the page. Дополнительные сведения см. в разделе как установить язык и региональные параметры и региональные параметры пользовательского интерфейса для ASP.NET веб-страниц.For more information, see How to: Set the Culture and UI Culture for ASP.NET Web Page Globalization.

<%@ 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>

Комментарии

В этом разделе.In this topic:

ВступлениеIntroduction

Элемент управления ScriptManager является центральным для функций AJAX в ASP.NET.The ScriptManager control is central to Ajax functionality in ASP.NET. Элемент управления управляет всеми ресурсами AJAX ASP.NET на странице.The control manages all ASP.NET Ajax resources on a page. Это включает загрузку скриптов библиотеки Microsoft AJAX в браузер и координацию частичных обновлений страниц, включенных с помощью UpdatePanel элементов управления.This includes downloading Microsoft Ajax Library scripts to the browser and coordinating partial-page updates that are enabled by using UpdatePanel controls. Кроме того, элемент управления ScriptManager позволяет выполнять следующие действия:In addition, the ScriptManager control enables you to do the following:

  • Регистрация скрипта, совместимого с частичным обновлением страницы.Register script that is compatible with partial-page updates. Чтобы управлять зависимостями между скриптом и основной библиотекой, любой регистрируемый скрипт загружается после скрипта библиотеки Microsoft AJAX.In order to manage dependencies between your script and the core library, any script that you register is loaded after the Microsoft Ajax Library script.

  • Укажите, отправляются ли скрипты выпуска или отладки в браузер.Specify whether release or debug scripts are sent to the browser.

  • Предоставьте доступ к методам веб-службы из скрипта, зарегистрировав веб-службы с помощью элемента управления ScriptManager.Provide access to Web service methods from script by registering Web services with the ScriptManager control.

  • Предоставьте доступ к службам ASP.NET проверки подлинности, роли и профиля из клиентского скрипта, зарегистрировав эти службы с помощью элемента управления ScriptManager.Provide access to ASP.NET authentication, role, and profile application services from client script by registering these services with the ScriptManager control.

  • Включить отображение функций ECMAScript (JavaScript) и строковых параметров в браузере.Enable culture-specific display of ECMAScript (JavaScript) , , and String functions in the browser.

  • Доступ к ресурсам локализации для внедренных файлов скриптов или файлов автономных скриптов с помощью свойства ResourceUICultures элемента управления ScriptReference.Access localization resources for embedded script files or for stand-alone script files by using the ResourceUICultures property of the ScriptReference control.

  • Зарегистрируйте серверные элементы управления, реализующие IExtenderControl или IScriptControl интерфейсы с помощью элемента управления ScriptManager, чтобы отобразить скрипт, необходимый клиентским компонентам и поведениям.Register server controls that implement the IExtenderControl or IScriptControl interfaces with the ScriptManager control so that script required by client components and behaviors is rendered.

Частичная визуализация страницыPartial-Page Rendering

Возможность ASP.NET страницы для поддержки частичной отрисовки страниц управляется следующими факторами:The ability of an ASP.NET page to support partial-page rendering is controlled by the following factors:

Можно переопределить значение свойства EnablePartialRendering во время выполнения во время или до события Init страницы.You can override the value of the EnablePartialRendering property at run time during or before the page's Init event. При попытке изменить это свойство после возникновения события Init страницы возникает исключение InvalidOperationException.If you try to change this property after the page's Init event has occurred, an InvalidOperationException exception is thrown.

При поддержке частичной отрисовки страниц элемент управления ScriptManager отображает скрипт для включения асинхронных обратных передач и частичных обновлений страниц.When partial-page rendering is supported, the ScriptManager control renders script to enable asynchronous postbacks and partial-page updates. Области обновляемой страницы обозначаются с помощью UpdatePanel элементов управления.The regions of the page to be updated are designated by using UpdatePanel controls. Элемент управления ScriptManager обрабатывает асинхронные обратные передачи и обновляет только те регионы страницы, которые должны быть обновлены.The ScriptManager control handles the asynchronous postbacks and refreshes only the regions of the page that have to be updated. Дополнительные сведения о частичной отрисовке страниц см. в разделе Общие сведения о частичнойотрисовке страниц.For more information about partial-page rendering, see Partial-Page Rendering Overview. Дополнительные сведения об условиях, которые вызывают обновление, см. в разделе Общие сведения о элементе управления UpdatePanel.For more information about the conditions that cause an update, see UpdatePanel Control Overview.

Использование элемента управления ScriptManager с главными страницами, пользовательскими элементами управления и другими дочерними компонентамиUsing the ScriptManager Control with Master Pages, User Controls, and Other Child Components

Страница может содержать только один элемент управления ScriptManager в иерархии.A page can contain only one ScriptManager control in its hierarchy. Чтобы зарегистрировать службы и скрипты для вложенных страниц, пользовательских элементов управления или компонентов, если на родительской странице уже имеется элемент управления ScriptManager, используйте элемент управления ScriptManagerProxy.To register services and scripts for nested pages, user controls, or components when the parent page already has a ScriptManager control, use the ScriptManagerProxy control. Дополнительные сведения см. в разделе использование элемента управления UpdatePanel с главными страницами .For more information, see Using the UpdatePanel Control with Master Pages

Управление скриптами и их регистрацияScript Management and Registration

Элемент управления ScriptManager позволяет регистрировать скрипты, которые затем подготавливаются к просмотру как часть страницы.The ScriptManager control enables you to register script that is then rendered as part of the page. Методы регистрации ScriptManager элемента управления могут быть разбиты на следующие три категории:The ScriptManager control registration methods can be broken into the following three categories:

  • Методы регистрации, гарантирующие, что зависимости скриптов в библиотеке Microsoft AJAX сохраняются.Registration methods that guarantee that script dependencies on the Microsoft Ajax Library are maintained.

  • Методы регистрации, которые не зависят от библиотеки Microsoft AJAX, но совместимы с элементами управления UpdatePanel.Registration methods that are not dependent on the Microsoft Ajax Library, but that are compatible with UpdatePanel controls.

  • Методы регистрации, поддерживающие работу с элементами управления UpdatePanel.Registration methods that support working with UpdatePanel controls.

Дополнительные сведения о создании и использовании скрипта AJAX в ASP.NET см. в разделе Создание пользовательского клиентского скрипта с помощью библиотеки Microsoft AJAX.For more information about how to create and use Ajax script in ASP.NET, see Creating Custom Client Script by Using the Microsoft Ajax Library.

Регистрация скрипта, зависящего от библиотеки Microsoft AJAXRegistering Script That Is Dependent on the Microsoft Ajax Library

Для регистрации файлов скриптов можно использовать следующие методы, гарантирующие, что все зависимости от библиотеки Microsoft AJAX будут сохранены.You can use the following methods to register script files in a way that guarantees that any dependencies on the Microsoft Ajax Library are maintained.

МетодMethod ОпределениеDefinition
RegisterScriptControl Регистрирует серверный элемент управления, реализующий интерфейс IScriptControl, который используется для определения объекта клиента sys. Component .Registers a server control that implements the IScriptControl interface that is used to define a Sys.Component client object. Элемент управления ScriptManager визуализирует скрипт, который поддерживает клиентский объект.The ScriptManager control renders script that supports the client object.
RegisterExtenderControl Регистрирует серверный элемент управления, реализующий интерфейс IExtenderControl, который используется для определения объекта клиента sys. Component .Registers a server control that implements the IExtenderControl interface that is used to define a Sys.Component client object. Элемент управления ScriptManager визуализирует скрипт, который поддерживает клиентский объект.The ScriptManager control renders script that supports the client object.

Регистрация скриптов, совместимых с частичным обновлением страницыRegistering Partial-Page Update Compatible Scripts

Для регистрации файлов скриптов, которые не зависят от библиотеки Microsoft AJAX, но совместимы с элементами управления UpdatePanel, можно использовать следующие методы.You can use the following methods to register script files that are not dependent on the Microsoft Ajax Library but that are compatible with UpdatePanel controls. Эти методы соответствуют аналогичным методам элемента управления ClientScriptManager.These methods correspond to similar methods of the ClientScriptManager control. При подготовке скрипта для использования внутри элемента управления UpdatePanel убедитесь, что вызываются методы элемента управления ScriptManager.If you are rendering script for use inside an UpdatePanel control, make sure that you call the methods of the ScriptManager control.

МетодMethod ОпределениеDefinition
RegisterArrayDeclaration Добавляет значение в массив JavaScript.Adds a value to a JavaScript array. Если массив не существует, он будет создан.If the array does not exist, it is created.
RegisterClientScriptBlock Визуализирует элемент script после открывающего тега <form> страницы.Renders a script element after the page's opening <form> tag. Скрипт указывается в виде строкового параметра.The script is specified as a string parameter.
RegisterClientScriptInclude Визуализирует элемент script после открывающего тега <form> страницы.Renders a script element after the page's opening <form> tag. Содержимое скрипта задается путем присвоения атрибуту src URL-адреса, указывающего на файл скрипта.The script content is specified by setting the src attribute to a URL that points to a script file.
RegisterClientScriptResource Визуализирует элемент script после открывающего тега <form> страницы.Renders a script element after the page's opening <form> tag. Содержимое скрипта указывается с именем ресурса в сборке.The script content is specified with a resource name in an assembly. Атрибут src автоматически заполняется URL-адресом путем вызова обработчика HTTP, который получает именованный скрипт из сборки.The src attribute is automatically populated with a URL by a call to an HTTP handler that retrieves the named script from the assembly.
RegisterExpandoAttribute Отображает пользовательскую пару "имя-значение" (expando) в разметке для указанного элемента управления.Renders a custom name/value attribute pair (an expando) in the markup for a specified control.
RegisterHiddenField Отображает скрытое поле.Renders a hidden field.
RegisterOnSubmitStatement Регистрирует скрипт, выполняемый в ответ на событие submit элемента form.Registers a script that is executed in response to the form element's submit event. Атрибут onSubmit ссылается на указанный скрипт.The onSubmit attribute references the specified script.
RegisterStartupScript Подготавливает блок сценария запуска непосредственно перед закрывающим тегом </form> страницы.Renders a startup script block just before the page's closing </form> tag. Скрипт для подготовки к просмотру указывается в виде строкового параметра.The script to render is specified as a string parameter.

При регистрации методов задается пара типа или ключа для этого скрипта.When you register methods, you specify a type/key pair for that script. Если сценарий с такой же парой "тип-ключ" уже зарегистрирован, новый скрипт не регистрируется.If a script with the same type/key pair is already registered, a new script is not registered. Аналогично, при регистрации скрипта с уже существующими парой типа или имени ресурса элемент script, ссылающийся на ресурс, снова не добавляется.Similarly, if you register a script with a type/resource name pair that already exists, the script element that references the resource is not added again. При регистрации атрибута expando ранее зарегистрированного атрибута создается исключение.When you register an expando attribute of a previously registered attribute, an exception is thrown. Допускается дублирование регистрации значений массива.Duplicate registration of array values is allowed.

При вызове метода RegisterClientScriptInclude или RegisterClientScriptResource не следует регистрировать скрипты, выполняющие встроенные функции.When you call the RegisterClientScriptInclude or the RegisterClientScriptResource method, avoid registering script that executes inline functions. Вместо этого зарегистрируйте скрипт, содержащий определения функций, такие как обработчики событий или определения пользовательских классов для приложения.Instead, register script that contains function definitions like event handlers or custom class definitions for your application.

Методы регистрации для элементов управления UpdatePanelRegistration Methods for UpdatePanel Controls

Для настройки частичного обновления страницы при использовании элементов управления UpdatePanel можно использовать следующие методы.You can use the following methods to customize partial-page updates when you use UpdatePanel controls.

МетодMethod ОпределениеDefinition
RegisterAsyncPostBackControl Регистрирует элемент управления в качестве триггера асинхронных обратных передач.Registers a control as a trigger for asynchronous postbacks.
RegisterDataItem Посылает пользовательские данные элементу управления во время частичной отрисовки страницы.Sends custom data to controls during partial-page rendering.
RegisterDispose Регистрирует скрипт dispose для элемента управления, находящегося внутри элемента управления UpdatePanel.Registers a dispose script for a control that is inside an UpdatePanel control. Скрипт выполняется, когда элемент управления UpdatePanel изменяется или удаляется.The script is executed when the UpdatePanel control is updated or deleted. Метод Dispose используется для клиентских компонентов, которые являются частью библиотеки Microsoft AJAX и должны освобождать ресурсы, если компонент больше не используется.The dispose method is used for client components that are part of the Microsoft Ajax Library and that have to free resources when a component is no longer used.
RegisterPostBackControl Регистрирует элемент управления в качестве триггера для полной обратной передачи.Registers a control as a trigger for a full postback. Этот метод используется для элементов управления в элементе управления UpdatePanel, которые в противном случае будут выполнять асинхронные обратные передачи.This method is used for controls inside an UpdatePanel control that would otherwise perform asynchronous postbacks.

Ссылки на веб-службыWeb Service References

Вы можете зарегистрировать веб-службу, вызываемую из клиентского скрипта, создав объект ServiceReference и добавив его в коллекцию Services элемента управления ScriptManager.You can register a Web service to be called from client script by creating a ServiceReference object and adding it to the Services collection of the ScriptManager control. ASP.NET создает клиентский прокси-объект для каждого объекта ServiceReference в коллекции Services.ASP.NET generates a client proxy object for each ServiceReference object in the Services collection. Можно программно добавлять ServiceReference объекты в коллекцию Services для регистрации веб-служб во время выполнения.You can programmatically add ServiceReference objects to the Services collection to register Web services at run time.

Дополнительные сведения о доступе к веб-службам в скрипте см. в разделе предоставление веб-служб клиентскому скрипту в ASP.NET AJAX и вызов веб-служб из клиентского скрипта в ASP.NET AJAX.For more information about how to access Web services in script, see Exposing Web Services to Client Script in ASP.NET AJAX and Calling Web Services from Client Script in ASP.NET AJAX.

ЛокализацияLocalization

Элемент управления ScriptManager создает ссылки на подготовленной странице, указывающие на соответствующие локализованные файлы скриптов, которые являются либо файлами скриптов, внедренными в сборки, либо автономными файлами скриптов.The ScriptManager control generates references in the rendered page that point to the appropriate localized script files, which are either script files embedded in assemblies or stand-alone script files.

Если свойство EnableScriptLocalization имеет значение true, элемент управления ScriptManager извлекает локализованные ресурсы (например, локализованные строки) для текущего языка и региональных параметров, если они существуют.When the EnableScriptLocalization property is set to true, the ScriptManager control retrieves localized resources (such as localized strings) for the current culture, if they exist. Элемент управления ScriptManager предоставляет следующие функциональные возможности для использования локализованных ресурсов:The ScriptManager control provides the following functionality for using localized resources:

  • Файлы скриптов, внедренные в сборку.Script files that are embedded in an assembly. Элемент управления ScriptManager определяет, какой файл скрипта, зависящего от языка и региональных параметров, для отправки в браузер.The ScriptManager control determines which culture-specific or fallback-culture script file to send to the browser. Для этого используется атрибут сборки NeutralResourcesLanguageAttribute, зависящий от языка и региональных параметров, ресурсы, Упакованные в сборку, и язык и региональные параметры пользовательского интерфейса браузера (при наличии).It does this by using the culture-specific NeutralResourcesLanguageAttribute assembly attribute, the resources packaged with the assembly, and the UI culture of the browser (if any).

  • Изолированные файлы скриптов.Stand-alone script files. ScriptManager Управления определяет список языков и региональных параметров пользовательского интерфейса, которые поддерживаются с помощью ResourceUICultures свойство ScriptReference объекта.The ScriptManager control defines the list of UI cultures that are supported by using the ResourceUICultures property of the ScriptReference object.

  • В режиме отладки.In debug mode. Элемент управления ScriptManager пытается отобразить файл сценария, зависящий от языка и региональных параметров, который содержит отладочную информацию.The ScriptManager control tries to render a culture-specific script file that contains debug information. Например, если страница находится в режиме отладки, а для текущего языка и региональных параметров задано значение en-MX, элемент управления визуализирует файл скрипта с именем, например scriptname. Ен-МКС. Debug. js, если файл существует.For example, if the page is in debug mode and the current culture is set to en-MX, the control renders a script file that has a name such as scriptname.en-MX.debug.js, if the file exists. Если файл не существует, выполняется визуализация файла отладки для соответствующего резервного языка и региональных параметровIf the file does not exist, the debug file for the appropriate fallback culture is rendered

Дополнительные сведения о локализации ресурсов см. в статье Общие сведения о локализации ресурсов для библиотек компонентов.For more information about how to localize resources, see Localizing Resources for Component Libraries Overview.

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

При возникновении ошибки страницы во время асинхронной обратной передачи возникает событие AsyncPostBackError.When a page error occurs during asynchronous postbacks, the AsyncPostBackError event is raised. Способ отправки ошибок на сервере в клиент зависит от свойства AllowCustomErrorsRedirect, свойства AsyncPostBackErrorMessage и раздела Пользовательские ошибки в файле Web. config.The way in which errors on the server are sent to the client depends on the AllowCustomErrorsRedirect property, the AsyncPostBackErrorMessage property, and the custom errors section of the Web.config file. Обратной передачи из элемента управления, который является триггером для элемента управления.For more information, see Customizing Error Handling for UpdatePanel Controls.

Декларативный синтаксисDeclarative Syntax

<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.Initializes a new instance of the ScriptManager class.

Свойства

Adapter

Возвращает конкретный адаптер браузера для элемента управления.Gets the browser-specific adapter for the control.

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

Возвращает сборку платформы AJAX, компоненты которой используются на странице.Gets the Ajax framework assembly that components on the page use.

AjaxFrameworkMode

Возвращает или задает значение, определяющее способ включения в клиент клиентских скриптов клиентской библиотеки Microsoft Ajax.Gets or sets a value that specifies how client scripts of the Microsoft Ajax client library will be included on the client.

AllowCustomErrorsRedirect

Возвращает или устанавливает значение, определяющее, используется ли пользовательский раздел ошибок файла Web.config при возникновении ошибки в асинхронной обратной передаче.Gets or sets a value that determines whether the custom errors section of the Web.config file is used during an error in an asynchronous postback.

AppRelativeTemplateSourceDirectory

Возвращает или задает относительно приложения виртуальный каталог объекта Page или UserControl, который содержит этот элемент управления.Gets or sets the application-relative virtual directory of the Page or UserControl object that contains this control.

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

Возвращает или устанавливает сообщение об ошибке, посылаемое клиенту, когда во время асинхронной обратной передачи возникает необработанное исключение сервера.Gets or sets the error message that is sent to the client when an unhandled server exception occurs during an asynchronous postback.

AsyncPostBackSourceElementID

Возвращает уникальный идентификатор элемента управления, вызвавшего асинхронную обратную передачу.Gets the unique ID of the control that caused the asynchronous postback.

AsyncPostBackTimeout

Возвращает или устанавливает значение, указывающее время, в секундах, перед тайм-аутом асинхронной обратной передачи, если отклик не получен.Gets or sets a value that indicates the time, in seconds, before asynchronous postbacks time out if no response is received.

AuthenticationService

Возвращает объект AuthenticationServiceManager, связанный с текущим экземпляром ScriptManager.Gets the AuthenticationServiceManager object that is associated with the current ScriptManager instance.

BindingContainer

Возвращает элемент управления, который содержит привязку данных элемента управления.Gets the control that contains this control's data binding.

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

Возвращает значение, которое указывает, созданы ли дочерние элементы управления серверного элемента управления.Gets a value that indicates whether the server control's child controls have been created.

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

Получает идентификатор элемента управления для HTML-разметки, созданной ASP.NET.Gets the control ID for HTML markup that is generated by ASP.NET.

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

Возвращает или задает алгоритм, используемый для создания значения свойства ClientID.Gets or sets the algorithm that is used to generate the value of the ClientID property.

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

Возвращает значение символа разделителя, используемого в свойстве ClientID.Gets a character value representing the separator character used in the ClientID property.

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

Возвращает или задает имя метода, в котором на стороне клиента обрабатывается событие Sys.Application.navigate.Gets or sets the name of the method that handles the Sys.Application.navigate event on the client.

CompositeScript

Возвращает ссылку на составной скрипт, поддерживающий веб-страницу.Gets a reference to the composite script that supports the Web page.

Context

Возвращает объект HttpContext, связанный с серверным элементом управления для текущего веб-запроса.Gets the HttpContext object associated with the server control for the current Web request.

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

Возвращает объект ControlCollection, который представляет дочерние элементы управления для указанного элемента управления сервера в иерархии пользовательского интерфейса.Gets a ControlCollection object that represents the child controls for a specified server control in the UI hierarchy.

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

Возвращает ссылку на контейнер именования, если контейнер именования реализует IDataItemContainer.Gets a reference to the naming container if the naming container implements IDataItemContainer.

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

Возвращает ссылку на контейнер именования, если контейнер именования реализует IDataKeysControl.Gets a reference to the naming container if the naming container implements IDataKeysControl.

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

Возвращает значение, указывающее, используется ли элемент управления на поверхности разработки.Gets a value indicating whether a control is being used on a design surface.

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

Возвращает или задает URL-адрес пустой веб-страницы.Gets or sets a URL to a blank Web page.

EnableCdn

Определяет, загружает ли текущая страница ссылки на клиентские скрипты из путей CDN (Content Delivery Network, сеть доставки содержимого).Determines whether the current page loads client script references from CDN (Content Delivery Network) paths.

EnableCdnFallback

Разрешает загружать локальную копию скрипта в случае, если сеть доставки содержимого (CDN) недоступна.Enables local copy of a script to load in the event that the CDN (Content Delivery Network) is unavailable.

EnableHistory

Возвращает или задает значение, указывающее, поддерживает ли веб-страница управление точками предыдущих состояний.Gets or sets a value that indicates whether the Web page supports history point management.

EnablePageMethods

Возвращает или устанавливает значение, указывающее, могут ли общие статические методы страницы на странице ASP.NET вызываться из клиентского скрипта.Gets or sets a value that indicates whether public static page methods in an ASP.NET page can be called from client script.

EnablePartialRendering

Возвращает или устанавливает значение, разрешающее частичную отрисовку страницы, которая, в свою очередь, позволяет обновлять области страницы по отдельности, используя элементы управления UpdatePanel.Gets or sets a value that enables partial rendering of a page, which in turn enables you to update regions of the page individually by using UpdatePanel controls.

EnableScriptGlobalization

Возвращает или устанавливает значение, указывающее, будет ли элемент управления ScriptManager предоставлять скрипт, поддерживающий правила синтаксического анализа и форматирования, специфичные для языка и региональных параметров.Gets or sets a value that indicates whether the ScriptManager control renders script that supports parsing and formatting of culture-specific information.

EnableScriptLocalization

Возвращает или задает значение, указывающее, предоставляет ли элемент управления ScriptManager локализованные версии файлов скриптов.Gets or sets a value that indicates whether the ScriptManager control renders localized versions of script files.

EnableSecureHistoryState

Возвращает или задает значение, указывающее, необходимо ли шифровать строку предыдущего состояния.Gets or sets a value that indicates whether to encrypt the history state string.

EnableTheming

Возвращает или задает значение, указывающее, применяются ли темы к этому элементу управления.Gets or sets a value indicating whether themes apply to this control.

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

Получает или задает значение, указывающее запрашивающему клиенту, сохраняет ли серверный элемент управления состояние представления и состояние представления своих дочерних элементов управления.Gets or sets a value indicating whether the server control persists its view state, and the view state of any child controls it contains, to the requesting client.

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

Возвращает список делегатов обработчиков событий элемента управления.Gets a list of event handler delegates for the control. Это свойство доступно только для чтения.This property is read-only.

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

Возвращает значение, которое указывает на наличие сохраненных параметров состояния представления у дочернего элемента серверного элемента управления.Gets a value indicating whether the current server control's child controls have any saved view-state settings.

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

Возвращает или задает программный идентификатор, назначенный серверному элементу управления.Gets or sets the programmatic identifier assigned to the server control.

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

Возвращает символ, используемый для разделения идентификаторов элементов управления.Gets the character used to separate control identifiers.

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

Возвращает значение, указывающее, имеют ли элементы управления в этом элементе управления состояние элемента управления.Gets a value indicating whether controls contained within this control have control state.

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

Возвращает значение, указывающее, будет ли предоставлена отладочная версия библиотек клиентских скриптов.Gets a value that indicates whether the debug versions of client script libraries will be rendered.

IsInAsyncPostBack

Возвращает значение, которое указывает, выполняется ли текущая обратная передача в режиме частичной отрисовки.Gets a value that indicates whether the current postback is being executed in partial-rendering mode.

IsNavigating

Возвращает значение, указывающее, обрабатывается ли в текущий момент событие Navigate.Gets a value that indicates whether a Navigate event is currently being handled.

IsTrackingViewState

Возвращает значение, отражающее сохранение изменений в состояние представления серверного элемента управления.Gets a value that indicates whether the server control is saving changes to its view state.

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

Возвращает значение, указывающее, используется ли состояние представления для этого элемента управления.Gets a value indicating whether view state is enabled for this control.

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

Возвращает или устанавливает значение, определяющее, загружаются ли шрифты до или после загрузки разметки для элементов пользовательского интерфейса страницы.Gets or sets a value that indicates whether scripts are loaded before or after markup for the page UI is loaded.

LoadViewStateByID

Возвращает значение, указывающее, участвует ли элемент управления в загрузке состояния представления ID вместо индекса.Gets a value indicating whether the control participates in loading its view state by ID instead of index.

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

Возвращает ссылку на контейнер именования элемента управления, создающий уникальное пространство имен для различения серверных элементов управления с одинаковыми значениями свойства ID.Gets a reference to the server control's naming container, which creates a unique namespace for differentiating between server controls with the same ID property value.

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

Возвращает ссылку на экземпляр Page, содержащий серверный элемент управления.Gets a reference to the Page instance that contains the server control.

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

Возвращает ссылку на родительский элемент управления серверного элемента управления в иерархии элементов управления страницы.Gets a reference to the server control's parent control in the page control hierarchy.

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

Возвращает объект ProfileServiceManager, связанный с текущим экземпляром ScriptManager.Gets the ProfileServiceManager object that is associated with the current ScriptManager instance.

RenderingCompatibility

Возвращает значение, которое задает версию ASP.NET, с которой совместим созданный HTML.Gets a value that specifies the ASP.NET version that rendered HTML will be compatible with.

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

Возвращает объект RoleServiceManager, связанный с текущим экземпляром ScriptManager.Gets the RoleServiceManager object that is associated with the current ScriptManager instance.

ScriptMode

Возвращает или устанавливает значение, указывающее, какая версия библиотек клиентских скриптов предоставляется: отладочная или версия для выпуска.Gets or sets a value that specifies whether debug or release versions of client script libraries are rendered.

ScriptPath

Возвращает или задает корневой путь расположения, используемого для построения пути к ASP.NET с функциональностью AJAX и пользовательским файлам скриптов.Gets or sets the root path of the location that is used to build the paths to ASP.NET Ajax and custom script files.

ScriptResourceMapping

Получает объект ScriptResourceMapping.Gets a ScriptResourceMapping object.

Scripts

Возвращает объект ScriptReferenceCollection, содержащий объекты ScriptReference, каждый из которых представляет файл скрипта, предоставленный клиенту.Gets a ScriptReferenceCollection object that contains the ScriptReference objects, each of which represents a script file rendered to the client.

Services

Возвращает объект ServiceReferenceCollection, содержащий объект ServiceReference для каждой веб-службы, предоставляемой ASP.NET на клиенте для обеспечения функциональности AJAX.Gets a ServiceReferenceCollection object that contains a ServiceReference object for each Web service that ASP.NET exposes on the client for Ajax functionality.

Site

Возвращает сведения о контейнере, который содержит текущий элемент управления при визуализации на поверхности конструктора.Gets information about the container that hosts the current control when rendered on a design surface.

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

Возвращает или задает обложку, применяемую к элементу управления.Gets or sets the skin to apply to the control.

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

Возвращает значение, показывающее, поддерживает ли клиент частичную отрисовку страницы.Gets a value that indicates whether the client supports partial-page rendering.

TemplateControl

Возвращает или задает ссылку на шаблон, содержащий этот элемент управления.Gets or sets a reference to the template that contains this control.

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

Возвращает виртуальный каталог Page или UserControl, содержащий текущий серверный элемент управления.Gets the virtual directory of the Page or UserControl that contains the current server control.

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

Возвращает уникальный идентификатор серверного элемента управления в иерархии.Gets the unique, hierarchically qualified identifier for the server control.

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

Возвращает или задает значение, указывающее, проверяет ли элемент управления полученный из браузера клиентский ввод на предмет потенциально опасных значений.Gets or sets a value that indicates whether the control checks client input from the browser for potentially dangerous values.

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

Возвращает словарь сведений о состоянии, позволяющих сохранять и восстанавливать состояние представления серверного элемента управления при нескольких запросах одной и той же страницы.Gets a dictionary of state information that allows you to save and restore the view state of a server control across multiple requests for the same page.

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

Возвращает значение, указывающее, является ли объект StateBag нечувствительным к регистру.Gets a value that indicates whether the StateBag object is case-insensitive.

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

Возвращает или задает режим состояния представления данного элемента управления.Gets or sets the view-state mode of this control.

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

Переопределяет свойство Visible, унаследованное от базового класса Control, чтобы предотвратить установку этого значения.Overrides the Visible property that is inherited from the base Control class to prevent setting this value.

Методы

AddedControl(Control, Int32)

Вызывается после добавления дочернего элемента управления в коллекцию Controls объекта Control.Called after a child control is added to the Controls collection of the Control object.

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

Создает точку предыдущего состояния и добавляет ее в стек журнала браузера, используя указанную коллекцию данных состояния и название состояния.Creates a history point and adds it to the browser's history stack, using the specified state data collection and state title.

AddHistoryPoint(String, String)

Создает точку предыдущего состояния и добавляет ее в стек журнала браузера, используя указанный ключ состояния и его значение.Creates a history point and adds it to the browser's history stack, using the specified state key and state value.

AddHistoryPoint(String, String, String)

Создает точку предыдущего состояния и добавляет ее в стек журнала браузера, используя указанный ключ состояния, значение состояния и название состояния.Creates a history point and adds it to the browser's history stack, using the specified state key, state value, and state title.

AddParsedSubObject(Object)

Уведомляет серверный элемент управления, что элемент XML или HTML был проанализирован, и добавляет элемент в серверный элемент управления объекта ControlCollection.Notifies the server control that an element, either XML or HTML, was parsed, and adds the element to the server control's ControlCollection object.

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

Применяет свойства стиля, определенные в таблице стилей страницы, к элементу управления.Applies the style properties defined in the page style sheet to the control.

(Унаследовано от Control)
BeginRenderTracing(TextWriter, Object)

Запускает трассировку во время разработки данных отрисовки.Begins design-time tracing of rendering data.

(Унаследовано от Control)
BuildProfileTree(String, Boolean)

Собирает сведения о серверном элементе управления и доставляет их свойству Trace, которое отображается при включенной на странице трассировке.Gathers information about the server control and delivers it to the Trace property to be displayed when tracing is enabled for the page.

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

Задает для кэшированного свойства ClientID значение null.Sets the cached ClientID value to null.

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

Удаляет сведения о состоянии элемента управления для дочерних элементов управления серверного элемента управления.Deletes the control-state information for the server control's child controls.

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

Удаляет сведения о состоянии элемента управления и состоянии представления для всех дочерних элементов серверного элемента управления.Deletes the view-state and control-state information for all the server control's child controls.

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

Удаляет сведения о состоянии представления для всех дочерних элементов серверного элемента управления.Deletes the view-state information for all the server control's child controls.

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

Задает для свойства ClientIDMode текущего экземпляра элемента управления и любых его дочерних элементов управления значение Inherit.Sets the ClientIDMode property of the current control instance and of any child controls to Inherit.

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

Вызывается платформой страницы ASP.NET для уведомления серверных элементов управления, использующих составную реализацию, о необходимости создания дочерних элементов управления, содержащихся в них для обратной передачи или отрисовки.Called by the ASP.NET page framework to notify server controls that use composition-based implementation to create any child controls they contain in preparation for posting back or rendering.

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

Создает новый объект ControlCollection для хранения дочерних элементов управления (литеральных и серверных) серверного элемента управления.Creates a new ControlCollection object to hold the child controls (both literal and server) of the server control.

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

Привязывает источник данных к вызываемому серверному элементу управления и всем его дочерним элементам управления.Binds a data source to the invoked server control and all its child controls.

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

Привязывает источник данных к вызванному серверному элементу управления и всем его дочерними элементами управления с возможностью вызова события DataBinding.Binds a data source to the invoked server control and all its child controls with an option to raise the DataBinding event.

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

Привязывает источник данных к дочерним элементам управления серверного элемента управления.Binds a data source to the server control's child controls.

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

Включает серверный элемент управления для выполнения окончательной чистки до освобождения памяти.Enables a server control to perform final clean up before it is released from memory.

(Унаследовано от Control)
EndRenderTracing(TextWriter, Object)

Завершает трассировку во время разработки данных отрисовки.Ends design-time tracing of rendering data.

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

Определяет наличие у серверного элемента управления дочерних элементов управления.Determines whether the server control contains child controls. Если дочерних элементов управления нет, они будут созданы.If it does not, it creates child controls.

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

Создает идентификатор для элементов управления, которые не имеют назначенного идентификатора.Creates an identifier for controls that do not have an identifier assigned.

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

Определяет, равен ли указанный объект текущему объекту.Determines whether the specified object is equal to the current object.

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

Выполняет поиск серверного элемента управления с заданным параметром id в текущем контейнере именования.Searches the current naming container for a server control with the specified id parameter.

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

Выполняет поиск в текущем контейнере именования серверного элемента управления с указанным id и целым числом, указанным в параметре pathOffset, который содействует поиску.Searches the current naming container for a server control with the specified id and an integer, specified in the pathOffset parameter, which aids in the search. Эту версию метода FindControl не следует переопределять.You should not override this version of the FindControl method.

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

Задает фокус ввода на элемент управления.Sets input focus to a control.

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

Возвращает экземпляр ScriptManager для конкретного объекта Page.Gets the ScriptManager instance for a given Page object.

GetDesignModeState()

Возвращает данные времени разработки для элемента управления.Gets design-time data for a control.

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

Служит в качестве хэш-функции по умолчанию.Serves as the default hash function.

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

Возвращает коллекцию только для чтения объявлений массива ECMAScript (JavaScript), которые были ранее зарегистрированы с объектом Page.Retrieves a read-only collection of ECMAScript (JavaScript) array declarations that were previously registered with the Page object.

GetRegisteredClientScriptBlocks()

Возвращает коллекцию только для чтения блоков клиентского скрипта, которые были прежде зарегистрированы с помощью элемента управления ScriptManager.Retrieves a read-only collection of client script blocks that were previously registered with the ScriptManager control.

GetRegisteredDisposeScripts()

Возвращает коллекцию только для чтения скриптов dispose, которые были прежде зарегистрированы с объектом Page.Retrieves a read-only collection of dispose scripts that were previously registered with the Page object.

GetRegisteredExpandoAttributes()

Возвращает коллекцию только для чтения пользовательских (expando) атрибутов, которые были прежде зарегистрированы с объектом Page.Retrieves a read-only collection of custom (expando) attributes that were previously registered with the Page object.

GetRegisteredHiddenFields()

Возвращает коллекцию только для чтения скрытых полей, которые были прежде зарегистрированы с объектом Page.Retrieves a read-only collection of hidden fields that were previously registered with the Page object.

GetRegisteredOnSubmitStatements()

Возвращает коллекцию только для чтения операторов onsubmit, которые были прежде зарегистрированы с объектом Page.Retrieves a read-only collection of onsubmit statements that were previously registered with the Page object.

GetRegisteredStartupScripts()

Возвращает коллекцию только для чтения стартовых скриптов, которые были прежде зарегистрированы с объектом Page.Retrieves a read-only collection of startup scripts that were previously registered with the Page object.

GetRouteUrl(Object)

Возвращает URL-адрес, соответствующий набору параметров маршрута.Gets the URL that corresponds to a set of route parameters.

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

Возвращает URL-адрес, соответствующий набору параметров маршрута.Gets the URL that corresponds to a set of route parameters.

(Унаследовано от Control)
GetRouteUrl(String, Object)

Возвращает URL-адрес, соответствующий набору параметров маршрута и имени маршрута.Gets the URL that corresponds to a set of route parameters and a route name.

(Унаследовано от Control)
GetRouteUrl(String, RouteValueDictionary)

Возвращает URL-адрес, соответствующий набору параметров маршрута и имени маршрута.Gets the URL that corresponds to a set of route parameters and a route name.

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

Извлекает строку, которая содержит пары "ключ-значение", представляющие состояние веб-страницы.Retrieves a string that contains key/value pairs that represent the state of the Web page.

GetType()

Возвращает объект Type для текущего экземпляра.Gets the Type of the current instance.

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

Возвращает часть с префиксом свойства UniqueID указанного элемента управления.Returns the prefixed portion of the UniqueID property of the specified control.

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

Определяет наличие у серверного элемента управления дочерних элементов управления.Determines if the server control contains any child controls.

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

Возвращает значение, указывающее, регистрируются ли события для элемента управления или каких-либо дочерних элементов управления.Returns a value indicating whether events are registered for the control or any child controls.

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

Определяет наличие у серверного элемента управления только текстового содержимого.Determines if the server control holds only literal content.

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

Восстанавливает сведения о состоянии элемента управления предыдущего запроса страницы, сохраненные методом SaveControlState().Restores control-state information from a previous page request that was saved by the SaveControlState() method.

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

Считывает данные формы, отправленные из браузера на сервер, и определяет источник асинхронной обратной передачи.Reads form data that is posted from the browser to the server, and determines the source of the asynchronous postback.

LoadViewState(Object)

Восстанавливает сведения о состоянии представления из предыдущего запроса страницы, сохраненного методом SaveViewState().Restores view-state information from a previous page request that was saved by the SaveViewState() method.

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

Извлекает физический путь, к которому ведет виртуальный путь (абсолютный или относительный).Retrieves the physical path that a virtual path, either absolute or relative, maps to.

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

Создает неполную копию текущего объекта Object.Creates a shallow copy of the current Object.

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

Вызывает событие AsyncPostBackError.Raises the AsyncPostBackError event.

OnBubbleEvent(Object, EventArgs)

Определяет, передается ли событие серверного элемента управления вверх по иерархии серверных элементов управления пользовательского интерфейса страницы.Determines whether the event for the server control is passed up the page's UI server control hierarchy.

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

Вызывает событие DataBinding.Raises the DataBinding event.

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

Инициирует событие Init и гарантирует, что на странице существует только один элемент управления ScriptManager.Raises the Init event and makes sure that only one ScriptManager control exists on the page.

OnLoad(EventArgs)

Создает событие Load.Raises the Load event.

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

Инициирует событие PreRender и регистрирует файлы скриптов и службы для частичных обновлений страниц.Raises the PreRender event, and registers script files and services for partial-page updates.

OnResolveCompositeScriptReference(CompositeScriptReferenceEventArgs)

Вызывает событие ResolveCompositeScriptReference.Raises the ResolveCompositeScriptReference event.

OnResolveScriptReference(ScriptReferenceEventArgs)

Инициирует событие ResolveScriptReference для каждой ссылки на скрипт, управляемый элементом управления ScriptManager.Raises the ResolveScriptReference event for each script reference that is managed by the ScriptManager control.

OnUnload(EventArgs)

Создает событие Unload.Raises the Unload event.

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

Возвращает Stream, используемое для чтения файла.Gets a Stream used to read a file.

(Унаследовано от Control)
RaiseBubbleEvent(Object, EventArgs)

Присваивает родительскому элементу управления все источники события и сведения о них.Assigns any sources of the event and its information to the control's parent.

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

Обрабатывает событие обратной передачи, порожденное элементом управления ScriptManager, и загружает предыдущее состояние веб-страницы.Processes a postback event raised by the ScriptManager control and loads the history state of the Web page.

RaisePostDataChangedEvent()

Вызывает событие для элемента управления ScriptManager, когда он выполняет обратную передачу на сервер.Raises events for the ScriptManager control when it posts back to the server.

RegisterArrayDeclaration(Control, String, String)

Регистрирует объявление массива ECMAScript (JavaScript) с помощью элемента управления ScriptManager для использования с элементом управления, находящимся внутри элемента управления UpdatePanel, и добавляет массив к странице.Registers an ECMAScript (JavaScript) array declaration with the ScriptManager control for use with a control that is inside an UpdatePanel control, and adds the array to the page.

RegisterArrayDeclaration(Page, String, String)

Регистрирует объявление массива ECMAScript (JavaScript) с помощью элемента управления ScriptManager для использования с элементом управления, находящимся внутри элемента управления UpdatePanel, и добавляет массив к странице.Registers an ECMAScript (JavaScript) array declaration with the ScriptManager control for use with a control that is inside an UpdatePanel control, and adds the array to the page.

RegisterAsyncPostBackControl(Control)

Регистрирует элемент управления в качестве триггера асинхронных обратных передач.Registers a control as a trigger for asynchronous postbacks.

RegisterClientScriptBlock(Control, Type, String, String, Boolean)

Регистрирует блок клиентского скрипта с помощью элемента управления ScriptManager для использования с элементом управления, находящимся внутри элемента управления UpdatePanel, и добавляет блок скрипта к странице.Registers a client script block with the ScriptManager control for use with a control that is inside an UpdatePanel control, and then adds the script block to the page.

RegisterClientScriptBlock(Page, Type, String, String, Boolean)

Регистрирует блок клиентского скрипта с помощью элемента управления ScriptManager для использования с элементом управления, находящимся внутри элемента управления UpdatePanel, и добавляет блок скрипта к странице.Registers a client script block with the ScriptManager control for use with a control that is inside an UpdatePanel control, and then adds the script block to the page.

RegisterClientScriptInclude(Control, Type, String, String)

Регистрирует файл клиентского скрипта с помощью элемента управления ScriptManager для использования с элементом управления, находящимся внутри элемента управления UpdatePanel, и затем добавляет ссылку на файл скрипта к странице.Registers a client script file with the ScriptManager control for use with a control that is inside an UpdatePanel control, and then adds a script file reference to the page.

RegisterClientScriptInclude(Page, Type, String, String)

Регистрирует клиентский скрипт с помощью элемента управления ScriptManager при каждой асинхронной обратной передаче, и затем добавляет ссылку на файл скрипта к странице.Registers client script with the ScriptManager control every time that an asynchronous postback occurs, and then adds a script file reference to the page.

RegisterClientScriptResource(Control, Type, String)

Регистрирует встроенный в сборку клиентский скрипт с помощью элемента управления ScriptManager для использования с элементом управления, участвующем в частичной отрисовке страницы.Registers the client script that is embedded in an assembly with the ScriptManager control for use with a control that is participating in partial-page rendering.

RegisterClientScriptResource(Page, Type, String)

Регистрирует встроенный в сборку клиентский скрипт с помощью элемента управления ScriptManager при каждой асинхронной обратной передаче.Registers a client script file that is embedded in an assembly with the ScriptManager control every time that a postback occurs.

RegisterDataItem(Control, String)

Посылает пользовательские данные элементу управления во время частичной отрисовки страницы.Sends custom data to a control during partial-page rendering.

RegisterDataItem(Control, String, Boolean)

Посылает пользовательские данные элементу управления во время частичной отрисовки страницы и указывает, имеют ли данные формат JavaScript Object Notation (JSON).Sends custom data to a control during partial-page rendering, and indicates whether the data is in JavaScript Object Notation (JSON) format.

RegisterDispose(Control, String)

Регистрирует скрипт dispose для элемента управления, находящегося внутри элемента управления UpdatePanel.Registers a dispose script for a control that is inside an UpdatePanel control. Скрипт выполняется, когда элемент управления UpdatePanel изменяется или удаляется.The script is executed when the UpdatePanel control is updated or deleted.

RegisterExpandoAttribute(Control, String, String, String, Boolean)

Регистрирует пару "имя-значение" с помощью элемента управления ScriptManager как пользовательский (expando) атрибут указанного элемента управления.Registers a name/value pair with the ScriptManager control as a custom (expando) attribute of a specified control.

RegisterExtenderControl<TExtenderControl>(TExtenderControl, Control)

Регистрирует элемент управления-расширитель с помощью текущего экземпляра ScriptManager.Registers an extender control with the current ScriptManager instance.

RegisterHiddenField(Control, String, String)

Регистрирует скрытое поле с помощью элемента управления ScriptManager для элемента управления, находящегося внутри элемента управления UpdatePanel.Registers a hidden field with the ScriptManager control for a control that is inside an UpdatePanel control.

RegisterHiddenField(Page, String, String)

Регистрирует скрытое поле с помощью элемента управления ScriptManager во время каждой асинхронной обратной передачи.Registers a hidden field with the ScriptManager control during every asynchronous postback.

RegisterNamedClientScriptResource(Control, String)

Регистрирует встроенный в сборку клиентский скрипт по имени ресурса с помощью элемента управления ScriptManager для использования с элементом управления, участвующем в частичной отрисовке страницы.Registers client script by resource name that is embedded in an assembly with the ScriptManager control for use with a control that is participating in partial-page rendering.

RegisterNamedClientScriptResource(Page, String)

Регистрирует встроенный в сборку клиентский скрипт по имени ресурса с помощью элемента управления ScriptManager для использования с элементом управления, участвующем в частичной отрисовке страницы.Registers client script by resource name that is embedded in an assembly with the ScriptManager control for use with a control that is participating in partial-page rendering.

RegisterOnSubmitStatement(Control, Type, String, String)

Регистрирует код ECMAScript (JavaScript) с помощью элемента управления ScriptManager для элемента управления, используемого элементом управления UpdatePanel, выполняемым при отправке формы.Registers ECMAScript (JavaScript) code with the ScriptManager control for a control that is used with an UpdatePanel control that is executed when the form is submitted.

RegisterOnSubmitStatement(Page, Type, String, String)

Регистрирует код ECMAScript (JavaScript) с помощью элемента управления ScriptManager для элемента управления, используемого элементом управления UpdatePanel, выполняемым при отправке формы.Registers ECMAScript (JavaScript) code with the ScriptManager control for a control that is used with an UpdatePanel control that is executed when the form is submitted.

RegisterPostBackControl(Control)

Регистрирует элемент управления в качестве триггера обратной передачи.Registers a control as a trigger for a postback. Этот метод используется для настройки элементов управления обратной передачи, находящихся внутри элемента управления UpdatePanel, который в противном случае выполняет асинхронные обратные передачи.This method is used to configure postback controls inside an UpdatePanel control that would otherwise perform asynchronous postbacks.

RegisterScriptControl<TScriptControl>(TScriptControl)

Регистрирует элемент управления скрипта с помощью текущего экземпляра ScriptManager.Registers a script control with the current ScriptManager instance.

RegisterScriptDescriptors(IExtenderControl)

Осуществляет обратный вызов класса ExtenderControl для возвращения скриптов экземпляра, которые должны использоваться для поддержки клиентского объекта, представляющего клиентский элемент управления, компонент или поведение.Calls back to an ExtenderControl class to return instance scripts that must be rendered to support the client object that represents a client control, component, or behavior.

RegisterScriptDescriptors(IScriptControl)

Осуществляет вызов класса ScriptControl для возврата скриптов экземпляра, которые должны использоваться для поддержки клиентского объекта, представляющего клиентский элемент управления, компонент или поведение.Calls a ScriptControl class to return instance scripts that must be rendered to support the client object that represents a client control, component, or behavior.

RegisterStartupScript(Control, Type, String, String, Boolean)

Регистрирует стартовый блок скрипта для элемента управления, находящегося внутри UpdatePanel, используя элемент управления ScriptManager, и добавляет блок скрипта к странице.Registers a startup script block for a control that is inside an UpdatePanel by using the ScriptManager control, and adds the script block to the page.

RegisterStartupScript(Page, Type, String, String, Boolean)

Регистрирует стартовый блок скрипта для каждой асинхронной обратной передачи с помощью элемента управления ScriptManager и добавляет блок скрипта к странице.Registers a startup script block for every asynchronous postback with the ScriptManager control and adds the script block to the page.

RemovedControl(Control)

Вызывается после удаления дочернего элемента управления из коллекции Controls объекта Control.Called after a child control is removed from the Controls collection of the Control object.

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

Выполняет отрисовку содержимое элемента управления ScriptManager в браузере, используя указанный объект HtmlTextWriter.Renders the ScriptManager control's content to the browser by using the specified HtmlTextWriter object.

RenderChildren(HtmlTextWriter)

Отправляет содержимое дочернего серверного элемента управления указанному объекту HtmlTextWriter, который записывает содержимое для преобразования на стороне клиента.Outputs the content of a server control's children to a provided HtmlTextWriter object, which writes the content to be rendered on the client.

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

Выводит содержимое серверного элемента управления в указанный объект HtmlTextWriter и сохраняет сведения о трассировке элемента управления, если трассировка включена.Outputs server control content to a provided HtmlTextWriter object and stores tracing information about the control if tracing is enabled.

(Унаследовано от Control)
RenderControl(HtmlTextWriter, ControlAdapter)

Выводит серверный элемент управления в указанный объект HtmlTextWriter, используя указанный объект ControlAdapter.Outputs server control content to a provided HtmlTextWriter object using a provided ControlAdapter object.

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

Возвращает адаптер элемента управления, отвечающий за отрисовку определенного элемента управления.Gets the control adapter responsible for rendering the specified control.

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

Возвращает URL-адрес, который может использоваться браузером.Gets a URL that can be used by the browser.

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

Преобразует URL-адрес в адрес, доступный для клиента.Converts a URL into one that is usable on the requesting client.

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

Сохраняет любые изменения состояния серверного элемента управления, произошедшие после отправки страницы обратно на сервер.Saves any server control state changes that have occurred since the time the page was posted back to the server.

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

Сохраняет любые изменения состояния просмотра серверного элемента управления, произошедшие после отправки страницы обратно на сервер.Saves any server control view-state changes that have occurred since the time the page was posted back to the server.

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

Задает данные времени разработки для элемента управления.Sets design-time data for a control.

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

Устанавливает фокус ввода браузера на указанном элементе управления.Sets the browser focus to the specified control.

SetFocus(String)

Устанавливает фокус ввода браузера на элементе управления, указанном идентификатором.Sets the browser focus to the control specified by ID.

SetRenderMethodDelegate(RenderMethod)

Назначает делегата обработчика событий для преобразования серверного элемента управления и его содержимого для просмотра в родительский элемент управления.Assigns an event handler delegate to render the server control and its content into its parent control.

(Унаследовано от Control)
SetTraceData(Object, Object)

Задает данные трассировки для трассировки данных отрисовки во время разработки, используя ключ данных трассировки и значение данных трассировки.Sets trace data for design-time tracing of rendering data, using the trace data key and the trace data value.

(Унаследовано от Control)
SetTraceData(Object, Object, Object)

Задает данные трассировки для трассировки данных отрисовки во время разработки, используя трассируемый объект, ключ данных трассировки и значение данных трассировки.Sets trace data for design-time tracing of rendering data, using the traced object, the trace data key, and the trace data value.

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

Возвращает строку, представляющую текущий объект.Returns a string that represents the current object.

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

Вызывает отслеживание изменений состояния представления серверного элемента управления для сохранения в объекте StateBag серверного элемента управления.Causes tracking of view-state changes to the server control so they can be stored in the server control's StateBag object. Этот объект доступен с помощью свойства ViewState.This object is accessible through the ViewState property.

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

События

AsyncPostBackError

Происходит при ошибке страницы во время асинхронной обратной передачи.Occurs when there is a page error during an asynchronous postback.

DataBinding

Происходит при привязке серверного элемента управления к источнику данных.Occurs when the server control binds to a data source.

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

Происходит при освобождении памяти, занятой серверным элементом управления, т.е. на последнем этапе жизненного цикла серверного элемента управления при запросе страницы ASP.NET.Occurs when a server control is released from memory, which is the last stage of the server control lifecycle when an ASP.NET page is requested.

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

Происходит при инициализации серверного элемента управления, который находится на первом этапе его жизненного цикла.Occurs when the server control is initialized, which is the first step in its lifecycle.

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

Происходит при загрузке серверного элемента управления в объект Page.Occurs when the server control is loaded into the Page object.

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

Происходит при нажатии пользователем в браузере кнопки Назад или Вперед.Occurs when the user clicks the browser's Back or Forward button.

PreRender

Происходит после загрузки объекта Control, но перед отрисовкой.Occurs after the Control object is loaded but prior to rendering.

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

Происходит, когда составной скрипт регистрируется с помощью элемента управления ScriptManager.Occurs when a composite script is registered with the ScriptManager control.

ResolveScriptReference

Происходит, когда элемент коллекции Scripts регистрируется с помощью элемента управления ScriptManager.Occurs when a member of the Scripts collection is registered with the ScriptManager control.

Unload

Происходит при выгрузке серверного элемента управления из памяти.Occurs when the server control is unloaded from memory.

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

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

IControlBuilderAccessor.ControlBuilder

Описание этого члена см. в разделе ControlBuilder.For a description of this member, see ControlBuilder.

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

Описание этого члена см. в разделе GetDesignModeState().For a description of this member, see GetDesignModeState().

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

Описание этого члена см. в разделе SetDesignModeState(IDictionary).For a description of this member, see SetDesignModeState(IDictionary).

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

Описание этого члена см. в разделе SetOwnerControl(Control).For a description of this member, see SetOwnerControl(Control).

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

Описание этого члена см. в разделе UserData.For a description of this member, see UserData.

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

Описание этого члена см. в разделе DataBindings.For a description of this member, see DataBindings.

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

Описание этого члена см. в разделе HasDataBindings.For a description of this member, see HasDataBindings.

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

Описание этого члена см. в разделе Expressions.For a description of this member, see Expressions.

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

Описание этого члена см. в разделе HasExpressions.For a description of this member, see HasExpressions.

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

Описание этого члена см. в разделе AddParsedSubObject(Object).For a description of this member, see AddParsedSubObject(Object).

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

Описание этого члена см. в разделе LoadPostData(String, NameValueCollection).For a description of this member, see LoadPostData(String, NameValueCollection).

IPostBackDataHandler.RaisePostDataChangedEvent()

Описание этого члена см. в разделе RaisePostDataChangedEvent().For a description of this member, see RaisePostDataChangedEvent().

IPostBackEventHandler.RaisePostBackEvent(String)

Позволяет элементу управления ScriptManager обрабатывать событие обратной передачи и загружать предыдущее состояние веб-страницы.Enables the ScriptManager control to process a postback event and load the history state of the Web page.

IScriptManager.IsSecureConnection
IScriptManager.RegisterArrayDeclaration(Control, String, String)
IScriptManager.RegisterClientScriptBlock(Control, Type, String, String, Boolean)
IScriptManager.RegisterClientScriptInclude(Control, Type, String, String)
IScriptManager.RegisterClientScriptResource(Control, Type, String)
IScriptManager.RegisterDispose(Control, String)
IScriptManager.RegisterExpandoAttribute(Control, String, String, String, Boolean)
IScriptManager.RegisterHiddenField(Control, String, String)
IScriptManager.RegisterOnSubmitStatement(Control, Type, String, String)
IScriptManager.RegisterPostBackControl(Control)
IScriptManager.RegisterStartupScript(Control, Type, String, String, Boolean)
IScriptManager.SetFocusInternal(String)

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

FindDataSourceControl(Control)

Возвращает источник данных, связанный с элементом управления данными, для заданного элемента управления.Returns the data source that is associated with the data control for the specified control.

FindFieldTemplate(Control, String)

Возвращает шаблон поля для заданного столбца в контейнере именования заданного элемента управления.Returns the field template for the specified column in the specified control's naming container.

FindMetaTable(Control)

Возвращает объект метатаблицы для контейнерного элемента управления данными.Returns the metatable object for the containing data control.

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

Дополнительно