Udostępnij za pośrednictwem


ScriptManager Klasa

Definicja

Zarządza ASP.NET biblioteki skryptów Ajax i pliki skryptów, renderowanie częściowej strony oraz generowanie klas serwera proxy klienta dla usług sieci Web i aplikacji.

public ref class ScriptManager : System::Web::UI::Control, System::Web::UI::IPostBackDataHandler, System::Web::UI::IPostBackEventHandler
[System.Drawing.ToolboxBitmap(typeof(EmbeddedResourceFinder), "System.Web.Resources.ScriptManager.bmp")]
public class ScriptManager : System.Web.UI.Control, System.Web.UI.IPostBackDataHandler, System.Web.UI.IPostBackEventHandler
[<System.Drawing.ToolboxBitmap(typeof(EmbeddedResourceFinder), "System.Web.Resources.ScriptManager.bmp")>]
type ScriptManager = class
    inherit Control
    interface IPostBackDataHandler
    interface IPostBackEventHandler
Public Class ScriptManager
Inherits Control
Implements IPostBackDataHandler, IPostBackEventHandler
Dziedziczenie
ScriptManager
Atrybuty
Implementuje

Przykłady

W poniższych przykładach przedstawiono różne scenariusze używania kontrolki ScriptManager .

Włączanie aktualizacji Partial-Page

W poniższym przykładzie pokazano, jak za pomocą kontrolki ScriptManager włączyć aktualizacje częściowej strony. W tym przykładzie kontrolka CalendarDropDownList i znajdują się wewnątrz kontrolki UpdatePanel . Domyślnie wartość UpdateMode właściwości to Always, a wartość ChildrenAsTriggers właściwości to true. W związku z tym kontrolki podrzędne panelu powodują asynchroniczne wycofywanie.


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

Obsługa błędów aktualizacji Partial-Page i rejestrowania skryptu

W poniższym przykładzie pokazano, jak zapewnić niestandardową obsługę błędów podczas aktualizacji częściowych stron. Domyślnie, gdy wystąpi błąd podczas aktualizacji częściowych stron, zostanie wyświetlone pole komunikatu JavaScript. W tym przykładzie pokazano, jak używać niestandardowej obsługi błędów, udostępniając procedurę obsługi AsyncPostBackError zdarzenia i ustawiając AsyncPostBackErrorMessage właściwość w procedurze obsługi zdarzeń. Można również ustawić AllowCustomErrorsRedirect właściwość, aby określić sposób użycia sekcji błędów niestandardowych w pliku Web.config w przypadku wystąpienia błędu podczas aktualizacji częściowych stron. W tym przykładzie jest używana wartość domyślna AllowCustomErrorsRedirect właściwości. Oznacza to, że jeśli plik Web.config zawiera element customErrors , ten element określa sposób wyświetlania błędów. Aby uzyskać więcej informacji, zobacz customErrors, element (schemat ustawień ASP.NET).

<%@ Page Language="C#" %>

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">

<script runat="server">

    protected void Button1_Click(object sender, EventArgs e)
    {
        try
        {
            int a = Int32.Parse(TextBox1.Text);
            int b = Int32.Parse(TextBox2.Text);
            int res = a / b;
            Label1.Text = res.ToString();
        }
        catch (Exception ex)
        {
            if (TextBox1.Text.Length > 0 && TextBox2.Text.Length > 0)
            {
                ex.Data["ExtraInfo"] = " You can't divide " +
                    TextBox1.Text + " by " + TextBox2.Text + ".";
            }
            throw ex;
        }
    }

    protected void ScriptManager1_AsyncPostBackError(object sender, AsyncPostBackErrorEventArgs e)
    {
        if (e.Exception.Data["ExtraInfo"] != null)
        {
            ScriptManager1.AsyncPostBackErrorMessage =
                e.Exception.Message +
                e.Exception.Data["ExtraInfo"].ToString();
        }
        else
        {
            ScriptManager1.AsyncPostBackErrorMessage =
                "An unspecified error occurred.";
        }
    }
</script>

<html xmlns="http://www.w3.org/1999/xhtml">
<head id="Head1" runat="server">
    <title>UpdatePanel Error Handling Example</title>
    <style type="text/css">
    #UpdatePanel1 {
      width: 200px; height: 50px;
      border: solid 1px gray;
    }
    #AlertDiv{
    left: 40%; top: 40%;
    position: absolute; width: 200px;
    padding: 12px; 
    border: #000000 1px solid;
    background-color: white; 
    text-align: left;
    visibility: hidden;
    z-index: 99;
    }
    #AlertButtons{
    position: absolute; right: 5%; bottom: 5%;
    }
    </style>
</head>
<body id="bodytag">
    <form id="form1" runat="server">
        <div>
            <asp:ScriptManager ID="ScriptManager1" 
            OnAsyncPostBackError="ScriptManager1_AsyncPostBackError" runat="server" >
            <Scripts>
            <asp:ScriptReference Path="ErrorHandling.js" />
            </Scripts>
            </asp:ScriptManager>
            <asp:UpdatePanel ID="UpdatePanel1" runat="server">
                <ContentTemplate>
                    <asp:TextBox ID="TextBox1" runat="server" Width="39px"></asp:TextBox>
                    /
                    <asp:TextBox ID="TextBox2" runat="server" Width="39px"></asp:TextBox>
                    =
                    <asp:Label ID="Label1" runat="server"></asp:Label><br />
                    <asp:Button ID="Button1" runat="server" OnClick="Button1_Click" Text="calculate" />
                </ContentTemplate>
            </asp:UpdatePanel>
            <div id="AlertDiv">
                <div id="AlertMessage">
                </div>
                <br />
                <div id="AlertButtons">
                    <input id="OKButton" type="button" value="OK" runat="server" onclick="ClearErrorState()" />
                </div>
            </div>
        </div>
    </form>
</body>
</html>
<%@ Page Language="VB" %>

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" 
 "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">

<script runat="server">
    Protected Sub Button1_Click(ByVal sender As Object, ByVal e As System.EventArgs)
        Try
            Dim a As Int32
            a = Int32.Parse(TextBox1.Text)
            Dim b As Int32
            b = Int32.Parse(TextBox2.Text)
            Dim res As Int32 = a / b
            Label1.Text = res.ToString()
        Catch ex As Exception
            If (TextBox1.Text.Length > 0 AndAlso TextBox2.Text.Length > 0) Then
                ex.Data("ExtraInfo") = " You can't divide " & _
                  TextBox1.Text & " by " & TextBox2.Text & "."
            End If
            Throw ex
        End Try

    End Sub
    Protected Sub ScriptManager1_AsyncPostBackError(ByVal sender As Object, ByVal e As System.Web.UI.AsyncPostBackErrorEventArgs)
        If (e.Exception.Data("ExtraInfo") <> Nothing) Then
            ScriptManager1.AsyncPostBackErrorMessage = _
               e.Exception.Message & _
               e.Exception.Data("ExtraInfo").ToString()
        Else
            ScriptManager1.AsyncPostBackErrorMessage = _
               "An unspecified error occurred."
        End If
    End Sub
</script>

<html xmlns="http://www.w3.org/1999/xhtml">
<head id="Head1" runat="server">
    <title>UpdatePanel Error Handling Example</title>
    <style type="text/css">
    #UpdatePanel1 {
      width: 200px; height: 50px;
      border: solid 1px gray;
    }
    #AlertDiv{
    left: 40%; top: 40%;
    position: absolute; width: 200px;
    padding: 12px; 
    border: #000000 1px solid;
    background-color: white; 
    text-align: left;
    visibility: hidden;
    z-index: 99;
    }
    #AlertButtons{
    position: absolute; right: 5%; bottom: 5%;
    }
    </style>
</head>
<body id="bodytag">
    <form id="form1" runat="server">
        <div>
            <asp:ScriptManager ID="ScriptManager1" 
            OnAsyncPostBackError="ScriptManager1_AsyncPostBackError" runat="server" >
            <Scripts>
            <asp:ScriptReference Path="ErrorHandling.js" />
            </Scripts>
            </asp:ScriptManager>

            <asp:UpdatePanel ID="UpdatePanel1" runat="server">
                <ContentTemplate>
                    <asp:TextBox ID="TextBox1" runat="server" Width="39px"></asp:TextBox>
                    /
                    <asp:TextBox ID="TextBox2" runat="server" Width="39px"></asp:TextBox>
                    =
                    <asp:Label ID="Label1" runat="server"></asp:Label><br />
                    <asp:Button ID="Button1" runat="server" OnClick="Button1_Click" Text="calculate" />
                </ContentTemplate>
            </asp:UpdatePanel>
            <div id="AlertDiv">
                <div id="AlertMessage">
                </div>
                <br />
                <div id="AlertButtons">
                    <input id="OKButton" type="button" value="OK" runat="server" onclick="ClearErrorState()" />
                </div>
            </div>
        </div>
    </form>
</body>
</html>

Globalizacja daty i godziny wyświetlanej w przeglądarce

W poniższym przykładzie pokazano, jak ustawić EnableScriptGlobalization właściwość, aby skrypt klienta mógł wyświetlać datę i godzinę specyficzną dla kultury w przeglądarce. W przykładzie Culture atrybut dyrektywy @ Page jest ustawiony na autowartość . W związku z tym pierwszy język określony w bieżących ustawieniach przeglądarki określa kulturę i kulturę interfejsu użytkownika dla strony. Aby uzyskać więcej informacji, zobacz How to: Set the Culture and UI Culture for ASP.NET Web Page Globalizacja.

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

Uwagi

W tym temacie:

Wprowadzenie

Kontrolka ScriptManager jest centralna dla funkcji Ajax w ASP.NET. Kontrolka zarządza wszystkimi zasobami ASP.NET Ajax na stronie. Obejmuje to pobieranie skryptów biblioteki Microsoft Ajax do przeglądarki i koordynowanie aktualizacji częściowych stron, które są włączone za pomocą UpdatePanel kontrolek. Ponadto kontrolka ScriptManager umożliwia wykonanie następujących czynności:

  • Zarejestruj skrypt zgodny z aktualizacjami częściowymi stronami. Aby zarządzać zależnościami między skryptem a biblioteką podstawową, każdy zarejestrowany skrypt jest ładowany po skryscie biblioteki Microsoft Ajax.

  • Określ, czy skrypty wydania lub debugowania są wysyłane do przeglądarki.

  • Zapewnianie dostępu do metod usługi sieci Web ze skryptu przez zarejestrowanie usług sieci Web za pomocą kontrolki ScriptManager .

  • Zapewnianie dostępu do ASP.NET uwierzytelniania, roli i profilowania usług aplikacji ze skryptu klienta przez zarejestrowanie tych usług za pomocą kontrolki ScriptManager .

  • Włącz wyświetlanie specyficznych dla kultury funkcji Date, Number i String języka ECMAScript (JavaScript) w przeglądarce.

  • Uzyskaj dostęp do zasobów lokalizacji dla plików skryptów osadzonych lub plików skryptów autonomicznych przy użyciu ResourceUICultures właściwości kontrolki ScriptReference .

  • Rejestrowanie kontrolek serwera, które implementują IExtenderControl interfejsy lub IScriptControl za pomocą ScriptManager kontrolki, tak aby skrypt wymagany przez składniki i zachowania klienta był renderowany.

Częściowe renderowanie strony

Możliwość obsługi renderowania częściowej strony ASP.NET jest kontrolowana przez następujące czynniki:

Wartość właściwości można zastąpić EnablePartialRendering w czasie wykonywania lub przed zdarzeniem strony Init . Jeśli spróbujesz zmienić tę właściwość po wystąpieniu zdarzenia strony Init , InvalidOperationException zostanie zgłoszony wyjątek.

Gdy renderowanie częściowej strony jest obsługiwane, kontrolka ScriptManager renderuje skrypt w celu włączenia asynchronicznych poświadczeń zwrotnych i aktualizacji częściowych stron. Regiony strony do zaktualizowania są wyznaczone za pomocą UpdatePanel kontrolek. Kontrolka ScriptManager obsługuje asynchroniczne wycofywanie i odświeża tylko regiony strony, które muszą zostać zaktualizowane. Aby uzyskać więcej informacji na temat renderowania częściowego strony, zobacz Częściowe renderowanie stron — omówienie. Aby uzyskać więcej informacji na temat warunków powodujących aktualizację, zobacz UpdatePanel Control Overview (Omówienie kontrolki UpdatePanel).

Używanie formantu ScriptManager w stronach wzorcowych, formantach użytkownika i innych składnikach podrzędnych

Strona może zawierać tylko jedną ScriptManager kontrolkę w hierarchii. Aby zarejestrować usługi i skrypty dla zagnieżdżonych stron, kontrolek użytkownika lub składników, gdy strona nadrzędna ma już kontrolkę ScriptManager , użyj kontrolki ScriptManagerProxy . Aby uzyskać więcej informacji, zobacz Using the UpdatePanel Control with Master Pages (Używanie kontrolki UpdatePanel ze stronami wzorcowymi).

Zarządzanie skryptem i rejestracja

Kontrolka ScriptManager umożliwia zarejestrowanie skryptu, który jest następnie renderowany w ramach strony. ScriptManager Metody rejestracji kontrolek można podzielić na następujące trzy kategorie:

  • Metody rejestracji, które gwarantują, że są utrzymywane zależności skryptów w bibliotece Microsoft Ajax.

  • Metody rejestracji, które nie są zależne od biblioteki Microsoft Ajax, ale które są zgodne z kontrolkami UpdatePanel .

  • Metody rejestracji, które obsługują pracę z kontrolkami UpdatePanel .

Aby uzyskać więcej informacji na temat tworzenia i używania skryptu Ajax w ASP.NET, zobacz Tworzenie niestandardowego skryptu klienta przy użyciu biblioteki Microsoft Ajax.

Rejestrowanie skryptu, który jest zależny od biblioteki Microsoft Ajax

Za pomocą poniższych metod można zarejestrować pliki skryptów w taki sposób, aby zagwarantować, że wszystkie zależności biblioteki Microsoft Ajax są utrzymywane.

Metoda Definicja
RegisterScriptControl Rejestruje kontrolkę serwera, która implementuje IScriptControl interfejs używany do definiowania obiektu klienta Sys.Component . Kontrolka ScriptManager renderuje skrypt obsługujący obiekt klienta.
RegisterExtenderControl Rejestruje kontrolkę serwera, która implementuje IExtenderControl interfejs używany do definiowania obiektu klienta Sys.Component . Kontrolka ScriptManager renderuje skrypt obsługujący obiekt klienta.

Rejestrowanie skryptów zgodnych z aktualizacją strony częściowej

Za pomocą poniższych metod można rejestrować pliki skryptów, które nie są zależne od biblioteki Microsoft Ajax, ale które są zgodne z kontrolkami UpdatePanel . Metody te odpowiadają podobnym metodom kontrolki ClientScriptManager . Jeśli skrypt renderowania jest używany wewnątrz UpdatePanel kontrolki, upewnij się, że wywołasz metody kontrolki ScriptManager .

Metoda Definicja
RegisterArrayDeclaration Dodaje wartość do tablicy JavaScript. Jeśli tablica nie istnieje, zostanie utworzona.
RegisterClientScriptBlock Renderuje script element po tagu otwierania <form> strony. Skrypt jest określony jako parametr ciągu.
RegisterClientScriptInclude Renderuje script element po tagu otwierania <form> strony. Zawartość skryptu jest określana przez ustawienie atrybutu src na adres URL wskazujący plik skryptu.
RegisterClientScriptResource Renderuje script element po tagu otwierania <form> strony. Zawartość skryptu jest określana przy użyciu nazwy zasobu w zestawie. Atrybut src jest automatycznie wypełniany adresem URL przez wywołanie procedury obsługi HTTP, która pobiera nazwany skrypt z zestawu.
RegisterExpandoAttribute Renderuje niestandardową parę atrybutów nazwa/wartość (expando) w adiustacji dla określonej kontrolki.
RegisterHiddenField Renderuje ukryte pole.
RegisterOnSubmitStatement Rejestruje skrypt wykonywany w odpowiedzi na form zdarzenie elementu submit . Atrybut onSubmit odwołuje się do określonego skryptu.
RegisterStartupScript Renderuje blok skryptu uruchamiania tuż przed tagiem zamykającym </form> strony. Skrypt do renderowania jest określony jako parametr ciągu.

Podczas rejestrowania metod należy określić parę typów/kluczy dla tego skryptu. Jeśli skrypt z tą samą parą typów/kluczy jest już zarejestrowany, nowy skrypt nie jest zarejestrowany. Podobnie, jeśli zarejestrujesz skrypt za pomocą pary nazwy typu/zasobu, która już istnieje, element, który odwołuje się do zasobu, script nie zostanie ponownie dodany. Podczas rejestrowania atrybutu expando wcześniej zarejestrowanego atrybutu zgłaszany jest wyjątek. Dozwolona jest zduplikowana rejestracja wartości tablicy.

Podczas wywoływania RegisterClientScriptInclude metody lub RegisterClientScriptResource należy unikać rejestrowania skryptu wykonującego funkcje wbudowane. Zamiast tego zarejestruj skrypt zawierający definicje funkcji, takie jak procedury obsługi zdarzeń lub niestandardowe definicje klas dla aplikacji.

Metody rejestracji formantów UpdatePanel

Poniższe metody umożliwiają dostosowanie aktualizacji częściowych stron podczas korzystania z UpdatePanel kontrolek.

Metoda Definicja
RegisterAsyncPostBackControl Rejestruje kontrolkę jako wyzwalacz asynchronicznych ogłaszania zwrotnego.
RegisterDataItem Wysyła dane niestandardowe do kontrolek podczas renderowania częściowego strony.
RegisterDispose Rejestruje skrypt usuwania dla kontrolki, która znajduje się wewnątrz kontrolki UpdatePanel . Skrypt jest wykonywany po zaktualizowaniu lub usunięciu UpdatePanel kontrolki. Metoda dispose jest używana w przypadku składników klienta, które są częścią biblioteki Microsoft Ajax i które muszą zwolnić zasoby, gdy składnik nie jest już używany.
RegisterPostBackControl Rejestruje kontrolkę jako wyzwalacz w celu uzyskania pełnego ogłaszania zwrotnego. Ta metoda jest używana do kontrolek wewnątrz UpdatePanel kontrolki, która w przeciwnym razie wykonałaby asynchroniczne ogłaszanie zwrotne.

Odwołania do usługi sieci Web

Usługę sieci Web do wywołania ze skryptu klienta można zarejestrować, tworząc ServiceReference obiekt i dodając go do Services kolekcji kontrolki ScriptManager . ASP.NET generuje obiekt serwera proxy klienta dla każdego ServiceReference obiektu w kolekcji Services . Można programowo dodawać ServiceReference obiekty do Services kolekcji, aby rejestrować usługi sieci Web w czasie wykonywania.

Aby uzyskać więcej informacji o sposobie uzyskiwania dostępu do usług sieci Web w skry skryptach, zobacz Uwidacznianie usług sieci Web do skryptu klienta w programie ASP.NET AJAX i wywoływanie usług sieci Web za pomocą skryptu klienta w ASP.NET AJAX.

Lokalizacja

Kontrolka ScriptManager generuje odwołania na renderowanej stronie, która wskazuje odpowiednie zlokalizowane pliki skryptów, które są plikami skryptów osadzonymi w zestawach lub autonomicznych plikach skryptów.

Gdy właściwość jest ustawiona EnableScriptLocalization na truewartość , kontrolka ScriptManager pobiera zlokalizowane zasoby (takie jak zlokalizowane ciągi) dla bieżącej kultury, jeśli istnieją. Kontrolka ScriptManager udostępnia następujące funkcje do używania zlokalizowanych zasobów:

  • Pliki skryptów osadzone w zestawie. Kontrolka ScriptManager określa, który plik skryptu specyficzny dla kultury lub fallback-culture ma być wysyłany do przeglądarki. Robi to przy użyciu atrybutu zestawu specyficznego dla NeutralResourcesLanguageAttribute kultury, zasobów spakowanych z zestawem i kultury interfejsu użytkownika przeglądarki (jeśli istnieje).

  • Autonomiczne pliki skryptów. Kontrolka ScriptManager definiuje listę kultur interfejsu użytkownika obsługiwanych przy użyciu ResourceUICultures właściwości ScriptReference obiektu.

  • W trybie debugowania. Kontrolka ScriptManager próbuje renderować plik skryptu specyficzny dla kultury, który zawiera informacje o debugowaniu. Jeśli na przykład strona jest w trybie debugowania, a bieżąca kultura jest ustawiona na en-MX, kontrolka renderuje plik skryptu o nazwie takiej jak scriptname.en-MX.debug.js, jeśli plik istnieje. Jeśli plik nie istnieje, plik debugowania dla odpowiedniej kultury rezerwowej jest renderowany

Aby uzyskać więcej informacji na temat lokalizowania zasobów, zobacz Lokalizowanie zasobów dla bibliotek składników — omówienie.

Obsługa błędów

Gdy podczas asynchronicznych ogłaszania zwrotnego wystąpi błąd strony, AsyncPostBackError zdarzenie jest zgłaszane. Sposób, w jaki błędy na serwerze są wysyłane do klienta, zależy od AllowCustomErrorsRedirect właściwości, AsyncPostBackErrorMessage właściwości i sekcji błędów niestandardowych w pliku Web.config. Aby uzyskać więcej informacji, zobacz Dostosowywanie obsługi błędów dla kontrolek UpdatePanel.

Składnia deklaracyjna

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

Konstruktory

ScriptManager()

Inicjuje nowe wystąpienie klasy ScriptManager.

Właściwości

Adapter

Pobiera kartę specyficzną dla przeglądarki dla kontrolki.

(Odziedziczone po Control)
AjaxFrameworkAssembly

Pobiera zestaw platformy Ajax używany przez składniki na stronie.

AjaxFrameworkMode

Pobiera lub ustawia wartość określającą sposób dołączania skryptów klienta biblioteki klienta Microsoft Ajax na kliencie.

AllowCustomErrorsRedirect

Pobiera lub ustawia wartość, która określa, czy sekcja błędów niestandardowych pliku Web.config jest używana podczas błędu w asynchronicznej powłoce.

AppRelativeTemplateSourceDirectory

Pobiera lub ustawia względny katalog Page wirtualny aplikacji obiektu lub UserControl , który zawiera tę kontrolkę.

(Odziedziczone po Control)
AsyncPostBackErrorMessage

Pobiera lub ustawia komunikat o błędzie wysyłany do klienta, gdy wystąpi nieobsługiwany wyjątek serwera podczas asynchronicznego powrotu.

AsyncPostBackSourceElementID

Pobiera unikatowy identyfikator kontrolki, która spowodowała asynchroniczne wycofywanie.

AsyncPostBackTimeout

Pobiera lub ustawia wartość wskazującą czas w sekundach przed przekroczeniem limitu czasu asynchronicznego po powrocie po awarii, jeśli żadna odpowiedź nie zostanie odebrana.

AuthenticationService

AuthenticationServiceManager Pobiera obiekt skojarzony z bieżącym ScriptManager wystąpieniem.

BindingContainer

Pobiera kontrolkę zawierającą powiązanie danych tego formantu.

(Odziedziczone po Control)
ChildControlsCreated

Pobiera wartość wskazującą, czy kontrolki podrzędne kontrolki serwera zostały utworzone.

(Odziedziczone po Control)
ClientID

Pobiera identyfikator kontrolki dla znaczników HTML generowanych przez ASP.NET.

(Odziedziczone po Control)
ClientIDMode

Pobiera lub ustawia algorytm używany do generowania ClientID wartości właściwości.

(Odziedziczone po Control)
ClientIDSeparator

Pobiera wartość znaku reprezentującą znak separatora ClientID używany we właściwości .

(Odziedziczone po Control)
ClientNavigateHandler

Pobiera lub ustawia nazwę metody obsługującej zdarzenie Sys.Application.navigate na kliencie.

CompositeScript

Pobiera odwołanie do złożonego skryptu obsługującego stronę sieci Web.

Context

HttpContext Pobiera obiekt skojarzony z kontrolką serwera dla bieżącego żądania sieci Web.

(Odziedziczone po Control)
Controls

ControlCollection Pobiera obiekt reprezentujący kontrolki podrzędne dla określonej kontrolki serwera w hierarchii interfejsu użytkownika.

(Odziedziczone po Control)
DataItemContainer

Pobiera odwołanie do kontenera nazewnictwa, jeśli kontener nazewnictwa implementuje IDataItemContainerelement .

(Odziedziczone po Control)
DataKeysContainer

Pobiera odwołanie do kontenera nazewnictwa, jeśli kontener nazewnictwa implementuje IDataKeysControlelement .

(Odziedziczone po Control)
DesignMode

Pobiera wartość wskazującą, czy kontrolka jest używana na powierzchni projektowej.

(Odziedziczone po Control)
EmptyPageUrl

Pobiera lub ustawia adres URL na pustą stronę sieci Web.

EnableCdn

Określa, czy bieżąca strona ładuje odwołania skryptu klienta ze ścieżek cdN (Content Delivery Network).

EnableCdnFallback

Umożliwia lokalne kopiowanie skryptu do załadowania w przypadku niedostępności sieci CDN (Content Delivery Network).

EnableHistory

Pobiera lub ustawia wartość wskazującą, czy strona sieci Web obsługuje zarządzanie punktami historii.

EnablePageMethods

Pobiera lub ustawia wartość wskazującą, czy publiczne metody statycznej strony na stronie ASP.NET mogą być wywoływane ze skryptu klienta.

EnablePartialRendering

Pobiera lub ustawia wartość, która umożliwia częściowe renderowanie strony, co z kolei umożliwia aktualizowanie regionów strony indywidualnie przy użyciu UpdatePanel kontrolek.

EnableScriptGlobalization

Pobiera lub ustawia wartość wskazującą, czy ScriptManager kontrolka renderuje skrypt obsługujący analizowanie i formatowanie informacji specyficznych dla kultury.

EnableScriptLocalization

Pobiera lub ustawia wartość wskazującą, czy kontrolka ScriptManager renderuje zlokalizowane wersje plików skryptów.

EnableSecureHistoryState

Pobiera lub ustawia wartość wskazującą, czy chcesz zaszyfrować ciąg stanu historii.

EnableTheming

Pobiera lub ustawia wartość wskazującą, czy motywy mają zastosowanie do tej kontrolki.

(Odziedziczone po Control)
EnableViewState

Pobiera lub ustawia wartość wskazującą, czy kontrolka serwera utrzymuje stan widoku oraz stan widoku wszystkich kontrolek podrzędnych, które zawiera, do klienta wysyłającego żądanie.

(Odziedziczone po Control)
Events

Pobiera listę delegatów programu obsługi zdarzeń dla kontrolki. Ta właściwość jest tylko do odczytu.

(Odziedziczone po Control)
HasChildViewState

Pobiera wartość wskazującą, czy kontrolki podrzędne bieżącego formantu serwera mają zapisane ustawienia stanu widoku.

(Odziedziczone po Control)
ID

Pobiera lub ustawia identyfikator programowy przypisany do kontrolki serwera.

(Odziedziczone po Control)
IdSeparator

Pobiera znak używany do oddzielania identyfikatorów kontrolek.

(Odziedziczone po Control)
IsChildControlStateCleared

Pobiera wartość wskazującą, czy kontrolki zawarte w tej kontrolce mają stan kontroli.

(Odziedziczone po Control)
IsDebuggingEnabled

Pobiera wartość wskazującą, czy wersje debugowania bibliotek skryptów klienta zostaną renderowane.

IsInAsyncPostBack

Pobiera wartość wskazującą, czy bieżący postback jest wykonywany w trybie częściowego renderowania.

IsNavigating

Pobiera wartość wskazującą Navigate , czy zdarzenie jest obecnie obsługiwane.

IsTrackingViewState

Pobiera wartość wskazującą, czy kontrolka serwera zapisuje zmiany w stanie widoku.

(Odziedziczone po Control)
IsViewStateEnabled

Pobiera wartość wskazującą, czy dla tej kontrolki jest włączony stan widoku.

(Odziedziczone po Control)
LoadScriptsBeforeUI

Pobiera lub ustawia wartość wskazującą, czy skrypty są ładowane przed, czy po adiustacji dla interfejsu użytkownika strony.

LoadViewStateByID

Pobiera wartość wskazującą, czy kontrolka uczestniczy w ładowaniu stanu widoku przez ID zamiast indeksu.

(Odziedziczone po Control)
NamingContainer

Pobiera odwołanie do kontenera nazewnictwa kontrolki serwera, który tworzy unikatową przestrzeń nazw do rozróżniania między kontrolkami serwera o tej samej ID wartości właściwości.

(Odziedziczone po Control)
Page

Pobiera odwołanie do Page wystąpienia, które zawiera kontrolkę serwera.

(Odziedziczone po Control)
Parent

Pobiera odwołanie do kontrolki nadrzędnej kontrolki serwera w hierarchii sterowania stronami.

(Odziedziczone po Control)
ProfileService

ProfileServiceManager Pobiera obiekt skojarzony z bieżącym ScriptManager wystąpieniem.

RenderingCompatibility

Pobiera wartość określającą wersję ASP.NET, z którą renderowany kod HTML będzie zgodny.

(Odziedziczone po Control)
RoleService

RoleServiceManager Pobiera obiekt skojarzony z bieżącym ScriptManager wystąpieniem.

ScriptMode

Pobiera lub ustawia wartość określającą, czy są renderowane wersje debugowania lub wydania bibliotek skryptów klienta.

ScriptPath
Przestarzałe.

Pobiera lub ustawia ścieżkę główną lokalizacji używanej do tworzenia ścieżek w celu ASP.NET plików Ajax i niestandardowych skryptów.

ScriptResourceMapping

ScriptResourceMapping Pobiera obiekt.

Scripts

ScriptReferenceCollection Pobiera obiekt zawierający ScriptReference obiekty, z których każdy reprezentuje plik skryptu renderowany na kliencie.

Services

ServiceReferenceCollection Pobiera obiekt zawierający ServiceReference obiekt dla każdej usługi sieci Web, która ASP.NET uwidacznia na kliencie funkcji Ajax.

Site

Pobiera informacje o kontenerze hostujące bieżącą kontrolkę podczas renderowania na powierzchni projektowej.

(Odziedziczone po Control)
SkinID

Pobiera lub ustawia skórę do zastosowania do kontrolki.

(Odziedziczone po Control)
SupportsPartialRendering

Pobiera wartość wskazującą, czy klient obsługuje renderowanie częściowe strony.

TemplateControl

Pobiera lub ustawia odwołanie do szablonu zawierającego tę kontrolkę.

(Odziedziczone po Control)
TemplateSourceDirectory

Pobiera katalog wirtualny elementu Page lub UserControl , który zawiera bieżącą kontrolkę serwera.

(Odziedziczone po Control)
UniqueID

Pobiera unikatowy, hierarchicznie kwalifikowany identyfikator kontroli serwera.

(Odziedziczone po Control)
ValidateRequestMode

Pobiera lub ustawia wartość wskazującą, czy kontrolka sprawdza dane wejściowe klienta z przeglądarki pod kątem potencjalnie niebezpiecznych wartości.

(Odziedziczone po Control)
ViewState

Pobiera słownik informacji o stanie, który umożliwia zapisanie i przywrócenie stanu widoku kontrolki serwera w wielu żądaniach dla tej samej strony.

(Odziedziczone po Control)
ViewStateIgnoresCase

Pobiera wartość wskazującą, czy StateBag obiekt jest niewrażliwy na wielkość liter.

(Odziedziczone po Control)
ViewStateMode

Pobiera lub ustawia tryb stanu widoku tej kontrolki.

(Odziedziczone po Control)
Visible

Visible Zastępuje właściwość dziedziczona z klasy bazowejControl, aby zapobiec ustawieniu tej wartości.

Metody

AddedControl(Control, Int32)

Wywoływane po dodaniu kontrolki podrzędnej do Controls kolekcji Control obiektu.

(Odziedziczone po Control)
AddHistoryPoint(NameValueCollection, String)

Tworzy punkt historii i dodaje go do stosu historii przeglądarki przy użyciu określonego stanu zbierania danych i tytułu stanu.

AddHistoryPoint(String, String)

Tworzy punkt historii i dodaje go do stosu historii przeglądarki przy użyciu określonego klucza stanu i wartości stanu.

AddHistoryPoint(String, String, String)

Tworzy punkt historii i dodaje go do stosu historii przeglądarki przy użyciu określonego klucza stanu, wartości stanu i tytułu stanu.

AddParsedSubObject(Object)

Powiadamia formant serwera, że element ( XML lub HTML) został przeanalizowany i dodaje element do obiektu kontrolki ControlCollection serwera.

(Odziedziczone po Control)
ApplyStyleSheetSkin(Page)

Stosuje właściwości stylu zdefiniowane w arkuszu stylów strony do kontrolki.

(Odziedziczone po Control)
BeginRenderTracing(TextWriter, Object)

Rozpoczyna śledzenie danych renderowania w czasie projektowania.

(Odziedziczone po Control)
BuildProfileTree(String, Boolean)

Zbiera informacje o kontrolce serwera i dostarcza ją do Trace właściwości, która ma być wyświetlana po włączeniu śledzenia dla strony.

(Odziedziczone po Control)
ClearCachedClientID()

Ustawia wartość buforowanej ClientID na nullwartość .

(Odziedziczone po Control)
ClearChildControlState()

Usuwa informacje o stanie sterowania dla kontrolek podrzędnych kontrolki serwera.

(Odziedziczone po Control)
ClearChildState()

Usuwa informacje o stanie widoku i stanie sterowania dla wszystkich kontrolek podrzędnych kontrolki serwera.

(Odziedziczone po Control)
ClearChildViewState()

Usuwa informacje o stanie widoku dla wszystkich kontrolek podrzędnych kontrolki serwera.

(Odziedziczone po Control)
ClearEffectiveClientIDMode()

ClientIDMode Ustawia właściwość bieżącego wystąpienia kontrolki i wszystkich kontrolek podrzędnych na Inheritwartość .

(Odziedziczone po Control)
CreateChildControls()

Wywoływana przez platformę strony ASP.NET w celu powiadamiania kontrolek serwera, które używają implementacji opartej na kompozycji w celu utworzenia wszelkich kontrolek podrzędnych, które zawierają w ramach przygotowania do publikowania z powrotem lub renderowania.

(Odziedziczone po Control)
CreateControlCollection()

Tworzy nowy ControlCollection obiekt do przechowywania kontrolek podrzędnych (literał i serwer) kontrolki serwera.

(Odziedziczone po Control)
DataBind()

Wiąże źródło danych z wywołaną kontrolką serwera i wszystkimi jej kontrolkami podrzędnymi.

(Odziedziczone po Control)
DataBind(Boolean)

Wiąże źródło danych z wywołaną kontrolką serwera i wszystkie jego kontrolki podrzędne z opcją wywołania DataBinding zdarzenia.

(Odziedziczone po Control)
DataBindChildren()

Wiąże źródło danych z kontrolkami podrzędnymi kontrolki serwera.

(Odziedziczone po Control)
Dispose()

Umożliwia kontroli serwera przeprowadzenie końcowego czyszczenia przed zwolnieniem z pamięci.

(Odziedziczone po Control)
EndRenderTracing(TextWriter, Object)

Kończy śledzenie danych renderowania w czasie projektowania.

(Odziedziczone po Control)
EnsureChildControls()

Określa, czy kontrolka serwera zawiera kontrolki podrzędne. Jeśli tak nie jest, tworzy kontrolki podrzędne.

(Odziedziczone po Control)
EnsureID()

Tworzy identyfikator kontrolek, które nie mają przypisanego identyfikatora.

(Odziedziczone po Control)
Equals(Object)

Określa, czy dany obiekt jest taki sam, jak bieżący obiekt.

(Odziedziczone po Object)
FindControl(String)

Wyszukuje bieżący kontener nazewnictwa dla kontrolki serwera przy użyciu określonego id parametru.

(Odziedziczone po Control)
FindControl(String, Int32)

Wyszukuje bieżący kontener nazewnictwa dla kontrolki serwera z określoną liczbą id całkowitą określoną w parametrze pathOffset , która ułatwia wyszukiwanie. Nie należy zastępować tej wersji FindControl metody .

(Odziedziczone po Control)
Focus()

Ustawia fokus danych wejściowych na kontrolkę.

(Odziedziczone po Control)
GetCurrent(Page)

ScriptManager Pobiera wystąpienie dla danego Page obiektu.

GetDesignModeState()

Pobiera dane czasu projektowania dla kontrolki.

(Odziedziczone po Control)
GetHashCode()

Służy jako domyślna funkcja skrótu.

(Odziedziczone po Object)
GetRegisteredArrayDeclarations()

Pobiera kolekcję tablicy ECMAScript (JavaScript) tylko do odczytu, która została wcześniej zarejestrowana w Page obiekcie.

GetRegisteredClientScriptBlocks()

Pobiera kolekcję bloków skryptów klienta tylko do odczytu, które zostały wcześniej zarejestrowane w kontrolce ScriptManager .

GetRegisteredDisposeScripts()

Pobiera kolekcję dispose skryptów tylko do odczytu, które zostały wcześniej zarejestrowane w Page obiekcie.

GetRegisteredExpandoAttributes()

Pobiera kolekcję atrybutów niestandardowych (expando) tylko do odczytu, które zostały wcześniej zarejestrowane w Page obiekcie.

GetRegisteredHiddenFields()

Pobiera kolekcję pól ukrytych, które zostały wcześniej zarejestrowane w Page obiekcie tylko do odczytu.

GetRegisteredOnSubmitStatements()

Pobiera kolekcję instrukcji onsubmit tylko do odczytu, które zostały wcześniej zarejestrowane w Page obiekcie.

GetRegisteredStartupScripts()

Pobiera kolekcję skryptów uruchamiania tylko do odczytu, które zostały wcześniej zarejestrowane w Page obiekcie.

GetRouteUrl(Object)

Pobiera adres URL odpowiadający zestawowi parametrów trasy.

(Odziedziczone po Control)
GetRouteUrl(RouteValueDictionary)

Pobiera adres URL odpowiadający zestawowi parametrów trasy.

(Odziedziczone po Control)
GetRouteUrl(String, Object)

Pobiera adres URL odpowiadający zestawowi parametrów trasy i nazwie trasy.

(Odziedziczone po Control)
GetRouteUrl(String, RouteValueDictionary)

Pobiera adres URL odpowiadający zestawowi parametrów trasy i nazwie trasy.

(Odziedziczone po Control)
GetStateString()

Pobiera ciąg zawierający pary klucz/wartość reprezentujące stan strony sieci Web.

GetType()

Type Pobiera wartość bieżącego wystąpienia.

(Odziedziczone po Object)
GetUniqueIDRelativeTo(Control)

Zwraca prefiksowaną część UniqueID właściwości określonej kontrolki.

(Odziedziczone po Control)
HasControls()

Określa, czy kontrolka serwera zawiera jakiekolwiek kontrolki podrzędne.

(Odziedziczone po Control)
HasEvents()

Zwraca wartość wskazującą, czy zdarzenia są zarejestrowane dla kontrolki, czy dla kontrolek podrzędnych.

(Odziedziczone po Control)
IsLiteralContent()

Określa, czy kontrolka serwera przechowuje tylko zawartość literału.

(Odziedziczone po Control)
LoadControlState(Object)

Przywraca informacje o stanie kontroli z poprzedniego żądania strony, które zostało zapisane przez metodę SaveControlState() .

(Odziedziczone po Control)
LoadPostData(String, NameValueCollection)

Odczytuje dane formularza publikowane z przeglądarki na serwerze i określa źródło asynchronicznego powrotu.

LoadViewState(Object)

Przywraca informacje o stanie widoku z poprzedniego żądania strony, które zostało zapisane przez metodę SaveViewState() .

(Odziedziczone po Control)
MapPathSecure(String)

Pobiera ścieżkę fizyczną, z którą mapuje się ścieżka wirtualna , bezwzględna lub względna.

(Odziedziczone po Control)
MemberwiseClone()

Tworzy płytkią kopię bieżącego Objectelementu .

(Odziedziczone po Object)
OnAsyncPostBackError(AsyncPostBackErrorEventArgs)

AsyncPostBackError Zgłasza zdarzenie.

OnBubbleEvent(Object, EventArgs)

Określa, czy zdarzenie kontroli serwera jest przekazywane w hierarchii kontroli serwera interfejsu użytkownika strony.

(Odziedziczone po Control)
OnDataBinding(EventArgs)

DataBinding Zgłasza zdarzenie.

(Odziedziczone po Control)
OnInit(EventArgs)

Zgłasza zdarzenie i upewnia Init się, że na stronie istnieje tylko jedna ScriptManager kontrolka.

OnLoad(EventArgs)

Load Zgłasza zdarzenie.

(Odziedziczone po Control)
OnPreRender(EventArgs)

PreRender Zgłasza zdarzenie i rejestruje pliki skryptów i usługi na potrzeby aktualizacji częściowych stron.

OnResolveCompositeScriptReference(CompositeScriptReferenceEventArgs)

ResolveCompositeScriptReference Zgłasza zdarzenie.

OnResolveScriptReference(ScriptReferenceEventArgs)

ResolveScriptReference Zgłasza zdarzenie dla każdego odwołania do skryptu zarządzanego przez kontrolkęScriptManager.

OnUnload(EventArgs)

Unload Zgłasza zdarzenie.

(Odziedziczone po Control)
OpenFile(String)

Pobiera element Stream używany do odczytywania pliku.

(Odziedziczone po Control)
RaiseBubbleEvent(Object, EventArgs)

Przypisuje wszystkie źródła zdarzenia i jego informacje do elementu nadrzędnego kontrolki.

(Odziedziczone po Control)
RaisePostBackEvent(String)

Przetwarza zdarzenie zwrotne zgłaszane przez kontrolkę ScriptManager i ładuje stan historii strony sieci Web.

RaisePostDataChangedEvent()

Zgłasza zdarzenia dla kontrolki po opublikowaniu ScriptManager jej z powrotem na serwerze.

RegisterArrayDeclaration(Control, String, String)

Rejestruje deklarację tablicy ECMAScript (JavaScript) z kontrolką do użycia z ScriptManager kontrolką, która znajduje się wewnątrz UpdatePanel kontrolki, i dodaje tablicę do strony.

RegisterArrayDeclaration(Page, String, String)

Rejestruje deklarację tablicy ECMAScript (JavaScript) z kontrolką do użycia z ScriptManager kontrolką, która znajduje się wewnątrz UpdatePanel kontrolki, i dodaje tablicę do strony.

RegisterAsyncPostBackControl(Control)

Rejestruje kontrolkę jako wyzwalacz asynchronicznych poświadczeń zwrotnych.

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

Rejestruje blok skryptu klienta z kontrolką do użycia z ScriptManager kontrolką, która znajduje się wewnątrz UpdatePanel kontrolki, a następnie dodaje blok skryptu do strony.

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

Rejestruje blok skryptu klienta z kontrolką do użycia z ScriptManager kontrolką, która znajduje się wewnątrz UpdatePanel kontrolki, a następnie dodaje blok skryptu do strony.

RegisterClientScriptInclude(Control, Type, String, String)

Rejestruje plik skryptu klienta z kontrolką do użycia z ScriptManager kontrolką, która znajduje się wewnątrz UpdatePanel kontrolki, a następnie dodaje odwołanie do pliku skryptu do strony.

RegisterClientScriptInclude(Page, Type, String, String)

Rejestruje skrypt klienta z kontrolką ScriptManager za każdym razem, gdy następuje asynchroniczne wycofanie, a następnie dodaje odwołanie do pliku skryptu do strony.

RegisterClientScriptResource(Control, Type, String)

Rejestruje skrypt klienta osadzony w zestawie z kontrolką do użycia z ScriptManager kontrolką, która uczestniczy w renderowaniu częściowym strony.

RegisterClientScriptResource(Page, Type, String)

Rejestruje plik skryptu klienta osadzony w zestawie z kontrolką ScriptManager za każdym razem, gdy nastąpi powrót.

RegisterDataItem(Control, String)

Wysyła dane niestandardowe do kontrolki podczas renderowania częściowego strony.

RegisterDataItem(Control, String, Boolean)

Wysyła dane niestandardowe do kontrolki podczas renderowania częściowego strony i wskazuje, czy dane są w formacie JavaScript Object Notation (JSON).

RegisterDispose(Control, String)

Rejestruje dispose skrypt kontrolki, która znajduje się wewnątrz kontrolki UpdatePanel . Skrypt jest wykonywany po zaktualizowaniu lub usunięciu UpdatePanel kontrolki.

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

Rejestruje parę nazw/wartości z kontrolką ScriptManager jako atrybut niestandardowy (expando) określonej kontrolki.

RegisterExtenderControl<TExtenderControl>(TExtenderControl, Control)

Rejestruje kontrolkę rozszerzenia przy użyciu bieżącego ScriptManager wystąpienia.

RegisterHiddenField(Control, String, String)

Rejestruje ukryte pole z ScriptManager kontrolką kontrolki, która znajduje się wewnątrz kontrolki UpdatePanel .

RegisterHiddenField(Page, String, String)

Rejestruje ukryte pole z kontrolką podczas każdego asynchronicznego powrotu ScriptManager .

RegisterNamedClientScriptResource(Control, String)

Rejestruje skrypt klienta według nazwy zasobu osadzonej w zestawie z kontrolką do użycia z ScriptManager kontrolką, która uczestniczy w renderowaniu częściowej strony.

RegisterNamedClientScriptResource(Page, String)

Rejestruje skrypt klienta według nazwy zasobu osadzonej w zestawie z kontrolką do użycia z ScriptManager kontrolką, która uczestniczy w renderowaniu częściowej strony.

RegisterOnSubmitStatement(Control, Type, String, String)

Rejestruje kod ECMAScript (JavaScript) z ScriptManager kontrolką dla kontrolki, która jest używana z kontrolką wykonywaną UpdatePanel po przesłaniu formularza.

RegisterOnSubmitStatement(Page, Type, String, String)

Rejestruje kod ECMAScript (JavaScript) z ScriptManager kontrolką dla kontrolki, która jest używana z kontrolką wykonywaną UpdatePanel po przesłaniu formularza.

RegisterPostBackControl(Control)

Rejestruje kontrolkę jako wyzwalacz powrotu po awarii. Ta metoda służy do konfigurowania kontrolek po powrocie zwrotnym UpdatePanel wewnątrz kontrolki, która w przeciwnym razie będzie wykonywać asynchroniczne wycofywania.

RegisterScriptControl<TScriptControl>(TScriptControl)

Rejestruje kontrolkę skryptu przy użyciu bieżącego ScriptManager wystąpienia.

RegisterScriptDescriptors(IExtenderControl)

Wywołuje klasę ExtenderControl w celu zwrócenia skryptów wystąpień, które muszą być renderowane w celu obsługi obiektu klienta reprezentującego kontrolkę klienta, składnik lub zachowanie.

RegisterScriptDescriptors(IScriptControl)

Wywołuje klasę ScriptControl w celu zwrócenia skryptów wystąpień, które muszą być renderowane w celu obsługi obiektu klienta reprezentującego kontrolę klienta, składnik lub zachowanie.

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

Rejestruje blok skryptu uruchamiania dla kontrolki, która znajduje się wewnątrz UpdatePanel kontrolki przy użyciu kontrolki ScriptManager , i dodaje blok skryptu do strony.

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

Rejestruje blok skryptu uruchamiania dla każdego asynchronicznego wycofywania za pomocą kontrolki ScriptManager i dodaje blok skryptu do strony.

RemovedControl(Control)

Wywoływane po usunięciu kontrolki podrzędnej z Controls kolekcji Control obiektu.

(Odziedziczone po Control)
Render(HtmlTextWriter)

Renderuje ScriptManager zawartość kontrolki w przeglądarce przy użyciu określonego HtmlTextWriter obiektu.

RenderChildren(HtmlTextWriter)

Wyprowadza zawartość elementów podrzędnych formantu serwera do dostarczonego HtmlTextWriter obiektu, który zapisuje zawartość do renderowania na kliencie.

(Odziedziczone po Control)
RenderControl(HtmlTextWriter)

Dane wyjściowe serwera steruje zawartością dostarczonego HtmlTextWriter obiektu i przechowuje informacje śledzenia dotyczące kontrolki, jeśli śledzenie jest włączone.

(Odziedziczone po Control)
RenderControl(HtmlTextWriter, ControlAdapter)

Dane wyjściowe serwera steruje zawartością dostarczonego HtmlTextWriter obiektu przy użyciu dostarczonego ControlAdapter obiektu.

(Odziedziczone po Control)
ResolveAdapter()

Pobiera kartę sterową odpowiedzialną za renderowanie określonej kontrolki.

(Odziedziczone po Control)
ResolveClientUrl(String)

Pobiera adres URL, który może być używany przez przeglądarkę.

(Odziedziczone po Control)
ResolveUrl(String)

Konwertuje adres URL na adres, który może być używany przez klienta żądającego.

(Odziedziczone po Control)
SaveControlState()

Zapisuje wszelkie zmiany stanu kontroli serwera, które wystąpiły od czasu opublikowania strony z powrotem na serwerze.

(Odziedziczone po Control)
SaveViewState()

Zapisuje wszelkie zmiany stanu widoku kontroli serwera, które wystąpiły od czasu opublikowania strony z powrotem na serwerze.

(Odziedziczone po Control)
SetDesignModeState(IDictionary)

Ustawia dane czasu projektowania dla kontrolki.

(Odziedziczone po Control)
SetFocus(Control)

Ustawia fokus przeglądarki na określoną kontrolkę.

SetFocus(String)

Ustawia fokus przeglądarki na kontrolkę określoną przez identyfikator.

SetRenderMethodDelegate(RenderMethod)

Przypisuje delegata programu obsługi zdarzeń w celu renderowania kontrolki serwera i jego zawartości do kontrolki nadrzędnej.

(Odziedziczone po Control)
SetTraceData(Object, Object)

Ustawia dane śledzenia dla śledzenia czasu projektowania danych renderowania przy użyciu klucza danych śledzenia i wartości danych śledzenia.

(Odziedziczone po Control)
SetTraceData(Object, Object, Object)

Ustawia dane śledzenia dla śledzenia czasu projektowania danych renderowania przy użyciu obiektu śledzonego, klucza danych śledzenia i wartości danych śledzenia.

(Odziedziczone po Control)
ToString()

Zwraca ciąg reprezentujący bieżący obiekt.

(Odziedziczone po Object)
TrackViewState()

Powoduje śledzenie zmian stanu widoku w kontrolce serwera, dzięki czemu mogą być przechowywane w obiekcie kontroli StateBag serwera. Ten obiekt jest dostępny za pośrednictwem ViewState właściwości .

(Odziedziczone po Control)

Zdarzenia

AsyncPostBackError

Występuje, gdy występuje błąd strony podczas asynchronicznego powrotu.

DataBinding

Występuje, gdy kontrolka serwera wiąże się ze źródłem danych.

(Odziedziczone po Control)
Disposed

Występuje, gdy kontrolka serwera jest zwalniana z pamięci, która jest ostatnim etapem cyklu życia kontroli serwera po zażądaniu strony ASP.NET.

(Odziedziczone po Control)
Init

Występuje, gdy kontrolka serwera jest inicjowana, co jest pierwszym krokiem w jego cyklu życia.

(Odziedziczone po Control)
Load

Występuje, gdy kontrolka serwera jest ładowana do Page obiektu.

(Odziedziczone po Control)
Navigate

Występuje, gdy użytkownik kliknie przycisk Wstecz lub Prześlij dalej przeglądarki.

PreRender

Występuje po załadowaniu Control obiektu, ale przed renderowaniem.

(Odziedziczone po Control)
ResolveCompositeScriptReference

Występuje, gdy skrypt złożony jest zarejestrowany w kontrolce ScriptManager .

ResolveScriptReference

Występuje, gdy element członkowski Scripts kolekcji jest zarejestrowany w kontrolce ScriptManager .

Unload

Występuje, gdy kontrolka serwera jest zwalniana z pamięci.

(Odziedziczone po Control)

Jawne implementacje interfejsu

IControlBuilderAccessor.ControlBuilder

Aby uzyskać opis tego elementu członkowskiego, zobacz ControlBuilder.

(Odziedziczone po Control)
IControlDesignerAccessor.GetDesignModeState()

Aby uzyskać opis tego elementu członkowskiego, zobacz GetDesignModeState().

(Odziedziczone po Control)
IControlDesignerAccessor.SetDesignModeState(IDictionary)

Aby uzyskać opis tego elementu członkowskiego, zobacz SetDesignModeState(IDictionary).

(Odziedziczone po Control)
IControlDesignerAccessor.SetOwnerControl(Control)

Aby uzyskać opis tego elementu członkowskiego, zobacz SetOwnerControl(Control).

(Odziedziczone po Control)
IControlDesignerAccessor.UserData

Aby uzyskać opis tego elementu członkowskiego, zobacz UserData.

(Odziedziczone po Control)
IDataBindingsAccessor.DataBindings

Aby uzyskać opis tego elementu członkowskiego, zobacz DataBindings.

(Odziedziczone po Control)
IDataBindingsAccessor.HasDataBindings

Aby uzyskać opis tego elementu członkowskiego, zobacz HasDataBindings.

(Odziedziczone po Control)
IExpressionsAccessor.Expressions

Aby uzyskać opis tego elementu członkowskiego, zobacz Expressions.

(Odziedziczone po Control)
IExpressionsAccessor.HasExpressions

Aby uzyskać opis tego elementu członkowskiego, zobacz HasExpressions.

(Odziedziczone po Control)
IParserAccessor.AddParsedSubObject(Object)

Aby uzyskać opis tego elementu członkowskiego, zobacz AddParsedSubObject(Object).

(Odziedziczone po Control)
IPostBackDataHandler.LoadPostData(String, NameValueCollection)

Aby uzyskać opis tego elementu członkowskiego, zobacz LoadPostData(String, NameValueCollection).

IPostBackDataHandler.RaisePostDataChangedEvent()

Aby uzyskać opis tego elementu członkowskiego, zobacz RaisePostDataChangedEvent().

IPostBackEventHandler.RaisePostBackEvent(String)

Umożliwia sterowanie przetwarzaniem zdarzenia po powrocie ScriptManager zwrotnym i ładowaniem stanu historii strony sieci Web.

Metody rozszerzania

FindDataSourceControl(Control)

Zwraca źródło danych skojarzone z kontrolką danych dla określonej kontrolki.

FindFieldTemplate(Control, String)

Zwraca szablon pola dla określonej kolumny w kontenerze nazewnictwa określonej kontrolki.

FindMetaTable(Control)

Zwraca obiekt metatable dla kontrolki zawierającej dane.

Dotyczy

Zobacz też