ScriptManager Klasse
Definition
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, 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 IPostBackEventHandlerPublic Class ScriptManager
Inherits Control
Implements IPostBackDataHandler, IPostBackEventHandler- Vererbung
- Attribute
- Implementiert
Beispiele
Die folgenden Beispiele zeigen verschiedene Szenarien für die Verwendung des Steuerelements ScriptManager .
Aktivieren Partial-Page Updates
Im folgenden Beispiel wird gezeigt, 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 von Skripts
Im folgenden Beispiel wird gezeigt, wie sie benutzerdefinierte Fehlerbehandlung bei Teilweiseaktualisierungen von Seiten bereitstellen. Wenn bei teilweisen Seitenupdates 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 "Benutzerdefinierte Fehler" der Web.config-Datei verwendet wird, wenn ein Fehler während teilseitiger Aktualisierungen auftritt. In diesem Beispiel wird der Standardwert der AllowCustomErrorsRedirect -Eigenschaft verwendet. Dies bedeutet, dass dieses Element bestimmt, wie Fehler angezeigt werden, wenn die datei Web.config ein customErrors-Element enthält. Weitere Informationen finden Sie unter customErrors-Element (ASP.NET Einstellungsschema).
<%@ 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
Im folgenden Beispiel wird gezeigt, wie die EnableScriptGlobalization Eigenschaft so festgelegt wird, dass ein Clientskript ein kulturspezifisches Datum und eine bestimmte Uhrzeit im Browser anzeigen kann. Im Beispiel ist das Culture Attribut der @ Page-Anweisung auf autofestgelegt. Daher bestimmt die erste Sprache, die in den aktuellen Browsereinstellungen angegeben ist, die Kultur und die 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.
<%@ 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 auf Seiten, die mithilfe UpdatePanel von Steuerelementen aktiviert werden. Darüber hinaus können Sie mit dem ScriptManager Steuerelement folgendes tun:
Registrieren Eines Skripts, das mit partiellen Seitenupdates kompatibel ist. Um Abhängigkeiten zwischen Ihrem Skript und der Kernbibliothek zu verwalten, wird jedes von Ihnen registrierte Skript nach dem Skript der Microsoft AJAX-Bibliothek geladen.
Geben Sie an, ob Release- oder Debugskripts an den Browser gesendet werden.
Gewähren Sie über skriptbasierten Zugriff auf Webdienstmethoden, 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 von ECMAScript (JavaScript) Datums-, Zahlen- und Zeichenfolgenfunktionen 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 Schnittstellen oder IScriptControl mit dem ScriptManager -Steuerelement implementieren, sodass skripts, die von Clientkomponenten und -verhalten benötigt werden, gerendert wird.
Partial-Page Rendering
Die Fähigkeit einer ASP.NET Seite, teilseitiges Rendern von Seiten zu unterstützen, wird durch die folgenden Faktoren gesteuert:
Die ScriptManager -Eigenschaft des Steuerelements EnablePartialRendering muss (der Standardwert) sein
true.Auf der Seite muss mindestens ein UpdatePanel Steuerelement vorhanden sein.
Die SupportsPartialRendering -Eigenschaft muss (der Standardwert) sein
true. Wenn die SupportsPartialRendering Eigenschaft nicht explizit festgelegt ist, basiert ihr Wert auf Browserfunktionen.
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 Seite Init aufgetreten ist, wird eine InvalidOperationException Ausnahme ausgelöst.
Wenn partielles Rendern von Seiten unterstützt wird, rendert das ScriptManager Steuerelement Skript, um asynchrone Postbacks und partielle Seitenupdates zu aktivieren. Die Regionen der zu aktualisierenden Seite werden mithilfe UpdatePanel von Steuerelementen festgelegt. Das ScriptManager Steuerelement verarbeitet die asynchronen Postbacks und aktualisiert nur die Regionen der Seite, die aktualisiert werden müssen. Weitere Informationen zum Teilrendering von Seiten finden Sie unter Partielles Seitenrendering– Übersicht. 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 darf 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 skripts registrieren, das dann als Teil der Seite gerendert wird. Die ScriptManager Kontrollregistrierungsmethoden können in die folgenden drei Kategorien unterteilt werden:
Registrierungsmethoden, die garantieren, dass Skriptabhängigkeiten von der Microsoft Ajax-Bibliothek beibehalten werden.
Registrierungsmethoden, die nicht von der Microsoft Ajax-Bibliothek abhängig sind, aber mit Steuerelementen UpdatePanel 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 Schnittstelle implementiert, die IScriptControl 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 Schnittstelle implementiert, die IExtenderControl zum Definieren eines Sys.Component-Clientobjekts verwendet wird. Das ScriptManager Steuerelement rendert ein Skript, das das Clientobjekt unterstützt. |
Registrieren Partial-Page Aktualisieren 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 für die Verwendung in einem UpdatePanel Steuerelement 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 direkt vor dem schließenden </form> Tag der Seite. Das zu renderde 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-/Ressourcennamenpaar 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. Doppelte Registrierung von Arraywerten ist zulässig.
Wenn Sie die RegisterClientScriptInclude - oder - RegisterClientScriptResource Methode aufrufen, vermeiden Sie die 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 Teilaktualisierungen von Seiten 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 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 es 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 über 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 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 Fallbackkulturskriptdatei 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-MX festgelegt ist, rendert das Steuerelement eine Skriptdatei mit einem Namen wie
scriptname.en-MX.debug.js, sofern 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, wie Fehler auf dem Server an den Client gesendet werden, hängt von der AllowCustomErrorsRedirect -Eigenschaft, der AsyncPostBackErrorMessage -Eigenschaft und dem benutzerdefinierten Fehlerabschnitt 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 |
| 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 |
| FindControl(String, Int32) |
Durchsucht den aktuellen Benennungscontainer nach einem Serversteuerelement mit der angegebenen |
| 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 |
| 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 |
| 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 |
| 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
Feedback
Bald verfügbar: Im Laufe des Jahres 2024 werden wir GitHub-Issues stufenweise als Feedbackmechanismus für Inhalte abbauen und durch ein neues Feedbacksystem ersetzen. Weitere Informationen finden Sie unter https://aka.ms/ContentUserFeedback.
Feedback senden und anzeigen für