ScriptManager Klasse

Definition

Namespace:: System.Web.UI

Assembly:: System.Web.Extensions.dll

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

Verwaltet ASP.NET Ajax-Skriptbibliotheken und Skriptdateien, partielles Rendern von Seiten und Clientproxyklassen für Webdienste.

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

Vererbung: Object

Control
ScriptManager

Attribute: ToolboxBitmapAttribute

Implementiert: IPostBackDataHandler IPostBackEventHandler

Beispiele

Die folgenden Beispiele zeigen verschiedene Szenarien für die Verwendung des Steuerelements ScriptManager .

Aktivieren von Partial-Page Updates

Das folgende Beispiel zeigt, wie Sie das ScriptManager Steuerelement verwenden, um Teilseitenaktualisierungen zu aktivieren. In diesem Beispiel befindet sich ein Calendar Steuerelement und ein DropDownList Steuerelement innerhalb eines Steuerelements UpdatePanel . Standardmäßig ist Alwaysder Wert der UpdateMode Eigenschaft , und der Wert der ChildrenAsTriggers Eigenschaft ist true. Daher verursachen untergeordnete Steuerelemente des Panels ein asynchrones 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>

Behandeln von Partial-Page Aktualisierungsfehlern und Registrieren von Skripts

Das folgende Beispiel zeigt, wie Sie während teilweisen Seitenaktualisierungen eine benutzerdefinierte Fehlerbehandlung bereitstellen. Wenn während partieller Seitenaktualisierungen ein Fehler auftritt, wird standardmäßig ein JavaScript-Meldungsfeld angezeigt. In diesem Beispiel wird veranschaulicht, wie Sie die benutzerdefinierte Fehlerbehandlung verwenden, indem Sie einen Handler für das AsyncPostBackError Ereignis bereitstellen und die AsyncPostBackErrorMessage Eigenschaft im Ereignishandler festlegen. Sie können die AllowCustomErrorsRedirect Eigenschaft auch festlegen, um anzugeben, wie der Abschnitt mit benutzerdefinierten Fehlern der Web.config Datei verwendet wird, wenn während partieller Seitenaktualisierungen ein Fehler auftritt. In diesem Beispiel wird der Standardwert der AllowCustomErrorsRedirect Eigenschaft verwendet. Dies bedeutet, dass dieses Element bestimmt, wie Fehler angezeigt werden, wenn die Web.config Datei ein customErrors-Element enthält. Weitere Informationen finden Sie unter 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>

Globalisieren des im Browser angezeigten Datums- und Uhrzeitdatums

Im folgenden Beispiel wird gezeigt, wie die EnableScriptGlobalization Eigenschaft so festgelegt wird, dass clientskripts ein kulturspezifisches Datum und eine kulturspezifische Uhrzeit im Browser anzeigen können. Im Beispiel wird das Culture Attribut der @Page-Direktive auf auto. Daher bestimmt die erste Sprache, die in den aktuellen Browsereinstellungen angegeben ist, die Kultur und UI-Kultur für die Seite. Weitere Informationen finden Sie unter 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>

Hinweise

In diesem Thema:

Introduction
Partial-Page Rendering
Verwenden des ScriptManager-Steuerelements mit Gestaltungsvorlagen, Benutzersteuerelementen und anderen untergeordneten Komponenten
Skriptverwaltung und -registrierung
Webdienstverweise
Lokalisierung
Fehlerbehandlung
Deklarative Syntax

Einführung

Das ScriptManager Steuerelement ist für Ajax-Funktionen in ASP.NET zentral. Das Steuerelement verwaltet alle ASP.NET Ajax-Ressourcen auf einer Seite. Dies schließt das Herunterladen von Microsoft Ajax Library-Skripts in den Browser ein und koordiniert Partielle Seitenupdates, die mithilfe UpdatePanel von Steuerelementen aktiviert werden. Darüber hinaus können Sie mit dem ScriptManager Steuerelement Folgendes ausführen:

Registrieren Sie skripts, das mit Partiellen Seitenaktualisierungen kompatibel ist. Um Abhängigkeiten zwischen Ihrem Skript und der Kernbibliothek zu verwalten, wird jedes Skript, das Sie registrieren, nach dem Microsoft Ajax Library-Skript geladen.
Geben Sie an, ob Release- oder Debugskripts an den Browser gesendet werden.
Ermöglichen Sie den Zugriff auf Webdienstmethoden aus skripts, indem Sie Webdienste beim ScriptManager Steuerelement registrieren.
Ermöglichen Sie den Zugriff auf ASP.NET Authentifizierungs-, Rollen- und Profilanwendungsdienste über das Clientskript, indem Sie diese Dienste mit dem ScriptManager Steuerelement registrieren.
Aktivieren Sie kulturspezifische Anzeige von ECMAScript-Funktionen (JavaScript) Datum, Zahl und Zeichenfolge im Browser.
Greifen Sie mithilfe der ResourceUICultures Eigenschaft des ScriptReference Steuerelements auf Lokalisierungsressourcen für eingebettete Skriptdateien oder eigenständige Skriptdateien zu.
Registrieren Sie Serversteuerelemente, die die IExtenderControl Steuerelemente oder IScriptControl Schnittstellen mit dem ScriptManager Steuerelement implementieren, sodass Skripts, die von Clientkomponenten und -verhalten benötigt werden, gerendert werden.

Partial-Page Rendering

Die Möglichkeit einer ASP.NET Seite zur Unterstützung des Teilweisen Seitenrenderings wird durch die folgenden Faktoren gesteuert:

Die ScriptManager Eigenschaft des Steuerelements EnablePartialRendering muss (der Standardwert) sein true .
Es muss mindestens ein UpdatePanel Steuerelement auf der Seite vorhanden sein.
Die SupportsPartialRendering Eigenschaft muss (der Standardwert) sein true . Wenn die SupportsPartialRendering Eigenschaft nicht explizit festgelegt wird, basiert ihr Wert auf Browserfunktionen.

Sie können den Wert der Eigenschaft zur Laufzeit während oder vor dem Ereignis der EnablePartialRendering Seite Init überschreiben. Wenn Sie versuchen, diese Eigenschaft zu ändern, nachdem das Ereignis der Seite Init aufgetreten ist, wird eine InvalidOperationException Ausnahme ausgelöst.

Wenn partielles Seitenrendering unterstützt wird, rendert das ScriptManager Steuerelement Skript, um asynchrone Postbacks und Partielle Seitenaktualisierungen zu aktivieren. Die Zu aktualisierenden Bereiche der Seite werden mithilfe UpdatePanel von Steuerelementen festgelegt. Das ScriptManager Steuerelement behandelt die asynchronen Postbacks und aktualisiert nur die Bereiche der Seite, die aktualisiert werden müssen. Weitere Informationen zum Rendern teilweiser Seiten finden Sie unter Partial-Page Rendering Overview. Weitere Informationen zu den Bedingungen, die zu einem Update führen, finden Sie unter UpdatePanel Control Overview.

Verwenden des ScriptManager-Steuerelements mit Gestaltungsvorlagen, Benutzersteuerelementen und anderen untergeordneten Komponenten

Eine Seite kann nur ein ScriptManager Steuerelement in der Hierarchie enthalten. Verwenden Sie das ScriptManagerProxy Steuerelement, um Dienste und Skripts für geschachtelte Seiten, Benutzersteuerelemente oder Komponenten zu registrieren, wenn die übergeordnete Seite bereits über ein ScriptManager Steuerelement verfügt. Weitere Informationen finden Sie unter Verwenden des UpdatePanel-Steuerelements mit Gestaltungsvorlagen.

Skriptverwaltung und -registrierung

Mit dem ScriptManager Steuerelement können Sie Skripts registrieren, die dann als Teil der Seite gerendert werden. Die ScriptManager Kontrollregistrierungsmethoden können in die folgenden drei Kategorien unterteilt werden:

Registrierungsmethoden, die garantieren, dass Skriptabhängigkeiten von der Microsoft Ajax-Bibliothek verwaltet werden.
Registrierungsmethoden, die nicht von der Microsoft Ajax-Bibliothek abhängig sind, aber mit UpdatePanel Steuerelementen kompatibel sind.
Registrierungsmethoden, die das Arbeiten mit UpdatePanel Steuerelementen unterstützen.

Weitere Informationen zum Erstellen und Verwenden des Ajax-Skripts in ASP.NET finden Sie unter Erstellen von benutzerdefiniertem Clientskript mithilfe der Microsoft Ajax-Bibliothek.

Registrieren von Skripts, die von der Microsoft Ajax-Bibliothek abhängig sind

Sie können die folgenden Methoden verwenden, um Skriptdateien auf eine Weise zu registrieren, die garantiert, dass alle Abhängigkeiten von der Microsoft Ajax-Bibliothek verwaltet werden.

Methode	Definition
RegisterScriptControl	Registriert ein Serversteuerelement, das die IScriptControl Schnittstelle implementiert, die zum Definieren eines Sys.Component-Clientobjekts verwendet wird. Das ScriptManager Steuerelement rendert Skript, das das Clientobjekt unterstützt.
RegisterExtenderControl	Registriert ein Serversteuerelement, das die IExtenderControl Schnittstelle implementiert, die zum Definieren eines Sys.Component-Clientobjekts verwendet wird. Das ScriptManager Steuerelement rendert Skript, das das Clientobjekt unterstützt.

Registrieren von Partial-Page kompatiblen Skripts

Mit den folgenden Methoden können Sie Skriptdateien registrieren, die nicht von der Microsoft Ajax-Bibliothek abhängig sind, aber mit UpdatePanel Steuerelementen kompatibel sind. Diese Methoden entsprechen ähnlichen Methoden des ClientScriptManager Steuerelements. Wenn Sie skripts für die Verwendung innerhalb eines UpdatePanel Steuerelements rendern, stellen Sie sicher, dass Sie die Methoden des ScriptManager Steuerelements aufrufen.

Methode	Definition
RegisterArrayDeclaration	Fügt einem JavaScript-Array einen Wert hinzu. Wenn das Array nicht vorhanden ist, wird es erstellt.
RegisterClientScriptBlock	Rendert ein `script` Element nach dem Öffnentag `<form>` der Seite. Das Skript wird als Zeichenfolgenparameter angegeben.
RegisterClientScriptInclude	Rendert ein `script` Element nach dem Öffnentag `<form>` der Seite. Der Skriptinhalt wird durch Festlegen des `src` Attributs auf eine URL angegeben, die auf eine Skriptdatei verweist.
RegisterClientScriptResource	Rendert ein `script` Element nach dem Öffnentag `<form>` der Seite. Der Skriptinhalt wird mit einem Ressourcennamen in einer Assembly angegeben. Das `src` Attribut wird automatisch mit einer URL durch einen Aufruf eines HTTP-Handlers aufgefüllt, der das benannte Skript aus der Assembly abruft.
RegisterExpandoAttribute	Rendert ein benutzerdefiniertes Name/Wert-Attributpaar (ein expando) im Markup für ein angegebenes Steuerelement.
RegisterHiddenField	Rendert ein ausgeblendetes Feld.
RegisterOnSubmitStatement	Registriert ein Skript, das als Reaktion auf das Ereignis des `formsubmit` Elements ausgeführt wird. Das `onSubmit` Attribut verweist auf das angegebene Skript.
RegisterStartupScript	Rendert einen Startskriptblock direkt vor dem schließenden `</form>` Tag der Seite. Das zu rendernde Skript wird als Zeichenfolgenparameter angegeben.

Wenn Sie Methoden registrieren, geben Sie ein Typ-/Schlüsselpaar für dieses Skript an. Wenn bereits ein Skript mit demselben Typ/Schlüsselpaar registriert ist, wird kein neues Skript registriert. Wenn Sie ein Skript mit einem bereits vorhandenen Typ-/Ressourcennamen-Paar registrieren, wird das script Element, das auf die Ressource verweist, nicht erneut hinzugefügt. Wenn Sie ein Expando-Attribut eines zuvor registrierten Attributs registrieren, wird eine Ausnahme ausgelöst. Die doppelte Registrierung von Arraywerten ist zulässig.

Wenn Sie die Methode oder die RegisterClientScriptInclude RegisterClientScriptResource Methode aufrufen, vermeiden Sie das Registrieren von Skripts, das Inlinefunktionen ausführt. Registrieren Sie stattdessen Skripts, die Funktionsdefinitionen wie Ereignishandler oder benutzerdefinierte Klassendefinitionen für Ihre Anwendung enthalten.

Registrierungsmethoden für UpdatePanel-Steuerelemente

Sie können die folgenden Methoden verwenden, um Teilseitenaktualisierungen anzupassen, wenn Sie Steuerelemente verwenden UpdatePanel .

Methode	Definition
RegisterAsyncPostBackControl	Registriert ein Steuerelement als Trigger für asynchrone Postbacks.
RegisterDataItem	Sendet benutzerdefinierte Daten an Steuerelemente während des teilweisen Seitenrenderings.
RegisterDispose	Registriert ein Dispose-Skript für ein Steuerelement, das sich innerhalb eines UpdatePanel Steuerelements befindet. Das Skript wird ausgeführt, wenn das UpdatePanel Steuerelement aktualisiert oder gelöscht wird. Die Dispose-Methode wird für Clientkomponenten verwendet, die Teil der Microsoft Ajax-Bibliothek sind und Ressourcen freigeben müssen, wenn eine Komponente nicht mehr verwendet wird.
RegisterPostBackControl	Registriert ein Steuerelement als Trigger für einen vollständigen Postback. Diese Methode wird für Steuerelemente innerhalb eines UpdatePanel Steuerelements verwendet, die andernfalls asynchrone Postbacks ausführen würden.

Webdienstverweise

Sie können einen Webdienst registrieren, der vom Clientskript aufgerufen werden soll, indem Sie ein ServiceReference Objekt erstellen und der Services Auflistung des ScriptManager Steuerelements hinzufügen. ASP.NET generiert ein Clientproxyobjekt für jedes ServiceReference Objekt in der Services Auflistung. Sie können der Services Auflistung programmgesteuert Objekte hinzufügenServiceReference, um Webdienste zur Laufzeit zu registrieren.

Weitere Informationen zum Zugreifen auf Webdienste im Skript finden Sie unter Verfügbarmachen von Webdiensten für Clientskripts in ASP.NET AJAX und Aufrufen von Webdiensten von Clientskript in ASP.NET AJAX.

Localization

Das ScriptManager Steuerelement generiert Verweise auf der gerenderten Seite, die auf die entsprechenden lokalisierten Skriptdateien verweisen, die entweder in Assemblys oder eigenständige Skriptdateien eingebettet sind.

Wenn die EnableScriptLocalization Eigenschaft auf true festgelegt ist, ruft das ScriptManager Steuerelement lokalisierte Ressourcen (z. B. lokalisierte Zeichenfolgen) für die aktuelle Kultur ab, sofern vorhanden. Das ScriptManager Steuerelement bietet die folgenden Funktionen für die Verwendung lokalisierter Ressourcen:

Skriptdateien, die in eine Assembly eingebettet sind. Das ScriptManager Steuerelement bestimmt, welche kulturspezifische oder fallback-culture-Skriptdatei an den Browser gesendet werden soll. Dazu werden das kulturspezifische NeutralResourcesLanguageAttribute Assembly-Attribut, die mit der Assembly verpackten Ressourcen und die Benutzeroberflächenkultur des Browsers (falls vorhanden) verwendet.
Eigenständige Skriptdateien. Das ScriptManager Steuerelement definiert die Liste der Benutzeroberflächenkulturen, die mithilfe der ResourceUICultures Eigenschaft des ScriptReference Objekts unterstützt werden.
Im Debugmodus. Das ScriptManager Steuerelement versucht, eine kulturspezifische Skriptdatei zu rendern, die Debuginformationen enthält. Wenn sich die Seite beispielsweise im Debugmodus befindet und die aktuelle Kultur auf en-MXfestgelegt ist, rendert das Steuerelement eine Skriptdatei mit einem Namen wie scriptname.en-MX.debug.js, wenn die Datei vorhanden ist. Wenn die Datei nicht vorhanden ist, wird die Debugdatei für die entsprechende Fallbackkultur gerendert.

Weitere Informationen zum Lokalisieren von Ressourcen finden Sie unter "Lokalisieren von Ressourcen für Komponentenbibliotheken" (Übersicht).

Fehlerbehandlung

Wenn während asynchroner Postbacks ein Seitenfehler auftritt, wird das AsyncPostBackError Ereignis ausgelöst. Die Art und Weise, in der Fehler auf dem Server an den Client gesendet werden, hängt von der AllowCustomErrorsRedirect Eigenschaft, der AsyncPostBackErrorMessage Eigenschaft und dem Abschnitt mit benutzerdefinierten Fehlern der Web.config Datei ab. Weitere Informationen finden Sie unter Anpassen der Fehlerbehandlung für UpdatePanel-Steuerelemente.

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

Konstruktoren

Name	Beschreibung
ScriptManager()	Initialisiert eine neue Instanz der ScriptManager-Klasse.

Eigenschaften

Name	Beschreibung
Adapter	Ruft den browserspezifischen Adapter für das Steuerelement ab. (Geerbt von Control)
AjaxFrameworkAssembly	Ruft die Ajax-Frameworkassembly ab, die Komponenten auf der Seite verwenden.
AjaxFrameworkMode	Dient zum Abrufen oder Festlegen eines Werts, der angibt, wie Clientskripts der Microsoft Ajax-Clientbibliothek auf dem Client eingeschlossen werden.
AllowCustomErrorsRedirect	Dient zum Abrufen oder Festlegen eines Werts, der bestimmt, ob der Abschnitt mit benutzerdefinierten Fehlern der Web.config Datei während eines Fehlers in einem asynchronen Postback verwendet wird.
AppRelativeTemplateSourceDirectory	Dient zum Abrufen oder Festlegen des anwendungsrelativen virtuellen Verzeichnisses des Page Objekts UserControl , das dieses Steuerelement enthält. (Geerbt von Control)
AsyncPostBackErrorMessage	Ruft die Fehlermeldung ab, die an den Client gesendet wird, wenn während eines asynchronen Postbacks eine unbehandelte Server-Ausnahme auftritt, oder legt diese fest.
AsyncPostBackSourceElementID	Ruft die eindeutige ID des Steuerelements ab, das den asynchronen Postback verursacht hat.
AsyncPostBackTimeout	Dient zum Abrufen oder Festlegen eines Werts, der die Zeit in Sekunden angibt, bevor asynchrone Postbacks timeouts, wenn keine Antwort empfangen wird.
AuthenticationService	Ruft das AuthenticationServiceManager Objekt ab, das der aktuellen ScriptManager Instanz zugeordnet ist.
BindingContainer	Ruft das Steuerelement ab, das die Datenbindung dieses Steuerelements enthält. (Geerbt von Control)
ChildControlsCreated	Ruft einen Wert ab, der angibt, ob die untergeordneten Steuerelemente des Serversteuerelements erstellt wurden. (Geerbt von Control)
ClientID	Ruft die Steuerelement-ID für HTML-Markup ab, das von ASP.NET generiert wird. (Geerbt von Control)
ClientIDMode	Dient zum Abrufen oder Festlegen des Algorithmus, der zum Generieren des Werts der ClientID Eigenschaft verwendet wird. (Geerbt von Control)
ClientIDSeparator	Ruft einen Zeichenwert ab, der das Trennzeichen darstellt, das in der ClientID Eigenschaft verwendet wird. (Geerbt von Control)
ClientNavigateHandler	Dient zum Abrufen oder Festlegen des Namens der Methode, die das Sys.Application.navigate -Ereignis auf dem Client behandelt.
CompositeScript	Ruft einen Verweis auf das zusammengesetzte Skript ab, das die Webseite unterstützt.
Context	Ruft das Objekt ab, das HttpContext dem Serversteuerelement für die aktuelle Webanforderung zugeordnet ist. (Geerbt von Control)
Controls	Ruft ein ControlCollection Objekt ab, das die untergeordneten Steuerelemente für ein angegebenes Serversteuerelement in der Ui-Hierarchie darstellt. (Geerbt von Control)
DataItemContainer	Ruft einen Verweis auf den Benennungscontainer ab, wenn der Benennungscontainer IDataItemContainerimplementiert wird. (Geerbt von Control)
DataKeysContainer	Ruft einen Verweis auf den Benennungscontainer ab, wenn der Benennungscontainer IDataKeysControlimplementiert wird. (Geerbt von Control)
DesignMode	Ruft einen Wert ab, der angibt, ob ein Steuerelement auf einer Entwurfsoberfläche verwendet wird. (Geerbt von Control)
EmptyPageUrl	Dient zum Abrufen oder Festlegen einer URL auf eine leere Webseite.
EnableCdn	Bestimmt, ob die aktuelle Seite Clientskriptverweise aus CDN-Pfaden (Content Delivery Network) lädt.
EnableCdnFallback	Ermöglicht die lokale Kopie eines Skripts, das geladen werden kann, wenn das CDN (Content Delivery Network) nicht verfügbar ist.
EnableHistory	Dient zum Abrufen oder Festlegen eines Werts, der angibt, ob die Webseite die Verlaufspunktverwaltung unterstützt.
EnablePageMethods	Dient zum Abrufen oder Festlegen eines Werts, der angibt, ob öffentliche statische Seitenmethoden in einer ASP.NET-Seite vom Clientskript aufgerufen werden können.
EnablePartialRendering	Dient zum Abrufen oder Festlegen eines Werts, der das teilweise Rendern einer Seite ermöglicht, wodurch Sie wiederum Bereiche der Seite einzeln mithilfe UpdatePanel von Steuerelementen aktualisieren können.
EnableScriptGlobalization	Dient zum Abrufen oder Festlegen eines Werts, der angibt, ob das ScriptManager Steuerelement Skript rendert, das die Analyse und Formatierung von kulturspezifischen Informationen unterstützt.
EnableScriptLocalization	Dient zum Abrufen oder Festlegen eines Werts, der angibt, ob das ScriptManager Steuerelement lokalisierte Versionen von Skriptdateien rendert.
EnableSecureHistoryState	Dient zum Abrufen oder Festlegen eines Werts, der angibt, ob die Verlaufszustandszeichenfolge verschlüsselt werden soll.
EnableTheming	Dient zum Abrufen oder Festlegen eines Werts, der angibt, ob Designs für dieses Steuerelement gelten. (Geerbt von Control)
EnableViewState	Dient zum Abrufen oder Festlegen eines Werts, der angibt, ob das Serversteuerelement den Ansichtszustand und den Ansichtszustand aller enthaltenen untergeordneten Steuerelemente für den anfordernden Client behält. (Geerbt von Control)
Events	Ruft eine Liste von Ereignishandlerdelegatten für das Steuerelement ab. Diese Eigenschaft ist schreibgeschützt. (Geerbt von Control)
HasChildViewState	Ruft einen Wert ab, der angibt, ob die untergeordneten Steuerelemente des aktuellen Serversteuerelements über gespeicherte Ansichtszustandseinstellungen verfügen. (Geerbt von Control)
ID	Ruft den programmgesteuerten Bezeichner ab, der dem Serversteuerelement zugewiesen ist, oder legt diesen fest. (Geerbt von Control)
IdSeparator	Ruft das Zeichen ab, das zum Trennen von Steuerelementbezeichnern verwendet wird. (Geerbt von Control)
IsChildControlStateCleared	Ruft einen Wert ab, der angibt, ob In diesem Steuerelement enthaltene Steuerelemente den Steuerelementstatus aufweisen. (Geerbt von Control)
IsDebuggingEnabled	Ruft einen Wert ab, der angibt, ob die Debugversionen von Clientskriptbibliotheken gerendert werden.
IsInAsyncPostBack	Ruft einen Wert ab, der angibt, ob der aktuelle Postback im Teilweisen Renderingmodus ausgeführt wird.
IsNavigating	Ruft einen Wert ab, der angibt, ob ein Navigate Ereignis derzeit behandelt wird.
IsTrackingViewState	Ruft einen Wert ab, der angibt, ob das Serversteuerelement Änderungen am Ansichtszustand speichert. (Geerbt von Control)
IsViewStateEnabled	Ruft einen Wert ab, der angibt, ob der Ansichtszustand für dieses Steuerelement aktiviert ist. (Geerbt von Control)
LoadScriptsBeforeUI	Dient zum Abrufen oder Festlegen eines Werts, der angibt, ob Skripts vor oder nach dem Markup für die Seitenbenutzeroberfläche geladen werden.
LoadViewStateByID	Ruft einen Wert ab, der angibt, ob das Steuerelement am Laden des Ansichtszustands anstelle ID von Index teilnimmt. (Geerbt von Control)
NamingContainer	Ruft einen Verweis auf den Benennungscontainer des Serversteuerelements ab, der einen eindeutigen Namespace für die Unterscheidung zwischen Serversteuerelementen mit demselben ID Eigenschaftswert erstellt. (Geerbt von Control)
Page	Ruft einen Verweis auf die Page Instanz ab, die das Serversteuerelement enthält. (Geerbt von Control)
Parent	Ruft einen Verweis auf das übergeordnete Steuerelement des Serversteuerelements in der Seitensteuerelementhierarchie ab. (Geerbt von Control)
ProfileService	Ruft das ProfileServiceManager Objekt ab, das der aktuellen ScriptManager Instanz zugeordnet ist.
RenderingCompatibility	Ruft einen Wert ab, der die ASP.NET Version angibt, mit der html gerendert wird, kompatibel ist. (Geerbt von Control)
RoleService	Ruft das RoleServiceManager Objekt ab, das der aktuellen ScriptManager Instanz zugeordnet ist.
ScriptMode	Dient zum Abrufen oder Festlegen eines Werts, der angibt, ob Debug- oder Releaseversionen von Clientskriptbibliotheken gerendert werden.
ScriptPath	Veraltet. Dient zum Abrufen oder Festlegen des Stammpfads des Speicherorts, der zum Erstellen der Pfade zu ASP.NET Ajax- und benutzerdefinierten Skriptdateien verwendet wird.
ScriptResourceMapping	Ruft ein ScriptResourceMapping Objekt ab.
Scripts	Ruft ein ScriptReferenceCollection Objekt ab, das die ScriptReference Objekte enthält, die jeweils eine Skriptdatei darstellen, die auf dem Client gerendert wird.
Services	Ruft ein ServiceReferenceCollection Objekt ab, das ein ServiceReference Objekt für jeden Webdienst enthält, der auf dem Client für Ajax-Funktionen verfügbar ASP.NET.
Site	Ruft Informationen zum Container ab, der das aktuelle Steuerelement hostt, wenn es auf einer Entwurfsoberfläche gerendert wird. (Geerbt von Control)
SkinID	Ruft die Haut ab, die auf das Steuerelement angewendet werden soll, oder legt sie fest. (Geerbt von Control)
SupportsPartialRendering	Ruft einen Wert ab, der angibt, ob der Client partielles Seitenrendering unterstützt.
TemplateControl	Dient zum Abrufen oder Festlegen eines Verweises auf die Vorlage, die dieses Steuerelement enthält. (Geerbt von Control)
TemplateSourceDirectory	Ruft das virtuelle Verzeichnis des Page oder UserControl das aktuelle Serversteuerelement ab. (Geerbt von Control)
UniqueID	Ruft den eindeutigen hierarchisch qualifizierten Bezeichner für das Serversteuerelement ab. (Geerbt von Control)
ValidateRequestMode	Dient zum Abrufen oder Festlegen eines Werts, der angibt, ob das Steuerelement Clienteingaben aus dem Browser auf potenziell gefährliche Werte überprüft. (Geerbt von Control)
ViewState	Ruft ein Wörterbuch mit Statusinformationen ab, mit dem Sie den Ansichtszustand eines Serversteuerelements für mehrere Anforderungen für dieselbe Seite speichern und wiederherstellen können. (Geerbt von Control)
ViewStateIgnoresCase	Ruft einen Wert ab, der angibt, ob die Groß-/Kleinschreibung des StateBag Objekts nicht beachtet wird. (Geerbt von Control)
ViewStateMode	Ruft den Ansichtszustandsmodus dieses Steuerelements ab oder legt diesen fest. (Geerbt von Control)
Visible	Überschreibt die Visible Eigenschaft, die von der Basisklasse Control geerbt wird, um das Festlegen dieses Werts zu verhindern.

Methoden

Name	Beschreibung
AddedControl(Control, Int32)	Wird aufgerufen, nachdem der Auflistung des Objekts ein untergeordnetes Control Steuerelement hinzugefügt Controls wurde. (Geerbt von Control)
AddHistoryPoint(NameValueCollection, String)	Erstellt einen Verlaufspunkt und fügt ihn mithilfe des angegebenen Zustandsdatensammlungs- und Statustitels zum Verlaufsstapel des Browsers hinzu.
AddHistoryPoint(String, String, String)	Erstellt einen Verlaufspunkt und fügt ihn mithilfe des angegebenen Statusschlüssels, des Statuswerts und des Statustitels zum Verlaufsstapel des Browsers hinzu.
AddHistoryPoint(String, String)	Erstellt einen Verlaufspunkt und fügt ihn mithilfe des angegebenen Zustandsschlüssels und des Zustandswerts zum Verlaufsstapel des Browsers hinzu.
AddParsedSubObject(Object)	Benachrichtigt das Serversteuerelement, dass ein Element, entweder XML oder HTML, analysiert wurde, und fügt das Element dem Objekt des Serversteuerelements ControlCollection hinzu. (Geerbt von Control)
ApplyStyleSheetSkin(Page)	Wendet die im Seitenstylesheet definierten Formatvorlageneigenschaften auf das Steuerelement an. (Geerbt von Control)
BeginRenderTracing(TextWriter, Object)	Beginnt mit der Entwurfszeitablaufverfolgung von Renderingdaten. (Geerbt von Control)
BuildProfileTree(String, Boolean)	Sammelt Informationen über das Serversteuerelement und liefert sie an die Eigenschaft, die Trace angezeigt werden soll, wenn die Ablaufverfolgung für die Seite aktiviert ist. (Geerbt von Control)
ClearCachedClientID()	Legt den zwischengespeicherten ClientID Wert auf `null`. (Geerbt von Control)
ClearChildControlState()	Löscht die Steuerelementstatusinformationen für die untergeordneten Steuerelemente des Serversteuerelements. (Geerbt von Control)
ClearChildState()	Löscht die Ansichts- und Steuerelementstatusinformationen für alle untergeordneten Steuerelemente des Serversteuerelements. (Geerbt von Control)
ClearChildViewState()	Löscht die Ansichtsstatusinformationen für alle untergeordneten Steuerelemente des Serversteuerelements. (Geerbt von Control)
ClearEffectiveClientIDMode()	Legt die ClientIDMode Eigenschaft der aktuellen Steuerelementinstanz und aller untergeordneten Steuerelemente auf Inherit. (Geerbt von Control)
CreateChildControls()	Wird vom ASP.NET Seitenframework aufgerufen, um Serversteuerelemente zu benachrichtigen, die kompositionsbasierte Implementierung verwenden, um alle untergeordneten Steuerelemente zu erstellen, die sie in Vorbereitung auf das Veröffentlichen von Zurück- oder Rendering enthalten. (Geerbt von Control)
CreateControlCollection()	Erstellt ein neues ControlCollection Objekt, das die untergeordneten Steuerelemente (literal und server) des Serversteuerelements enthält. (Geerbt von Control)
DataBind()	Bindet eine Datenquelle an das aufgerufene Serversteuerelement und alle untergeordneten Steuerelemente. (Geerbt von Control)
DataBind(Boolean)	Bindet eine Datenquelle an das aufgerufene Serversteuerelement und alle untergeordneten Steuerelemente mit einer Option zum Auslösen des DataBinding Ereignisses. (Geerbt von Control)
DataBindChildren()	Bindet eine Datenquelle an die untergeordneten Steuerelemente des Serversteuerelements. (Geerbt von Control)
Dispose()	Ermöglicht es einem Serversteuerelement, die endgültige Bereinigung durchzuführen, bevor es aus dem Arbeitsspeicher freigegeben wird. (Geerbt von Control)
EndRenderTracing(TextWriter, Object)	Beendet die Entwurfszeitablaufverfolgung von Renderingdaten. (Geerbt von Control)
EnsureChildControls()	Bestimmt, ob das Serversteuerelement untergeordnete Steuerelemente enthält. Wenn dies nicht der Fall ist, werden untergeordnete Steuerelemente erstellt. (Geerbt von Control)
EnsureID()	Erstellt einen Bezeichner für Steuerelemente, denen kein Bezeichner zugewiesen ist. (Geerbt von Control)
Equals(Object)	Bestimmt, ob das angegebene Objekt dem aktuellen Objekt entspricht. (Geerbt von Object)
FindControl(String, Int32)	Durchsucht den aktuellen Benennungscontainer für ein Serversteuerelement mit der angegebenen `id` und einer ganzzahligen Zahl, die `pathOffset` im Parameter angegeben ist, der die Suche unterstützt. Sie sollten diese Version der FindControl Methode nicht außer Kraft setzen. (Geerbt von Control)
FindControl(String)	Durchsucht den aktuellen Benennungscontainer für ein Serversteuerelement mit dem angegebenen `id` Parameter. (Geerbt von Control)
Focus()	Legt den Eingabefokus auf ein Steuerelement fest. (Geerbt von Control)
GetCurrent(Page)	Ruft die ScriptManager Instanz für ein bestimmtes Page Objekt ab.
GetDesignModeState()	Ruft Entwurfszeitdaten für ein Steuerelement ab. (Geerbt von Control)
GetHashCode()	Dient als Standardhashfunktion. (Geerbt von Object)
GetRegisteredArrayDeclarations()	Ruft eine schreibgeschützte Auflistung von ECMAScript (JavaScript)-Arraydeklarationen ab, die zuvor beim Page Objekt registriert wurden.
GetRegisteredClientScriptBlocks()	Ruft eine schreibgeschützte Auflistung von Clientskriptblöcken ab, die zuvor beim ScriptManager Steuerelement registriert wurden.
GetRegisteredDisposeScripts()	Ruft eine schreibgeschützte Auflistung von `dispose` Skripts ab, die zuvor beim Page Objekt registriert wurden.
GetRegisteredExpandoAttributes()	Ruft eine schreibgeschützte Auflistung von benutzerdefinierten Attributen (expando) ab, die zuvor beim Page Objekt registriert wurden.
GetRegisteredHiddenFields()	Ruft eine schreibgeschützte Auflistung ausgeblendeter Felder ab, die zuvor beim Page Objekt registriert wurden.
GetRegisteredOnSubmitStatements()	Ruft eine schreibgeschützte Auflistung von `onsubmit` Anweisungen ab, die zuvor beim Page Objekt registriert wurden.
GetRegisteredStartupScripts()	Ruft eine schreibgeschützte Auflistung von Startskripts ab, die zuvor beim Page Objekt registriert wurden.
GetRouteUrl(Object)	Ruft die URL ab, die einem Satz von Routenparametern entspricht. (Geerbt von Control)
GetRouteUrl(RouteValueDictionary)	Ruft die URL ab, die einem Satz von Routenparametern entspricht. (Geerbt von Control)
GetRouteUrl(String, Object)	Ruft die URL ab, die einem Satz von Routenparametern und einem Routennamen entspricht. (Geerbt von Control)
GetRouteUrl(String, RouteValueDictionary)	Ruft die URL ab, die einem Satz von Routenparametern und einem Routennamen entspricht. (Geerbt von Control)
GetStateString()	Ruft eine Zeichenfolge ab, die Schlüssel-Wert-Paare enthält, die den Status der Webseite darstellen.
GetType()	Ruft die Type der aktuellen Instanz ab. (Geerbt von Object)
GetUniqueIDRelativeTo(Control)	Gibt den präfixierten Teil der UniqueID Eigenschaft des angegebenen Steuerelements zurück. (Geerbt von Control)
HasControls()	Bestimmt, ob das Serversteuerelement untergeordnete Steuerelemente enthält. (Geerbt von Control)
HasEvents()	Gibt einen Wert zurück, der angibt, ob Ereignisse für das Steuerelement oder untergeordnete Steuerelemente registriert sind. (Geerbt von Control)
IsLiteralContent()	Bestimmt, ob das Serversteuerelement nur Literalinhalte enthält. (Geerbt von Control)
LoadControlState(Object)	Stellt Steuerstatusinformationen aus einer vorherigen Seitenanforderung wieder her, die von der SaveControlState() Methode gespeichert wurde. (Geerbt von Control)
LoadPostData(String, NameValueCollection)	Liest Formulardaten, die vom Browser auf den Server gepostet werden, und bestimmt die Quelle des asynchronen Postbacks.
LoadViewState(Object)	Stellt Ansichtsstatusinformationen aus einer vorherigen Seitenanforderung wieder her, die von der SaveViewState() Methode gespeichert wurde. (Geerbt von Control)
MapPathSecure(String)	Ruft den physischen Pfad ab, dem ein virtueller Pfad, entweder absolut oder relativ, zugeordnet ist. (Geerbt von Control)
MemberwiseClone()	Erstellt eine flache Kopie der aktuellen Object. (Geerbt von Object)
OnAsyncPostBackError(AsyncPostBackErrorEventArgs)	Löst das AsyncPostBackError-Ereignis aus.
OnBubbleEvent(Object, EventArgs)	Bestimmt, ob das Ereignis für das Serversteuerelement an die Ui-Serversteuerelementhierarchie der Seite übergeben wird. (Geerbt von Control)
OnDataBinding(EventArgs)	Löst das DataBinding-Ereignis aus. (Geerbt von Control)
OnInit(EventArgs)	Löst das Init Ereignis aus und stellt sicher, dass nur ein ScriptManager Steuerelement auf der Seite vorhanden ist.
OnLoad(EventArgs)	Löst das Load-Ereignis aus. (Geerbt von Control)
OnPreRender(EventArgs)	Löst das PreRender Ereignis aus und registriert Skriptdateien und -dienste für Partielle Seitenaktualisierungen.
OnResolveCompositeScriptReference(CompositeScriptReferenceEventArgs)	Löst das ResolveCompositeScriptReference-Ereignis aus.
OnResolveScriptReference(ScriptReferenceEventArgs)	Löst das ResolveScriptReference Ereignis für jeden Skriptverweis aus, der ScriptManager vom Steuerelement verwaltet wird.
OnUnload(EventArgs)	Löst das Unload-Ereignis aus. (Geerbt von Control)
OpenFile(String)	Ruft einen Stream Verwendeten zum Lesen einer Datei ab. (Geerbt von Control)
RaiseBubbleEvent(Object, EventArgs)	Weist alle Quellen des Ereignisses und dessen Informationen dem übergeordneten Element des Steuerelements zu. (Geerbt von Control)
RaisePostBackEvent(String)	Verarbeitet ein vom Steuerelement ausgelöstes ScriptManager Postbackereignis und lädt den Verlaufszustand der Webseite.
RaisePostDataChangedEvent()	Löst Ereignisse für das ScriptManager Steuerelement aus, wenn es wieder auf dem Server veröffentlicht wird.
RegisterArrayDeclaration(Control, String, String)	Registriert eine ECMAScript -Arraydeklaration (JavaScript) mit dem Steuerelement für die ScriptManager Verwendung mit einem Steuerelement, das sich in einem UpdatePanel Steuerelement befindet, und fügt das Array der Seite hinzu.
RegisterArrayDeclaration(Page, String, String)	Registriert eine ECMAScript -Arraydeklaration (JavaScript) mit dem Steuerelement für die ScriptManager Verwendung mit einem Steuerelement, das sich in einem UpdatePanel Steuerelement befindet, und fügt das Array der Seite hinzu.
RegisterAsyncPostBackControl(Control)	Registriert ein Steuerelement als Trigger für asynchrone Postbacks.
RegisterClientScriptBlock(Control, Type, String, String, Boolean)	Registriert einen Clientskriptblock mit dem Steuerelement für die ScriptManager Verwendung mit einem Steuerelement, das sich innerhalb eines UpdatePanel Steuerelements befindet, und fügt dann den Skriptblock zur Seite hinzu.
RegisterClientScriptBlock(Page, Type, String, String, Boolean)	Registriert einen Clientskriptblock mit dem Steuerelement für die ScriptManager Verwendung mit einem Steuerelement, das sich innerhalb eines UpdatePanel Steuerelements befindet, und fügt dann den Skriptblock zur Seite hinzu.
RegisterClientScriptInclude(Control, Type, String, String)	Registriert eine Clientskriptdatei mit dem Steuerelement für die ScriptManager Verwendung mit einem Steuerelement, das sich in einem UpdatePanel Steuerelement befindet, und fügt dann einen Skriptdateiverweis zur Seite hinzu.
RegisterClientScriptInclude(Page, Type, String, String)	Registriert client script with the ScriptManager control every time that an asynchron postback occurs, and then adds a script file reference to the page.
RegisterClientScriptResource(Control, Type, String)	Registriert das Clientskript, das in eine Assembly eingebettet ist, mit dem Steuerelement für die ScriptManager Verwendung mit einem Steuerelement, das an partiellem Seitenrendering teilnimmt.
RegisterClientScriptResource(Page, Type, String)	Registriert eine Clientskriptdatei, die bei jedem Auftreten eines Postbacks in eine Assembly mit dem ScriptManager Steuerelement eingebettet ist.
RegisterDataItem(Control, String, Boolean)	Sendet benutzerdefinierte Daten während des teilweisen Seitenrenderings an ein Steuerelement und gibt an, ob die Daten im Json-Format (JavaScript Object Notation) vorliegen.
RegisterDataItem(Control, String)	Sendet benutzerdefinierte Daten während des teilweisen Seitenrenderings an ein Steuerelement.
RegisterDispose(Control, String)	Registriert ein Skript für ein `dispose` Steuerelement, das sich innerhalb eines UpdatePanel Steuerelements befindet. Das Skript wird ausgeführt, wenn das UpdatePanel Steuerelement aktualisiert oder gelöscht wird.
RegisterExpandoAttribute(Control, String, String, String, Boolean)	Registriert ein Name-Wert-Paar mit dem ScriptManager Steuerelement als benutzerdefiniertes (expando)-Attribut eines angegebenen Steuerelements.
RegisterExtenderControl<TExtenderControl>(TExtenderControl, Control)	Registriert ein Erweiterungssteuerelement mit der aktuellen ScriptManager Instanz.
RegisterHiddenField(Control, String, String)	Registriert ein ausgeblendetes Feld mit dem ScriptManager Steuerelement für ein Steuerelement, das sich innerhalb eines UpdatePanel Steuerelements befindet.
RegisterHiddenField(Page, String, String)	Registriert ein ausgeblendetes Feld beim ScriptManager Steuerelement während jedes asynchronen Postbacks.
RegisterNamedClientScriptResource(Control, String)	Registriert Clientskripts anhand des Ressourcennamens, der in eine Assembly mit dem Steuerelement für die ScriptManager Verwendung mit einem Steuerelement eingebettet ist, das an partiellem Seitenrendering teilnimmt.
RegisterNamedClientScriptResource(Page, String)	Registriert Clientskripts anhand des Ressourcennamens, der in eine Assembly mit dem Steuerelement für die ScriptManager Verwendung mit einem Steuerelement eingebettet ist, das an partiellem Seitenrendering teilnimmt.
RegisterOnSubmitStatement(Control, Type, String, String)	Registriert ECMAScript -Code (JavaScript) mit dem ScriptManager Steuerelement für ein Steuerelement, das mit einem UpdatePanel Steuerelement verwendet wird, das beim Senden des Formulars ausgeführt wird.
RegisterOnSubmitStatement(Page, Type, String, String)	Registriert ECMAScript -Code (JavaScript) mit dem ScriptManager Steuerelement für ein Steuerelement, das mit einem UpdatePanel Steuerelement verwendet wird, das beim Senden des Formulars ausgeführt wird.
RegisterPostBackControl(Control)	Registriert ein Steuerelement als Trigger für einen Postback. Diese Methode wird verwendet, um Postbacksteuerelemente innerhalb eines UpdatePanel Steuerelements zu konfigurieren, die andernfalls asynchrone Postbacks ausführen würden.
RegisterScriptControl<TScriptControl>(TScriptControl)	Registriert ein Skriptsteuerelement mit der aktuellen ScriptManager Instanz.
RegisterScriptDescriptors(IExtenderControl)	Ruft eine ExtenderControl Klasse zurück, um Instanzskripts zurückzugeben, die gerendert werden müssen, um das Clientobjekt zu unterstützen, das ein Clientsteuerelement, eine Komponente oder ein Verhalten darstellt.
RegisterScriptDescriptors(IScriptControl)	Ruft eine ScriptControl Klasse auf, um Instanzskripts zurückzugeben, die gerendert werden müssen, um das Clientobjekt zu unterstützen, das ein Clientsteuerelement, eine Komponente oder ein Verhalten darstellt.
RegisterStartupScript(Control, Type, String, String, Boolean)	Registriert einen Startskriptblock für ein Steuerelement, das sich in einem UpdatePanel ScriptManager Steuerelement befindet, und fügt den Skriptblock der Seite hinzu.
RegisterStartupScript(Page, Type, String, String, Boolean)	Registriert einen Startskriptblock für jeden asynchronen Postback mit dem ScriptManager Steuerelement und fügt den Skriptblock zur Seite hinzu.
RemovedControl(Control)	Wird aufgerufen, nachdem ein untergeordnetes Steuerelement aus der Controls Auflistung des Control Objekts entfernt wurde. (Geerbt von Control)
Render(HtmlTextWriter)	Rendert den Inhalt des Steuerelements mithilfe des ScriptManager angegebenen HtmlTextWriter Objekts im Browser.
RenderChildren(HtmlTextWriter)	Gibt den Inhalt der untergeordneten Elemente eines Serversteuerelements in ein bereitgestelltes HtmlTextWriter Objekt aus, das den inhalt schreibt, der auf dem Client gerendert werden soll. (Geerbt von Control)
RenderControl(HtmlTextWriter, ControlAdapter)	Gibt den Inhalt des Serversteuerelements mithilfe eines bereitgestellten Objekts an ein bereitgestelltes HtmlTextWriter ControlAdapter Objekt aus. (Geerbt von Control)
RenderControl(HtmlTextWriter)	Gibt Den Inhalt des Serversteuerelements an ein bereitgestelltes HtmlTextWriter Objekt aus und speichert Ablaufverfolgungsinformationen zum Steuerelement, wenn die Ablaufverfolgung aktiviert ist. (Geerbt von Control)
ResolveAdapter()	Ruft den Steuerelementadapter ab, der für das Rendern des angegebenen Steuerelements verantwortlich ist. (Geerbt von Control)
ResolveClientUrl(String)	Ruft eine URL ab, die vom Browser verwendet werden kann. (Geerbt von Control)
ResolveUrl(String)	Wandelt eine URL in eine URL um, die auf dem anfordernden Client verwendet werden kann. (Geerbt von Control)
SaveControlState()	Speichert alle Änderungen des Serversteuerelementstatus, die seit dem Zeitpunkt der Zurückpostung der Seite auf dem Server aufgetreten sind. (Geerbt von Control)
SaveViewState()	Speichert alle Änderungen des Ansichtszustands des Serversteuerelements, die seit dem Zeitpunkt, zu dem die Seite zurück auf den Server gepostet wurde, aufgetreten sind. (Geerbt von Control)
SetDesignModeState(IDictionary)	Legt Entwurfszeitdaten für ein Steuerelement fest. (Geerbt von Control)
SetFocus(Control)	Legt den Browserfokus auf das angegebene Steuerelement fest.
SetFocus(String)	Legt den Browserfokus auf das durch die ID angegebene Steuerelement fest.
SetRenderMethodDelegate(RenderMethod)	Weist einen Ereignishandlerdelegat zu, um das Serversteuerelement und dessen Inhalt in seinem übergeordneten Steuerelement zu rendern. (Geerbt von Control)
SetTraceData(Object, Object, Object)	Legt Ablaufverfolgungsdaten für die Entwurfszeitablaufverfolgung von Renderingdaten mithilfe des ablaufverfolgungsobjekts, des Ablaufverfolgungsdatenschlüssels und des Ablaufverfolgungsdatenwerts fest. (Geerbt von Control)
SetTraceData(Object, Object)	Legt Ablaufverfolgungsdaten für die Entwurfszeitablaufverfolgung von Renderingdaten mithilfe des Ablaufverfolgungsdatenschlüssels und des Ablaufverfolgungsdatenwerts fest. (Geerbt von Control)
ToString()	Gibt eine Zeichenfolge zurück, die das aktuelle Objekt darstellt. (Geerbt von Object)
TrackViewState()	Bewirkt die Nachverfolgung von Ansichtszustandsänderungen am Serversteuerelement, sodass sie im Objekt des Serversteuerelements StateBag gespeichert werden können. Auf dieses Objekt kann über die ViewState Eigenschaft zugegriffen werden. (Geerbt von Control)

Ereignisse

Name	Beschreibung
AsyncPostBackError	Tritt auf, wenn während eines asynchronen Postbacks ein Seitenfehler auftritt.
DataBinding	Tritt auf, wenn das Serversteuerelement eine Bindung an eine Datenquelle ausführt. (Geerbt von Control)
Disposed	Tritt auf, wenn ein Serversteuerelement aus dem Arbeitsspeicher freigegeben wird. Dies ist die letzte Phase des Lebenszyklus des Serversteuerelements, wenn eine ASP.NET Seite angefordert wird. (Geerbt von Control)
Init	Tritt auf, wenn das Serversteuerelement initialisiert wird, was der erste Schritt im Lebenszyklus ist. (Geerbt von Control)
Load	Tritt auf, wenn das Serversteuerelement in das Page Objekt geladen wird. (Geerbt von Control)
Navigate	Tritt auf, wenn der Benutzer auf die Schaltfläche " Zurück " oder "Vorwärts " des Browsers klickt.
PreRender	Tritt ein, nachdem das Control Objekt geladen wurde, aber vor dem Rendern. (Geerbt von Control)
ResolveCompositeScriptReference	Tritt auf, wenn ein zusammengesetztes Skript mit dem ScriptManager Steuerelement registriert wird.
ResolveScriptReference	Tritt auf, wenn ein Element der Scripts Auflistung mit dem ScriptManager Steuerelement registriert wird.
Unload	Tritt auf, wenn das Serversteuerelement aus dem Arbeitsspeicher entladen wird. (Geerbt von Control)

Explizite Schnittstellenimplementierungen

Name	Beschreibung
IControlBuilderAccessor.ControlBuilder	Eine Beschreibung dieses Mitglieds finden Sie unter ControlBuilder. (Geerbt von Control)
IControlDesignerAccessor.GetDesignModeState()	Eine Beschreibung dieses Mitglieds finden Sie unter GetDesignModeState(). (Geerbt von Control)
IControlDesignerAccessor.SetDesignModeState(IDictionary)	Eine Beschreibung dieses Mitglieds finden Sie unter SetDesignModeState(IDictionary). (Geerbt von Control)
IControlDesignerAccessor.SetOwnerControl(Control)	Eine Beschreibung dieses Mitglieds finden Sie unter SetOwnerControl(Control). (Geerbt von Control)
IControlDesignerAccessor.UserData	Eine Beschreibung dieses Mitglieds finden Sie unter UserData. (Geerbt von Control)
IDataBindingsAccessor.DataBindings	Eine Beschreibung dieses Mitglieds finden Sie unter DataBindings. (Geerbt von Control)
IDataBindingsAccessor.HasDataBindings	Eine Beschreibung dieses Mitglieds finden Sie unter HasDataBindings. (Geerbt von Control)
IExpressionsAccessor.Expressions	Eine Beschreibung dieses Mitglieds finden Sie unter Expressions. (Geerbt von Control)
IExpressionsAccessor.HasExpressions	Eine Beschreibung dieses Mitglieds finden Sie unter HasExpressions. (Geerbt von Control)
IParserAccessor.AddParsedSubObject(Object)	Eine Beschreibung dieses Mitglieds finden Sie unter AddParsedSubObject(Object). (Geerbt von Control)
IPostBackDataHandler.LoadPostData(String, NameValueCollection)	Eine Beschreibung dieses Mitglieds finden Sie unter LoadPostData(String, NameValueCollection).
IPostBackDataHandler.RaisePostDataChangedEvent()	Eine Beschreibung dieses Mitglieds finden Sie unter RaisePostDataChangedEvent().
IPostBackEventHandler.RaisePostBackEvent(String)	Ermöglicht es dem ScriptManager Steuerelement, ein Postbackereignis zu verarbeiten und den Verlaufszustand der Webseite zu laden.

Erweiterungsmethoden

Name	Beschreibung
FindDataSourceControl(Control)	Gibt die Datenquelle zurück, die dem Datensteuerelement für das angegebene Steuerelement zugeordnet ist.
FindFieldTemplate(Control, String)	Gibt die Feldvorlage für die angegebene Spalte im Benennungscontainer des angegebenen Steuerelements zurück.
FindMetaTable(Control)	Gibt das metatable -Objekt für das enthaltende Datensteuerelement zurück.

Gilt für:

Weitere Informationen

Feedback

War diese Seite hilfreich?