Freigeben über


ScriptManager Klasse

Definition

Verwaltet ASP.NET-AJAX-Skriptbibliotheken und -Skriptdateien, das Teilrendering von Seiten sowie die Generierung von Clientproxyklassen für Web- und Anwendungsdienste.

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
ScriptManager
Attribute
Implementiert

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 Partielle Seitenupdates zu aktivieren. In diesem Beispiel befinden sich ein Calendar - und ein DropDownList -Steuerelement in einem UpdatePanel -Steuerelement. Standardmäßig ist Alwaysder Wert der UpdateMode -Eigenschaft , und der Wert der ChildrenAsTriggers -Eigenschaft ist true. Daher verursachen untergeordnete Steuerelemente des Bereichs 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 Updatefehlern und Registrieren des Skripts

Im folgenden Beispiel wird gezeigt, wie sie benutzerdefinierte Fehlerbehandlung bei Teilaktualisierungen von Seiten bereitstellen. Wenn bei teilseitigen Seitenupdates ein Fehler auftritt, wird standardmäßig ein JavaScript-Meldungsfeld angezeigt. In diesem Beispiel wird veranschaulicht, wie die benutzerdefinierte Fehlerbehandlung verwendet wird, indem ein Handler für das AsyncPostBackError Ereignis bereitgestellt und die AsyncPostBackErrorMessage -Eigenschaft im Ereignishandler festgelegt wird. Sie können die AllowCustomErrorsRedirect -Eigenschaft auch festlegen, um anzugeben, wie der Abschnitt "benutzerdefinierte Fehler" der Web.config-Datei verwendet wird, wenn bei Teilaktualisierungen der Seite 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 von Datum und Uhrzeit, die im Browser angezeigt werden

Das folgende Beispiel zeigt, wie die EnableScriptGlobalization -Eigenschaft festgelegt wird, damit das Clientskript ein kulturspezifisches Datum und eine kulturspezifische Uhrzeit im Browser anzeigen kann. Im Beispiel wird das Culture Attribut der @ Page-Direktive auf autofestgelegt. Daher bestimmt die erste Sprache, die in den aktuellen Browsereinstellungen angegeben ist, die Kultur und Benutzeroberflächenkultur für die Seite. Weitere Informationen finden Sie unter How to: Set the Culture and UI Culture for ASP.NET Web Page Globalization.For more information, see How to: Set the Culture and UI Culture for ASP.NET Web Page Globalization.

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

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.1//EN" "http://www.w3.org/TR/xhtml11/DTD/xhtml11.dtd">

<html xmlns="http://www.w3.org/1999/xhtml">
<head id="Head1" runat="server">
    <title>Globalization Example</title>
</head>
<body>
    <form id="form1" runat="server">
        <asp:ScriptManager ID="ScriptManager1" EnableScriptGlobalization="true" runat="server">
        </asp:ScriptManager>
        <script type="text/javascript">
        function pageLoad() {
          Sys.UI.DomEvent.addHandler($get("Button1"), "click", formatDate);
        }
        function formatDate() {
          var d = new Date();
          try {
            $get('Label1').innerHTML = d.localeFormat("dddd, dd MMMM yyyy HH:mm:ss");
          }
          catch(e) {
            alert("Error:" + e.message);
          }
        }
        </script>
        <asp:UpdatePanel ID="UpdatePanel1" runat="server" ChildrenAsTriggers="False" UpdateMode="Conditional">
        <ContentTemplate>
        <asp:Panel ID="Panel1" runat="server" GroupingText="Update Panel">
        <asp:Button ID="Button1" runat="server" Text="Display Date" />

        <br />

        <asp:Label ID="Label1" runat="server"></asp:Label>
        </asp:Panel>
        </ContentTemplate>
        </asp:UpdatePanel>
    </form>
</body>
</html>
<%@ Page Language="VB" Culture="auto" %>

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.1//EN" "http://www.w3.org/TR/xhtml11/DTD/xhtml11.dtd">

<html xmlns="http://www.w3.org/1999/xhtml">
<head id="Head1" runat="server">
    <title>Globalization Example</title>
</head>
<body>
    <form id="form1" runat="server">
        <asp:ScriptManager ID="ScriptManager1" EnableScriptGlobalization="true" runat="server">
        </asp:ScriptManager>
        <script type="text/javascript">
        function pageLoad() {
          Sys.UI.DomEvent.addHandler($get("Button1"), "click", formatDate);
        }
        function formatDate() {
          var d = new Date();
          try {
            $get('Label1').innerHTML = d.localeFormat("dddd, dd MMMM yyyy HH:mm:ss");
          }
          catch(e) {
            alert("Error:" + e.message);
          }
        }
        </script>
        <asp:UpdatePanel ID="UpdatePanel1" runat="server" ChildrenAsTriggers="False" UpdateMode="Conditional">
        <ContentTemplate>
        <asp:Panel ID="Panel1" runat="server" GroupingText="Update Panel">
        <asp:Button ID="Button1" runat="server" Text="Display Date" />

        <br />

        <asp:Label ID="Label1" runat="server"></asp:Label>
        </asp:Panel>
        </ContentTemplate>
        </asp:UpdatePanel>
    </form>
</body>
</html>

Hinweise

In diesem Thema:

Einführung

Das ScriptManager Steuerelement ist von zentraler Bedeutung für die Ajax-Funktionalität in ASP.NET. Das -Steuerelement verwaltet alle ASP.NET Ajax-Ressourcen auf einer Seite. Dies umfasst das Herunterladen von Microsoft AJAX-Bibliotheksskripts in den Browser und das Koordinieren von Teilaktualisierungen von Seiten, die mithilfe UpdatePanel von Steuerelementen aktiviert werden. Darüber hinaus können Sie mit dem ScriptManager -Steuerelement die folgenden Aktionen ausführen:

  • Registrieren Sie ein Skript, das mit Teilaktualisierungen von Seiten kompatibel ist. Um Abhängigkeiten zwischen Ihrem Skript und der Kernbibliothek zu verwalten, wird jedes Skript, das Sie registrieren, nach dem Skript der Microsoft AJAX-Bibliothek geladen.

  • Geben Sie an, ob Release- oder Debugskripts an den Browser gesendet werden.

  • Stellen Sie den Zugriff auf Webdienstmethoden über das Skript bereit, indem Sie Webdienste beim ScriptManager -Steuerelement registrieren.

  • Gewähren Sie zugriff auf ASP.NET Authentifizierungs-, Rollen- und Profilanwendungsdienste aus dem Clientskript, indem Sie diese Dienste beim ScriptManager -Steuerelement registrieren.

  • Aktivieren Sie die kulturspezifische Anzeige der ECMAScript-Funktionen (JavaScript) Date, Number und String 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 -Schnittstelle oder IScriptControl mit dem ScriptManager -Steuerelement implementieren, sodass von Clientkomponenten und -verhalten erforderliche Skripts gerendert werden.

Partial-Page Rendering

Die Fähigkeit einer ASP.NET Seite, teilseitiges Rendern von Seiten zu unterstützen, wird durch die folgenden Faktoren gesteuert:

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

Wenn partielles Seitenrendering unterstützt wird, rendert das ScriptManager Steuerelement skript, um asynchrone Postbacks und Teilaktualisierungen von Seiten zu ermöglichen. Die Zu aktualisierenden Bereiche der Seite werden mithilfe UpdatePanel von -Steuerelementen festgelegt. Das ScriptManager Steuerelement verarbeitet die asynchronen Postbacks und aktualisiert nur die Bereiche der Seite, die aktualisiert werden müssen. Weitere Informationen zum Partiellen Rendern von Seiten finden Sie unter Partial-Page Rendering Overview. Weitere Informationen zu den Bedingungen, die ein Update verursachen, finden Sie unter Übersicht über das UpdatePanel-Steuerelement.

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

Eine Seite kann nur ein ScriptManager Steuerelement in ihrer 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 ScriptManager dem -Steuerelement können Sie ein Skript registrieren, das dann als Teil der Seite gerendert wird. Die ScriptManager Kontrollregistrierungsmethoden können in die folgenden drei Kategorien unterteilt werden:

  • Registrierungsmethoden, die sicherstellen, dass Skriptabhängigkeiten von der Microsoft AJAX-Bibliothek beibehalten 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 von Ajax-Skripts in ASP.NET finden Sie unter Erstellen eines benutzerdefinierten Clientskripts mithilfe der Microsoft AJAX-Bibliothek.

Registrieren eines Skripts, das von der Microsoft AJAX-Bibliothek abhängig ist

Sie können die folgenden Methoden verwenden, um Skriptdateien so zu registrieren, dass alle Abhängigkeiten von der Microsoft AJAX-Bibliothek beibehalten 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 ein 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 ein Skript, das das Clientobjekt unterstützt.

Registrieren Partial-Page kompatibler Skripts

Sie können die folgenden Methoden verwenden, um Skriptdateien zu registrieren, die nicht von der Microsoft AJAX-Bibliothek abhängig sind, aber mit UpdatePanel Steuerelementen kompatibel sind. Diese Methoden entsprechen ähnlichen Methoden des Steuerelements ClientScriptManager . Wenn Sie skripts zur Verwendung innerhalb eines Steuerelements UpdatePanel 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 öffnenden <form> Tag der Seite. Das Skript wird als Zeichenfolgenparameter angegeben.
RegisterClientScriptInclude Rendert ein script Element nach dem öffnenden <form> Tag 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 öffnenden <form> Tag der Seite. Der Skriptinhalt wird mit einem Ressourcennamen in einer Assembly angegeben. Das src Attribut wird durch einen Aufruf eines HTTP-Handlers, der das benannte Skript aus der Assembly abruft, automatisch mit einer URL aufgefüllt.
RegisterExpandoAttribute Rendert ein benutzerdefiniertes Name-Wert-Attributpaar (expando) im Markup für ein angegebenes Steuerelement.
RegisterHiddenField Rendert ein ausgeblendetes Feld.
RegisterOnSubmitStatement Registriert ein Skript, das als Reaktion auf das form Ereignis des submit Elements ausgeführt wird. Das onSubmit -Attribut verweist auf das angegebene Skript.
RegisterStartupScript Rendert einen Startskriptblock kurz 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 ein Skript mit demselben Typ/Schlüsselpaar bereits registriert ist, wird kein neues Skript registriert. Wenn Sie ein Skript mit einem bereits vorhandenen Typ-Ressourcennamen-Paar registrieren, wird das Element, das script 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 RegisterClientScriptInclude -Methode oder aufrufen, vermeiden Sie die RegisterClientScriptResource Registrierung eines Skripts, das Inlinefunktionen ausführt. Registrieren Sie stattdessen ein Skript, das Funktionsdefinitionen wie Ereignishandler oder benutzerdefinierte Klassendefinitionen für Ihre Anwendung enthält.

Registrierungsmethoden für UpdatePanel-Steuerelemente

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

Methode Definition
RegisterAsyncPostBackControl Registriert ein Steuerelement als Trigger für asynchrone Postbacks.
RegisterDataItem Sendet während des Teilrenderings von Seiten benutzerdefinierte Daten an Steuerelemente.
RegisterDispose Registriert ein Dispose-Skript für ein Steuerelement, das sich in einem UpdatePanel Steuerelement 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 ein vollständiges Postback. Diese Methode wird für Steuerelemente in einem UpdatePanel Steuerelement verwendet, das andernfalls asynchrone Postbacks ausführen würde.

Webdienstverweise

Sie können einen Webdienst registrieren, der über ein Clientskript aufgerufen werden soll, indem Sie ein ServiceReference Objekt erstellen und es der Services Auflistung des Steuerelements ScriptManager 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 Clientskript in ASP.NET AJAX und Aufrufen von Webdiensten aus Clientskript in ASP.NET AJAX.

Lokalisierung

Das ScriptManager Steuerelement generiert Verweise auf der gerenderten Seite, die auf die entsprechenden lokalisierten Skriptdateien verweisen, bei denen es sich entweder um in Assemblys eingebettete Skriptdateien oder eigenständige Skriptdateien handelt.

Wenn die EnableScriptLocalization -Eigenschaft auf truefestgelegt ist, ruft das ScriptManager Steuerelement lokalisierte Ressourcen (z. B. lokalisierte Zeichenfolgen) für die aktuelle Kultur ab, sofern sie vorhanden sind. 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 Fallbackkulturskriptdatei an den Browser gesendet werden soll. Dazu wird das kulturspezifische NeutralResourcesLanguageAttribute Assembly-Attribut, die mit der Assembly gepackten 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-MX festgelegt 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 Localizing Resources for Component Libraries Overview .

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 "Benutzerdefinierte Fehler" 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

ScriptManager()

Initialisiert eine neue Instanz der ScriptManager-Klasse.

Eigenschaften

Adapter

Ruft den browserspezifischen Adapter für das Steuerelement ab.

(Geerbt von Control)
AjaxFrameworkAssembly

Ruft die AJAX-Frameworkassembly ab, die von Komponenten auf der Seite verwendet wird.

AjaxFrameworkMode

Ruft einen Wert ab, der angibt, wie Clientskripts der Microsoft Ajax-Clientbibliothek auf dem Client eingeschlossen werden, oder legt den Wert fest.

AllowCustomErrorsRedirect

Ruft einen Wert ab, der bestimmt, ob bei einem Fehler während des asynchronen Postbacks der benutzerdefinierte Fehlerabschnitt der Datei "Web.config" verwendet wird, oder legt diesen fest.

AppRelativeTemplateSourceDirectory

Ruft das anwendungsrelative virtuelle Verzeichnis des Page-Objekts oder des UserControl-Objekt ab, das dieses Steuerelement enthält, oder legt dieses Verzeichnis fest.

(Geerbt von Control)
AsyncPostBackErrorMessage

Ruft die Fehlermeldung ab, die bei einem Serverausnahmefehler während eines asynchronen Postbacks an den Client gesendet wird, oder legt diese fest.

AsyncPostBackSourceElementID

Ruft die eindeutige ID des Steuerelements ab, das das asynchrone Postback verursacht hat.

AsyncPostBackTimeout

Ruft einen Wert ab, der die Zeit in Sekunden vor dem Timeout asynchroner Postbacks angibt, wenn keine Antwort empfangen wird, oder legt diesen fest.

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

Ruft den Algorithmus ab, mit dem der Wert der ClientID-Eigenschaft generiert wird, oder legt diesen fest.

(Geerbt von Control)
ClientIDSeparator

Ruft einen Zeichenwert ab, der das in der ClientID-Eigenschaft verwendete Trennzeichen darstellt.

(Geerbt von Control)
ClientNavigateHandler

Ruft den Namen der Methode ab, die das Sys.Application.navigate-Ereignis für den Client behandelt, oder legt diesen fest.

CompositeScript

Ruft einen Verweis auf das zusammengesetzte Skript ab, das die Webseite unterstützt.

Context

Ruft das dem Serversteuerelement für die aktuelle Webanforderung zugeordnete HttpContext-Objekt ab.

(Geerbt von Control)
Controls

Ruft ein ControlCollection-Objekt ab, das die untergeordneten Steuerelemente für ein angegebenes Serversteuerelement in der Hierarchie der Benutzeroberfläche darstellt.

(Geerbt von Control)
DataItemContainer

Ruft einen Verweis auf den Namenscontainer ab, wenn vom Namenscontainer IDataItemContainer implementiert wird.

(Geerbt von Control)
DataKeysContainer

Ruft einen Verweis auf den Namenscontainer ab, wenn vom Namenscontainer IDataKeysControl implementiert wird.

(Geerbt von Control)
DesignMode

Ruft einen Wert ab, der angibt, ob ein Steuerelement auf einer Entwurfsoberfläche verwendet wird.

(Geerbt von Control)
EmptyPageUrl

Ruft eine URL zu einer leeren Webseite ab oder legt sie fest.

EnableCdn

Bestimmt, ob auf der aktuellen Seite Clientskriptverweise aus CDN-Pfaden (Content Delivery Network) geladen werden.

EnableCdnFallback

Aktiviert die lokale Kopie eines Skripts, die geladen werden soll, falls das CDN (Content Delivery Network) nicht verfügbar ist.

EnableHistory

Ruft einen Wert ab, der angibt, ob die Webseite die Verwaltung von Verlaufspunkten unterstützt, oder legt diesen fest.

EnablePageMethods

Ruft einen Wert ab, der angibt, ob öffentliche statische Seitenmethoden auf einer ASP.NET-Seite von Clientskripts aufgerufen werden können, oder legt diesen fest.

EnablePartialRendering

Ruft einen Wert ab, der das Teilrendering einer Seite ermöglicht, wodurch Sie Bereiche der Seite mithilfe von UpdatePanel-Steuerelementen einzeln aktualisieren können, oder legt diesen fest.

EnableScriptGlobalization

Ruft einen Wert ab, der angibt, ob das ScriptManager-Steuerelement Skripts rendert, die das Analysieren und Formatieren kulturspezifischer Informationen unterstützen, oder legt diesen fest.

EnableScriptLocalization

Ruft einen Wert ab, der angibt, ob das ScriptManager-Steuerelement lokalisierte Versionen von Skriptdateien rendert, oder legt diesen fest.

EnableSecureHistoryState

Ruft einen Wert ab, der angibt, ob die Zeichenfolge für den Verlaufszustand verschlüsselt werden soll, oder legt diesen fest.

EnableTheming

Ruft einen Wert ab, der angibt, ob für dieses Steuerelement Designs gelten, oder legt diesen fest.

(Geerbt von Control)
EnableViewState

Ruft einen Wert ab, der dem anfordernden Client angibt, ob das Serversteuerelement seinen Ansichtszustand sowie den Ansichtszustand von jedem enthaltenen untergeordneten Steuerelement beibehält, oder legt diesen fest.

(Geerbt von Control)
Events

Ruft eine Liste von Ereignishandlerdelegaten für das Steuerelement ab. Diese Eigenschaft ist schreibgeschützt.

(Geerbt von Control)
HasChildViewState

Ruft einen Wert ab, der angibt, ob in den untergeordneten Steuerelementen des aktuellen Serversteuerelements gespeicherte Einstellungen für den Ansichtszustand vorhanden sind.

(Geerbt von Control)
ID

Ruft den programmgesteuerten Bezeichner ab, der dem Serversteuerelement zugewiesen ist, oder legt diesen fest.

(Geerbt von Control)
IdSeparator

Ruft das als Trennzeichen für Steuerelementbezeichner verwendete Zeichen ab.

(Geerbt von Control)
IsChildControlStateCleared

Ruft einen Wert ab, der angibt, ob in diesem Steuerelements enthaltene Steuerelemente über einen Steuerelementzustand verfügen.

(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 das aktuelle Postback im Teilrenderingmodus ausgeführt wird.

IsNavigating

Ruft einen Wert ab, der angibt, ob gegenwärtig ein Navigate-Ereignis behandelt wird.

IsTrackingViewState

Ruft einen Wert ab, der angibt, ob das Serversteuerelement Änderungen des Ansichtszustands speichert.

(Geerbt von Control)
IsViewStateEnabled

Ruft einen Wert ab, der angibt, ob der Ansichtszustand für dieses Steuerelement aktiviert ist.

(Geerbt von Control)
LoadScriptsBeforeUI

Ruft einen Wert ab, der angibt, ob Skripts vor oder nach dem Laden von Markups für die Seitenbenutzeroberfläche geladen werden, oder legt diesen fest.

LoadViewStateByID

Ruft einen Wert ab, der angibt, ob das Steuerelement seinen Ansichtszustand über ID anstatt über den Index lädt.

(Geerbt von Control)
NamingContainer

Ruft einen Verweis auf den Benennungscontainer des Serversteuerelements ab, der einen eindeutigen Namespace erstellt, damit zwischen Serversteuerelementen mit demselben ID-Eigenschaftswert unterschieden werden kann.

(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 Steuerelementhierarchie der Seite 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 gerenderte HTML-Objekte kompatibel sind.

(Geerbt von Control)
RoleService

Ruft das RoleServiceManager-Objekt ab, das der aktuellen ScriptManager-Instanz zugeordnet ist.

ScriptMode

Ruft einen Wert ab, der angibt, ob Debug- oder Releaseversionen von Clientskriptbibliotheken gerendert werden, oder legt diesen fest.

ScriptPath
Veraltet.

Ruft den Stammpfad des zum Erstellen der Pfade zu ASP.NET AJAX und benutzerdefinierten Skriptdateien verwendeten Verzeichnisses ab oder legt diesen fest.

ScriptResourceMapping

Ruft ein ScriptResourceMapping-Objekt ab.

Scripts

Ruft ein ScriptReferenceCollection-Objekt ab, das die ScriptReference-Objekte enthält, die jeweils eine für den Client gerenderte Skriptdatei darstellen.

Services

Ruft ein ServiceReferenceCollection-Objekt mit einem ServiceReference-Objekt für jeden Webdienst ab, den ASP.NET auf dem Client für AJAX-Funktionen verfügbar macht.

Site

Ruft Informationen zum Container ab, der das aktuelle Steuerelement hostet, wenn es auf einer Entwurfsoberfläche gerendert wird.

(Geerbt von Control)
SkinID

Ruft das Design ab, das auf das Steuerelement angewendet werden soll.

(Geerbt von Control)
SupportsPartialRendering

Ruft einen Wert ab, der angibt, ob der Client das Teilrendering von Seiten unterstützt.

TemplateControl

Ruft einen Verweis auf die Vorlage ab, die dieses Steuerelement enthält, oder legt den Verweis fest.

(Geerbt von Control)
TemplateSourceDirectory

Ruft das virtuelle Verzeichnis der Page oder des UserControl ab, in dem das aktuelle Serversteuerelement enthalten ist.

(Geerbt von Control)
UniqueID

Ruft den eindeutigen, hierarchisierten Bezeichner für das Serversteuerelement ab.

(Geerbt von Control)
ValidateRequestMode

Ruft einen Wert ab oder legt einen Wert fest, der angibt, ob das Steuerelement Clienteingaben des Browser auf gefährliche Werte überprüft.

(Geerbt von Control)
ViewState

Ruft ein Wörterbuch mit Zustandsinformationen ab, mit dem Sie den Ansichtszustand eines Serversteuerelements über mehrere Anforderungen für dieselbe Seite hinweg speichern und wiederherstellen können.

(Geerbt von Control)
ViewStateIgnoresCase

Ruft einen Wert ab, der angibt, ob bei dem StateBag-Objekt die Groß- und Kleinschreibung nicht berücksichtigt wird.

(Geerbt von Control)
ViewStateMode

Ruft den Ansichtszustandsmodus des Steuerelements ab oder legt ihn fest.

(Geerbt von Control)
Visible

Überschreibt die Visible-Eigenschaft, die von der Control-Basisklasse geerbt wurde, um das Festlegen dieses Werts zu verhindern.

Methoden

AddedControl(Control, Int32)

Wird aufgerufen, nachdem ein untergeordnetes Steuerelement zur Controls-Auflistung des Control-Objekts hinzugefügt wurde.

(Geerbt von Control)
AddHistoryPoint(NameValueCollection, String)

Erstellt einen Verlaufspunkt und fügt diesen unter Verwendung der angegebenen Zustandsdatenauflistung und des Zustandstitels dem Verlaufsstapel des Browsers hinzu.

AddHistoryPoint(String, String)

Erstellt einen Verlaufspunkt und fügt diesen unter Verwendung des angegebenen Zustandsschlüssels und Zustandswerts dem Verlaufsstapel des Browsers hinzu.

AddHistoryPoint(String, String, String)

Erstellt einen Verlaufspunkt und fügt diesen unter Verwendung des angegebenen Zustandsschlüssels, Zustandswerts und Zustandstitels dem Verlaufsstapel des Browsers hinzu.

AddParsedSubObject(Object)

Benachrichtigt das Serversteuerelement, dass entweder ein XML-Element oder HTML-Element analysiert wurde, und fügt das Element dem ControlCollection-Objekt des Serversteuerelements hinzu.

(Geerbt von Control)
ApplyStyleSheetSkin(Page)

Übernimmt die im Stylesheet der Seite definierten Stileigenschaften für das Steuerelement.

(Geerbt von Control)
BeginRenderTracing(TextWriter, Object)

Startet die Entwurfszeitablaufverfolgung des Renderns von Daten.

(Geerbt von Control)
BuildProfileTree(String, Boolean)

Sammelt Informationen zum Serversteuerelement und übermittelt sie an die Trace-Eigenschaft, sodass diese angezeigt werden, wenn die Ablaufverfolgung für die Seite aktiviert ist.

(Geerbt von Control)
ClearCachedClientID()

Legt den zwischengespeicherten ClientID-Wert auf null fest.

(Geerbt von Control)
ClearChildControlState()

Löscht die Informationen zum Steuerelementzustand für die untergeordneten Steuerelemente des Serversteuerelements.

(Geerbt von Control)
ClearChildState()

Löscht die Informationen zum Ansichtszustand sowie zum Steuerelementzustand für alle untergeordneten Steuerelemente des Serversteuerelements.

(Geerbt von Control)
ClearChildViewState()

Löscht die Informationen über den Ansichtszustand für alle untergeordneten Steuerelemente des Serversteuerelements.

(Geerbt von Control)
ClearEffectiveClientIDMode()

Legt die ClientIDMode-Eigenschaft der aktuellen Steuerelementinstanz und aller untergeordneten Steuerelemente auf Inherit fest.

(Geerbt von Control)
CreateChildControls()

Wird durch das ASP.NET-Seitenframework aufgerufen, um Serversteuerelemente anzuweisen, die eine kompositionsbasierte Implementierung verwenden, um alle untergeordneten Steuerelemente zu erstellen, die sie in Vorbereitung auf ein Postback oder Rendering enthalten.

(Geerbt von Control)
CreateControlCollection()

Erstellt ein neues ControlCollection-Objekt, das die untergeordneten Steuerelemente (sowohl literale als auch Serversteuerelemente) 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 der Option, das DataBinding-Ereignis auszulösen.

(Geerbt von Control)
DataBindChildren()

Bindet eine Datenquelle an die untergeordneten Steuerelemente des Serversteuerelements.

(Geerbt von Control)
Dispose()

Ermöglicht es einem Serversteuerelement, die letzte Bereinigung durchzuführen, bevor es aus dem Speicher freigegeben wird.

(Geerbt von Control)
EndRenderTracing(TextWriter, Object)

Beendet die Entwurfszeitablaufverfolgung des Renderns von Daten.

(Geerbt von Control)
EnsureChildControls()

Stellt fest, ob das Serversteuerelement untergeordnete Steuerelemente enthält. Wenn das nicht der Fall ist, werden untergeordnete Steuerelemente erstellt.

(Geerbt von Control)
EnsureID()

Erstellt einen Bezeichner für Steuerelemente, die nicht über einen zugewiesenen Bezeichner verfügen.

(Geerbt von Control)
Equals(Object)

Bestimmt, ob das angegebene Objekt gleich dem aktuellen Objekt ist.

(Geerbt von Object)
FindControl(String)

Durchsucht den aktuellen Benennungscontainer nach dem angegebenen Serversteuerelement mit dem angegebenen id-Parameter.

(Geerbt von Control)
FindControl(String, Int32)

Durchsucht den aktuellen Benennungscontainer nach einem Serversteuerelement mit der angegebenen id und einer ganzen Zahl, die im pathOffset-Parameter angegeben ist, der die Suche unterstützt. Sie sollten diese Version der FindControl-Methode nicht überschreiben.

(Geerbt von Control)
Focus()

Legt den Eingabefokus auf ein Steuerelement fest.

(Geerbt von Control)
GetCurrent(Page)

Ruft die Instanz von ScriptManager für ein angegebenes Page-Objekt ab.

GetDesignModeState()

Ruft die Entwurfszeitdaten für ein Steuerelement ab.

(Geerbt von Control)
GetHashCode()

Fungiert als Standardhashfunktion.

(Geerbt von Object)
GetRegisteredArrayDeclarations()

Ruft eine schreibgeschützte Auflistung von ECMAScript-Arraydeklarationen (JavaScript) ab, die vorher beim Page-Objekt registriert wurden.

GetRegisteredClientScriptBlocks()

Ruft eine schreibgeschützte Auflistung von Clientskriptblöcken ab, die vorher beim ScriptManager-Steuerelement registriert wurden.

GetRegisteredDisposeScripts()

Ruft eine schreibgeschützte Auflistung von dispose-Skripts ab, die vorher beim Page-Objekt registriert wurden.

GetRegisteredExpandoAttributes()

Ruft eine schreibgeschützte Auflistung von benutzerdefinierten Attributen (Expando-Attributen) ab, die vorher beim Page-Objekt registriert wurden.

GetRegisteredHiddenFields()

Ruft eine schreibgeschützte Auflistung von ausgeblendeten Feldern ab, die vorher beim Page-Objekt registriert wurden.

GetRegisteredOnSubmitStatements()

Ruft eine schreibgeschützte Auflistung von onsubmit-Anweisungen ab, die vorher beim Page-Objekt registriert wurden.

GetRegisteredStartupScripts()

Ruft eine schreibgeschützte Auflistung von Startskripts ab, die vorher 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 mit Schlüssel-Wert-Paaren ab, die den Zustand der Webseite darstellen.

GetType()

Ruft den Type der aktuellen Instanz ab.

(Geerbt von Object)
GetUniqueIDRelativeTo(Control)

Gibt den mit einem Präfix versehenen Abschnitt der UniqueID-Eigenschaft des angegebenen Steuerelements zurück.

(Geerbt von Control)
HasControls()

Ermittelt, 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 für untergeordnete Steuerelemente registriert werden.

(Geerbt von Control)
IsLiteralContent()

Ermittelt, ob das Serversteuerelement nur literalen Inhalt enthält.

(Geerbt von Control)
LoadControlState(Object)

Stellt die Informationen zum Steuerelementzustand aus einer früheren Seitenanforderung wieder her, die durch die SaveControlState()-Methode gespeichert wurden.

(Geerbt von Control)
LoadPostData(String, NameValueCollection)

Liest vom Browser an den Server gesendete Formulardaten und ermittelt die Quelle des asynchronen Postbacks.

LoadViewState(Object)

Stellt die Informationen über den Ansichtszustand aus einer früheren Seitenanforderung wieder her, die mit der SaveViewState()-Methode gespeichert wurden.

(Geerbt von Control)
MapPathSecure(String)

Ruft den physikalischen Pfad ab, auf den ein absoluter bzw. relativer virtueller Pfad verweist.

(Geerbt von Control)
MemberwiseClone()

Erstellt eine flache Kopie des aktuellen Object.

(Geerbt von Object)
OnAsyncPostBackError(AsyncPostBackErrorEventArgs)

Löst das AsyncPostBackError-Ereignis aus.

OnBubbleEvent(Object, EventArgs)

Bestimmt, ob das Ereignis für das Serversteuerelement in der UI-Serversteuerelementhierarchie der Seite nach oben ü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 auf der Seite nur ein einziges ScriptManager-Steuerelement 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 Teilaktualisierungen von Seiten.

OnResolveCompositeScriptReference(CompositeScriptReferenceEventArgs)

Löst das ResolveCompositeScriptReference-Ereignis aus.

OnResolveScriptReference(ScriptReferenceEventArgs)

Löst das ResolveScriptReference-Ereignis für jeden Skriptverweis aus, der vom ScriptManager-Steuerelement verwaltet wird.

OnUnload(EventArgs)

Löst das Unload-Ereignis aus.

(Geerbt von Control)
OpenFile(String)

Ruft einen Stream zum Lesen einer Datei ab.

(Geerbt von Control)
RaiseBubbleEvent(Object, EventArgs)

Weist dem übergeordneten Element des Steuerelements alle Ereignisquellen und zugehörige Informationen zu.

(Geerbt von Control)
RaisePostBackEvent(String)

Verarbeitet ein Postbackereignis, das vom ScriptManager-Steuerelement ausgelöst wurde, und lädt den Verlaufszustand der Webseite.

RaisePostDataChangedEvent()

Löst Ereignisse für das ScriptManager-Steuerelement aus, wenn es ein Postback an den Server ausführt.

RegisterArrayDeclaration(Control, String, String)

Registriert eine ECMAScript-Arraydeklaration (JavaScript) beim ScriptManager-Steuerelement für die Verwendung mit einem Steuerelement, das sich innerhalb eines UpdatePanel-Steuerelements befindet, und fügt das Array der Seite hinzu.

RegisterArrayDeclaration(Page, String, String)

Registriert eine ECMAScript-Arraydeklaration (JavaScript) beim ScriptManager-Steuerelement für die Verwendung mit einem Steuerelement, das sich innerhalb eines UpdatePanel-Steuerelements 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 beim ScriptManager-Steuerelement für die Verwendung mit einem Steuerelement, das sich innerhalb eines UpdatePanel-Steuerelements befindet, und fügt der Seite dann den Skriptblock hinzu.

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

Registriert einen Clientskriptblock beim ScriptManager-Steuerelement für die Verwendung mit einem Steuerelement, das sich innerhalb eines UpdatePanel-Steuerelements befindet, und fügt der Seite dann den Skriptblock hinzu.

RegisterClientScriptInclude(Control, Type, String, String)

Registriert eine Clientskriptdatei beim ScriptManager-Steuerelement für die Verwendung mit einem Steuerelement, das sich innerhalb eines UpdatePanel-Steuerelements befindet, und fügt der Seite dann einen Skriptdateiverweis hinzu.

RegisterClientScriptInclude(Page, Type, String, String)

Registriert das Clientskript bei jedem asynchronen Postback beim ScriptManager-Steuerelement und fügt der Seite dann einen Skriptdateiverweis hinzu.

RegisterClientScriptResource(Control, Type, String)

Registriert das in einer Assembly eingebettete Clientskript beim ScriptManager-Steuerelement, um dieses mit einem Steuerelement zu verwenden, das am Teilrendering von Seiten beteiligt ist.

RegisterClientScriptResource(Page, Type, String)

Registriert eine in einer Assembly eingebettete Clientskriptdatei bei jedem asynchronen Postback beim ScriptManager-Steuerelement.

RegisterDataItem(Control, String)

Sendet während des Teilrenderings von Seiten benutzerdefinierte Daten an ein Steuerelement.

RegisterDataItem(Control, String, Boolean)

Sendet benutzerdefinierte Daten während des Teilrenderings von Seiten an ein Steuerelement und gibt an, ob die Daten das JSON-Format (JavaScript Object Notation) aufweisen.

RegisterDispose(Control, String)

Registriert ein dispose-Skript für ein Steuerelement, das sich in einem UpdatePanel-Steuerelement 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 beim ScriptManager-Steuerelement als benutzerdefiniertes Attribut (Expando-Attribut) eines angegebenen Steuerelements.

RegisterExtenderControl<TExtenderControl>(TExtenderControl, Control)

Registriert ein Extendersteuerelement bei der aktuellen Instanz von ScriptManager.

RegisterHiddenField(Control, String, String)

Registriert ein ausgeblendetes Feld beim ScriptManager-Steuerelement für ein Steuerelement, das sich in einem UpdatePanel-Steuerelement befindet.

RegisterHiddenField(Page, String, String)

Registriert ein ausgeblendetes Feld bei jedem asynchronen Postback beim ScriptManager-Steuerelement.

RegisterNamedClientScriptResource(Control, String)

Registriert in einer Assembly eingebettete Clientskripts anhand des Ressourcennamens beim ScriptManager-Steuerelement, um diese mit einem Steuerelement zu verwenden, das am Teilrendering von Seiten beteiligt ist.

RegisterNamedClientScriptResource(Page, String)

Registriert in einer Assembly eingebettete Clientskripts anhand des Ressourcennamens beim ScriptManager-Steuerelement, um diese mit einem Steuerelement zu verwenden, das am Teilrendering von Seiten beteiligt ist.

RegisterOnSubmitStatement(Control, Type, String, String)

Registriert ECMAScript-Code (JavaScript) beim ScriptManager-Steuerelement für ein Steuerelement mit UpdatePanel-Steuerelement mit Ausführung beim Senden des Formulars.

RegisterOnSubmitStatement(Page, Type, String, String)

Registriert ECMAScript-Code (JavaScript) beim ScriptManager-Steuerelement für ein Steuerelement mit UpdatePanel-Steuerelement mit Ausführung beim Senden des Formulars.

RegisterPostBackControl(Control)

Registriert ein Steuerelement als Trigger für ein Postback. Diese Methode wird zum Konfigurieren von Postbacksteuerelementen in einem UpdatePanel-Steuerelement verwendet, die andernfalls asynchrone Postbacks ausführen würden.

RegisterScriptControl<TScriptControl>(TScriptControl)

Registriert ein Skriptsteuerelement bei der aktuellen Instanz von ScriptManager.

RegisterScriptDescriptors(IExtenderControl)

Ruft eine ExtenderControl-Klasse erneut auf, um Instanzenskripts zurückzugeben, die für die Unterstützung des Clientobjekts gerendert werden müssen, das ein Clientsteuerelement, eine Clientkomponente oder ein Clientverhalten darstellt.

RegisterScriptDescriptors(IScriptControl)

Ruft eine ScriptControl-Klasse auf, um Instanzenskripts zurückzugeben, die für die Unterstützung des Clientobjekts gerendert werden müssen, das ein Clientsteuerelement, eine Clientkomponente oder ein Clientverhalten darstellt.

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

Registriert einen Startskriptblock für ein Steuerelement, das sich in einem UpdatePanel-Steuerelement befindet, mithilfe des ScriptManager-Steuerelements, und fügt den Skriptblock der Seite hinzu.

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

Registriert einen Startskriptblock für jedes asynchrone Postback beim ScriptManager-Steuerelement und fügt den Skriptblock der 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 ScriptManager-Steuerelements mithilfe des angegebenen HtmlTextWriter-Objekts im Browser.

RenderChildren(HtmlTextWriter)

Gibt den Inhalt der untergeordneten Elemente eines Serversteuerelements an ein bereitgestelltes HtmlTextWriter-Objekt aus, das den auf dem Client zu rendernden Inhalt schreibt.

(Geerbt von Control)
RenderControl(HtmlTextWriter)

Gibt Inhalte von Serversteuerelementen an ein bereitgestelltes HtmlTextWriter-Objekt aus und speichert Ablaufverfolgungsinformationen zum Steuerelement, sofern die Ablaufverfolgung aktiviert ist.

(Geerbt von Control)
RenderControl(HtmlTextWriter, ControlAdapter)

Gibt Inhalte von Serversteuerelementen mithilfe eines bereitgestellten HtmlTextWriter-Objekts an ein bereitgestelltes ControlAdapter-Objekt aus.

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

Konvertiert eine URL in eine vom anfordernden Client verwendbare URL.

(Geerbt von Control)
SaveControlState()

Speichert alle Zustandsänderungen des Serversteuerelements, die seit dem Zeitpunkt aufgetreten sind, zu dem die Seite an den Server zurückgesendet wurde.

(Geerbt von Control)
SaveViewState()

Speichert alle Ansichtszustandsänderungen des Serversteuerelements, die seit dem Zeitpunkt aufgetreten sind, zu dem die Seite an den Server zurückgesendet wurde.

(Geerbt von Control)
SetDesignModeState(IDictionary)

Legt die 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 über die ID angegebene Steuerelement fest.

SetRenderMethodDelegate(RenderMethod)

Beauftragt einen Ereignishandlerdelegaten, das Serversteuerelement und seinen Inhalt im übergeordneten Steuerelement zu rendern.

(Geerbt von Control)
SetTraceData(Object, Object)

Legt Ablaufverfolgungsdaten für die Nachverfolgung der Entwurfszeit von Rendering-Daten mithilfe des Ablaufverfolgungsdatenschlüssels und Ablaufverfolgungsdatenwerts fest.

(Geerbt von Control)
SetTraceData(Object, Object, Object)

Legt Ablaufverfolgungsdaten für die Nachverfolgung der Entwurfszeit von Rendering-Daten mithilfe des verfolgten Objekts, des Ablaufverfolgungsdatenschlüssels und Ablaufverfolgungsdatenwerts fest.

(Geerbt von Control)
ToString()

Gibt eine Zeichenfolge zurück, die das aktuelle Objekt darstellt.

(Geerbt von Object)
TrackViewState()

Veranlasst die Überwachung von Änderungen am Ansichtszustand des Serversteuerelements, sodass die Änderungen im StateBag-Objekt des Serversteuerelements gespeichert werden können. Auf dieses Objekt kann über die ViewState-Eigenschaft zugegriffen werden.

(Geerbt von Control)

Ereignisse

AsyncPostBackError

Tritt bei einem Seitenfehler während eines asynchronen Postbacks auf.

DataBinding

Tritt ein, wenn das Serversteuerelement eine Bindung an eine Datenquelle durchführt.

(Geerbt von Control)
Disposed

Tritt ein, wenn ein Serversteuerelement im Speicher freigegeben wird. Dies ist die letzte Stufe des Lebenszyklus des Serversteuerelements bei der Anforderung einer ASP.NET-Seite.

(Geerbt von Control)
Init

Tritt bei der Initialisierung des Serversteuerelements ein. Dies ist der erste Schritt in dessen Lebenszyklus.

(Geerbt von Control)
Load

Tritt ein, 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 Weiter des Browsers klickt.

PreRender

Tritt nach dem Laden des Control-Objekts, jedoch vor dem Rendern ein.

(Geerbt von Control)
ResolveCompositeScriptReference

Tritt auf, wenn ein zusammengesetztes Skript beim ScriptManager-Steuerelement registriert wird.

ResolveScriptReference

Tritt auf, wenn ein Member der Scripts-Auflistung beim ScriptManager-Steuerelement registriert wird.

Unload

Tritt ein, wenn das Serversteuerelement aus dem Speicher entladen wird.

(Geerbt von Control)

Explizite Schnittstellenimplementierungen

IControlBuilderAccessor.ControlBuilder

Eine Beschreibung dieses Elements finden Sie unter ControlBuilder.

(Geerbt von Control)
IControlDesignerAccessor.GetDesignModeState()

Eine Beschreibung dieses Elements finden Sie unter GetDesignModeState().

(Geerbt von Control)
IControlDesignerAccessor.SetDesignModeState(IDictionary)

Eine Beschreibung dieses Elements finden Sie unter SetDesignModeState(IDictionary).

(Geerbt von Control)
IControlDesignerAccessor.SetOwnerControl(Control)

Eine Beschreibung dieses Elements finden Sie unter SetOwnerControl(Control).

(Geerbt von Control)
IControlDesignerAccessor.UserData

Eine Beschreibung dieses Elements finden Sie unter UserData.

(Geerbt von Control)
IDataBindingsAccessor.DataBindings

Eine Beschreibung dieses Elements finden Sie unter DataBindings.

(Geerbt von Control)
IDataBindingsAccessor.HasDataBindings

Eine Beschreibung dieses Elements finden Sie unter HasDataBindings.

(Geerbt von Control)
IExpressionsAccessor.Expressions

Eine Beschreibung dieses Elements finden Sie unter Expressions.

(Geerbt von Control)
IExpressionsAccessor.HasExpressions

Eine Beschreibung dieses Elements finden Sie unter HasExpressions.

(Geerbt von Control)
IParserAccessor.AddParsedSubObject(Object)

Eine Beschreibung dieses Elements finden Sie unter AddParsedSubObject(Object).

(Geerbt von Control)
IPostBackDataHandler.LoadPostData(String, NameValueCollection)

Eine Beschreibung dieses Elements finden Sie unter LoadPostData(String, NameValueCollection).

IPostBackDataHandler.RaisePostDataChangedEvent()

Eine Beschreibung dieses Elements 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

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 Metatabellenobjekt für das enthaltende Datensteuerelement zurück.

Gilt für:

Weitere Informationen