Homepage Library Lernen Downloads Support Community
Anmelden | United States - English | |
Dieser Artikel wurde manuell übersetzt. Bewegen Sie den Mauszeiger über die Sätze im Artikel, um den Originaltext anzuzeigen.
Übersetzung
Original
Dieser Artikel wurde noch nicht bewertet - Dieses Thema bewerten.

ScriptManager-Klasse

.NET Framework 4

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

System.Object
  System.Web.UI.Control
    System.Web.UI.ScriptManager

Namespace:  System.Web.UI
Assembly:  System.Web.Extensions (in System.Web.Extensions.dll)
C#
C++
F#
VB
Kopieren 
public class ScriptManager : Control, 
	IPostBackDataHandler, IPostBackEventHandler
ASP.NET
Kopieren 
<asp:ScriptManager />

Der ScriptManager-Typ macht die folgenden Member verfügbar.

  Name Beschreibung
Öffentliche Methode ScriptManager Initialisiert eine neue Instanz der ScriptManager-Klasse.
Zum Seitenanfang
  Name Beschreibung
Geschützte Eigenschaft Adapter Ruft den browserspezifischen Adapter für das Steuerelement ab. (Von Control geerbt.)
Öffentliche Eigenschaft AjaxFrameworkAssembly Ruft die AJAX-Frameworkassembly ab, die von Komponenten auf der Seite verwendet wird.
Öffentliche Eigenschaft AjaxFrameworkMode Ruft einen Wert ab, durch den angegeben wird, wie Clientskripts der Microsoft Ajax-Clientbibliothek auf dem Client eingeschlossen werden, oder legt den Wert fest.
Öffentliche Eigenschaft AllowCustomErrorsRedirect Ruft einen Wert ab, der bestimmt, ob während eines Fehlers bei einem asynchronen Postback der benutzerdefinierte Fehlerabschnitt der Datei Web.config verwendet wird, oder legt diesen fest.
Öffentliche Eigenschaft AppRelativeTemplateSourceDirectory Ruft das anwendungsrelative virtuelle Verzeichnis des Page-Objekts oder des UserControl-Objekt ab, das dieses Steuerelement enthält, oder legt dieses Verzeichnis fest. (Von Control geerbt.)
Öffentliche Eigenschaft AsyncPostBackErrorMessage Ruft die Fehlermeldung ab, die bei einer unbehandelten Serverausnahme während eines asynchronen Postbacks an den Client gesendet wird, oder legt diese fest.
Öffentliche Eigenschaft AsyncPostBackSourceElementID Ruft die eindeutige ID des Steuerelements ab, das das asynchrone Postback verursacht hat.
Öffentliche Eigenschaft AsyncPostBackTimeout Ruft einen Wert ab, der die Uhrzeit in Sekunden vor dem Timeout asynchroner Postbacks abruft, wenn keine Antwort empfangen wird, oder legt diesen fest.
Öffentliche Eigenschaft AuthenticationService Ruft das AuthenticationServiceManager-Objekt ab, das der aktuellen Instanz von ScriptManager zugeordnet ist.
Öffentliche Eigenschaft BindingContainer Infrastruktur. Ruft das Steuerelement ab, das die Datenbindung dieses Steuerelements enthält. (Von Control geerbt.)
Geschützte Eigenschaft ChildControlsCreated Ruft einen Wert ab, der angibt, ob die untergeordneten Steuerelemente des Serversteuerelements erstellt wurden. (Von Control geerbt.)
Öffentliche Eigenschaft ClientID Ruft die Steuerelement-ID für HTML-Markup ab, das von ASP.NET generiert wird. (Von Control geerbt.)
Öffentliche Eigenschaft ClientIDMode Ruft den Algorithmus ab, mit dem der Wert der ClientID-Eigenschaft generiert wird, oder legt diesen fest. (Von Control geerbt.)
Geschützte Eigenschaft ClientIDSeparator Ruft einen Zeichenwert ab, der das in der ClientID-Eigenschaft verwendete Trennzeichen darstellt. (Von Control geerbt.)
Öffentliche Eigenschaft ClientNavigateHandler Ruft den Namen der Methode ab, die das Sys.Application.navigate-Ereignis für den Client behandelt, oder legt diesen fest.
Öffentliche Eigenschaft CompositeScript Ruft einen Verweis auf das zusammengesetzte Skript ab, das die Webseite unterstützt.
Geschützte Eigenschaft Context Ruft das dem Serversteuerelement für die aktuelle Webanforderung zugeordnete HttpContext-Objekt ab. (Von Control geerbt.)
Öffentliche Eigenschaft Controls Ruft ein ControlCollection-Objekt ab, das die untergeordneten Steuerelemente für ein angegebenes Serversteuerelement in der Hierarchie der Benutzeroberfläche darstellt. (Von Control geerbt.)
Öffentliche Eigenschaft DataItemContainer Ruft einen Verweis auf den Namenscontainer ab, wenn vom Namenscontainer IDataItemContainer implementiert wird. (Von Control geerbt.)
Öffentliche Eigenschaft DataKeysContainer Ruft einen Verweis auf den Namenscontainer ab, wenn vom Namenscontainer IDataKeysControl implementiert wird. (Von Control geerbt.)
Geschützte Eigenschaft DesignMode Ruft einen Wert ab, der angibt, ob ein Steuerelement auf einer Entwurfsoberfläche verwendet wird. (Von Control geerbt.)
Öffentliche Eigenschaft EmptyPageUrl Ruft eine URL zu einer Webseite ab oder legt sie fest.
Öffentliche Eigenschaft EnableCdn Bestimmt, ob auf der aktuellen Seite Clientskriptverweise aus den Pfaden des Inhaltszustellungsnetzwerks (CDN) geladen werden.
Öffentliche Eigenschaft EnableHistory Ruft einen Wert ab, der angibt, ob die Webseite die Verwaltung von Verlaufspunkten unterstützt, oder legt diesen fest.
Öffentliche Eigenschaft 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.
Öffentliche Eigenschaft EnablePartialRendering Ruft einen Wert ab, der die Teilaktualisierung einer Seite ermöglicht, wodurch Sie Bereiche der Seite mithilfe von UpdatePanel-Steuerelementen einzeln aktualisieren können, oder legt diesen fest.
Öffentliche Eigenschaft 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.
Öffentliche Eigenschaft EnableScriptLocalization Ruft Wert ab, der angibt, ob das ScriptManager-Steuerelement lokalisierte Versionen von Skriptdateien rendert, oder legt diesen fest.
Öffentliche Eigenschaft EnableSecureHistoryState Ruft einen Wert ab, der angibt, ob die Zeichenfolge für den Verlaufszustand verschlüsselt werden soll, oder legt diesen fest.
Öffentliche Eigenschaft EnableTheming Ruft einen Wert ab, der angibt, ob für dieses Steuerelement Designs gelten, oder legt diesen fest. (Von Control geerbt.)
Öffentliche Eigenschaft 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. (Von Control geerbt.)
Geschützte Eigenschaft Events Ruft eine Liste von Ereignishandlerdelegaten für das Steuerelement ab. Diese Eigenschaft ist schreibgeschützt. (Von Control geerbt.)
Geschützte Eigenschaft HasChildViewState Ruft einen Wert ab, der angibt, ob in den untergeordneten Steuerelementen des aktuellen Serversteuerelements gespeicherte Einstellungen für den Ansichtszustand vorhanden sind. (Von Control geerbt.)
Öffentliche Eigenschaft ID Ruft den programmgesteuerten Bezeichner ab, der dem Serversteuerelement zugewiesen ist, oder legt diesen fest. (Von Control geerbt.)
Geschützte Eigenschaft IdSeparator Infrastruktur. Ruft das als Trennzeichen für Steuerelementbezeichner verwendete Zeichen ab. (Von Control geerbt.)
Geschützte Eigenschaft IsChildControlStateCleared Ruft einen Wert ab, der angibt, ob in diesem Steuerelements enthaltene Steuerelemente über einen Steuerelementzustand verfügen. (Von Control geerbt.)
Öffentliche Eigenschaft IsDebuggingEnabled Ruft einen Wert ab, der angibt, ob die Debugversionen von Clientskriptbibliotheken gerendert werden.
Öffentliche Eigenschaft IsInAsyncPostBack Ruft einen Wert ab, der angibt, ob das aktuelle Postback im Teilrenderingmodus ausgeführt wird.
Öffentliche Eigenschaft IsNavigating Ruft einen Wert ab, der angibt, ob gegenwärtig ein Navigate-Ereignis behandelt wird.
Geschützte Eigenschaft IsTrackingViewState Ruft einen Wert ab, der angibt, ob das Serversteuerelement Änderungen des Ansichtszustands speichert. (Von Control geerbt.)
Geschützte Eigenschaft IsViewStateEnabled Ruft einen Wert ab, der angibt, ob der Ansichtszustand für dieses Steuerelement aktiviert ist. (Von Control geerbt.)
Öffentliche Eigenschaft LoadScriptsBeforeUI Ruft einen Wert ab, der angibt, ob Skripts vor oder nach dem Laden von Markup für die Seiten-UI geladen werden, oder legt diesen fest.
Geschützte Eigenschaft LoadViewStateByID Ruft einen Wert ab, der angibt, ob das Steuerelement seinen Ansichtszustand über ID anstatt über den Index lädt. (Von Control geerbt.)
Öffentliche Eigenschaft NamingContainer Ruft einen Verweis auf den Benennungscontainer des Serversteuerelements ab, der einen eindeutigen Namespace erstellt, damit zwischen Serversteuerelementen mit demselben Control.ID-Eigenschaftswert unterschieden werden kann. (Von Control geerbt.)
Öffentliche Eigenschaft Page Ruft einen Verweis auf die Page-Instanz ab, die das Serversteuerelement enthält. (Von Control geerbt.)
Öffentliche Eigenschaft Parent Ruft einen Verweis auf das übergeordnete Steuerelement des Serversteuerelements in der Steuerelementhierarchie der Seite ab. (Von Control geerbt.)
Öffentliche Eigenschaft ProfileService Ruft das ProfileServiceManager-Objekt ab, das der aktuellen Instanz von ScriptManager zugeordnet ist.
Öffentliche Eigenschaft RenderingCompatibility Ruft einen Wert ab, der die ASP.NET-Version angibt, mit der gerenderte HTML-Objekte kompatibel sind. (Von Control geerbt.)
Öffentliche Eigenschaft RoleService Ruft das RoleServiceManager-Objekt ab, das der aktuellen Instanz von ScriptManager zugeordnet ist.
Öffentliche Eigenschaft ScriptMode Ruft einen Wert ab, der angibt, ob Debug- oder Releaseversionen von Clientskriptbibliotheken gerendert werden.
Öffentliche Eigenschaft ScriptPath Veraltet. Ruft den Stammpfad des zum Erstellen der Pfade zu ASP.NET AJAX und benutzerdefinierten Skriptdateien verwendeten Verzeichnisses ab oder legt diesen fest.
Öffentliche Eigenschaft Statischer Member ScriptResourceMapping Ruft ein ScriptResourceMapping-Objekt ab.
Öffentliche Eigenschaft Scripts Ruft ein ScriptReferenceCollection-Objekt ab, das die ScriptReference-Objekte enthält, die jeweils eine für den Client gerenderte Skriptdatei darstellen.
Öffentliche Eigenschaft 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.
Öffentliche Eigenschaft Site Ruft Informationen zum Container ab, der das aktuelle Steuerelement hostet, wenn es auf einer Entwurfsoberfläche gerendert wird. (Von Control geerbt.)
Öffentliche Eigenschaft SkinID Ruft die Skin ab, die auf das Steuerelement angewendet werden soll, oder legt diese fest. (Von Control geerbt.)
Öffentliche Eigenschaft SupportsPartialRendering Ruft einen Wert ab, der angibt, ob der Client das Teilrendering von Seiten unterstützt.
Öffentliche Eigenschaft TemplateControl Ruft einen Verweis auf die Vorlage ab, die dieses Steuerelement enthält, oder legt den Verweis fest. (Von Control geerbt.)
Öffentliche Eigenschaft TemplateSourceDirectory Ruft das virtuelle Verzeichnis der Page oder des UserControl ab, in dem das aktuelle Serversteuerelement enthalten ist. (Von Control geerbt.)
Öffentliche Eigenschaft UniqueID Ruft den eindeutigen, hierarchisierten Bezeichner für das Serversteuerelement ab. (Von Control geerbt.)
Geschützte Eigenschaft 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. (Von Control geerbt.)
Geschützte Eigenschaft ViewStateIgnoresCase Ruft einen Wert ab, der angibt, ob bei dem StateBag-Objekt die Groß- und Kleinschreibung nicht berücksichtigt wird. (Von Control geerbt.)
Öffentliche Eigenschaft ViewStateMode Ruft den Ansichtszustandsmodus des Steuerelements ab oder legt ihn fest. (Von Control geerbt.)
Öffentliche Eigenschaft Visible Überschreibt die Visible-Eigenschaft, die von der Control-Basisklasse geerbt wurde, um das Festlegen dieses Werts zu verhindern. (Überschreibt Control.Visible.)
Zum Seitenanfang
  Name Beschreibung
Geschützte Methode AddedControl Wird aufgerufen, nachdem ein untergeordnetes Steuerelement der Controls-Auflistung des Control-Objekts hinzugefügt wurde. (Von Control geerbt.)
Öffentliche Methode AddHistoryPoint(NameValueCollection, String) Erstellt einen Verlaufspunkt und fügt diesen unter Verwendung der angegebenen Zustandsdatenauflistung und des Zustandstitels dem Verlaufsstapel des Browsers hinzu.
Öffentliche Methode AddHistoryPoint(String, String) Erstellt einen Verlaufspunkt und fügt diesen unter Verwendung des angegebenen Schlüssels und des Zustandswerts dem Verlaufsstapel des Browsers hinzu.
Öffentliche Methode AddHistoryPoint(String, String, String) Erstellt einen Verlaufspunkt und fügt diesen unter Verwendung des angegebenen Schlüssels, des Zustandswerts und des Zustandstitels dem Verlaufsstapel des Browsers hinzu.
Geschützte Methode AddParsedSubObject Benachrichtigt das Serversteuerelement, dass entweder ein XML- oder ein HTML-Element analysiert wurde, und fügt das Element dem ControlCollection-Objekt des Serversteuerelements hinzu. (Von Control geerbt.)
Öffentliche Methode ApplyStyleSheetSkin Übernimmt die im Stylesheet der Seite definierten Stileigenschaften für das Steuerelement. (Von Control geerbt.)
Geschützte Methode BuildProfileTree Infrastruktur. Sammelt Informationen zum Serversteuerelement und übermittelt sie an die Trace-Eigenschaft, sodass diese angezeigt werden, wenn die Ablaufverfolgung für die Seite aktiviert ist. (Von Control geerbt.)
Geschützte Methode ClearCachedClientID Infrastruktur. Legt den zwischengespeicherten ClientID-Wert auf null fest. (Von Control geerbt.)
Geschützte Methode ClearChildControlState Löscht die Informationen zum Steuerelementzustand für die untergeordneten Steuerelemente des Serversteuerelements. (Von Control geerbt.)
Geschützte Methode ClearChildState Löscht die Informationen zum Ansichtszustand sowie zum Steuerelementzustand für alle untergeordneten Steuerelemente des Serversteuerelements. (Von Control geerbt.)
Geschützte Methode ClearChildViewState Löscht die Informationen über den Ansichtszustand für alle untergeordneten Steuerelemente des Serversteuerelements. (Von Control geerbt.)
Geschützte Methode ClearEffectiveClientIDMode Infrastruktur. Legt die ClientIDMode-Eigenschaft der aktuellen Steuerelementinstanz und aller untergeordneten Steuerelemente auf Inherit fest. (Von Control geerbt.)
Geschützte Methode CreateChildControls Wird vom ASP.NET-Seitenframework aufgerufen, um Serversteuerelemente mit kompositionsbasierter Implementierung zu benachrichtigen, dass alle enthaltenen untergeordneten Steuerelemente als Vorbereitung auf einen Postback oder ein Rendering erstellt werden sollen. (Von Control geerbt.)
Geschützte Methode CreateControlCollection Erstellt ein neues ControlCollection-Objekt, das die untergeordneten Steuerelemente (literale und Serversteuerelemente) des Serversteuerelements aufnehmen soll. (Von Control geerbt.)
Öffentliche Methode DataBind() Bindet eine Datenquelle an das aufgerufene Serversteuerelement und an alle untergeordneten Steuerelemente. (Von Control geerbt.)
Geschützte Methode DataBind(Boolean) Bindet eine Datenquelle an das aufgerufene Serversteuerelement und alle untergeordneten Steuerelemente mit der Option, das DataBinding-Ereignis auszulösen. (Von Control geerbt.)
Geschützte Methode DataBindChildren Bindet eine Datenquelle an die untergeordneten Steuerelemente des Serversteuerelements. (Von Control geerbt.)
Öffentliche Methode Dispose Ermöglicht es einem Serversteuerelement, die letzte Bereinigung durchzuführen, bevor es aus dem Speicher freigegeben wird. (Von Control geerbt.)
Geschützte Methode EnsureChildControls Stellt fest, ob das Serversteuerelement untergeordnete Steuerelemente enthält. Wenn das nicht der Fall ist, werden untergeordnete Steuerelemente erstellt. (Von Control geerbt.)
Geschützte Methode EnsureID Erstellt einen Bezeichner für Steuerelemente, die nicht über einen zugewiesenen Bezeichner verfügen. (Von Control geerbt.)
Öffentliche Methode Equals(Object) Bestimmt, ob das angegebene Object und das aktuelle Object gleich sind. (Von Object geerbt.)
Geschützte Methode Finalize Gibt einem Objekt Gelegenheit zu dem Versuch, Ressourcen freizugeben und andere Bereinigungen durchzuführen, bevor es von der automatische Speicherbereinigung freigegeben wird. (Von Object geerbt.)
Öffentliche Methode FindControl(String) Durchsucht den aktuellen Benennungscontainer nach dem angegebenen Serversteuerelement mit dem angegebenen id-Parameter. (Von Control geerbt.)
Geschützte Methode FindControl(String, Int32) Infrastruktur. 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. (Von Control geerbt.)
Öffentliche Methode Focus Legt den Eingabefokus auf ein Steuerelement fest. (Von Control geerbt.)
Öffentliche Methode Statischer Member GetCurrent Ruft die Instanz von ScriptManager für ein angegebenes Page-Objekt ab.
Geschützte Methode GetDesignModeState Infrastruktur. Ruft die Entwurfszeitdaten für ein Steuerelement ab. (Von Control geerbt.)
Öffentliche Methode GetHashCode Fungiert als Hashfunktion für einen bestimmten Typ. (Von Object geerbt.)
Öffentliche Methode GetRegisteredArrayDeclarations Ruft eine schreibgeschützte Auflistung von ECMAScript (JavaScript)-Arraydeklarationen ab, die vorher beim Page-Objekt registriert wurden.
Öffentliche Methode GetRegisteredClientScriptBlocks Ruft eine schreibgeschützte Auflistung von Clientskriptblöcken ab, die vorher beim ScriptManager-Steuerelement registriert wurden.
Öffentliche Methode GetRegisteredDisposeScripts Ruft eine schreibgeschützte Auflistung von dispose-Skripts ab, die vorher beim Page-Objekt registriert wurden.
Öffentliche Methode GetRegisteredExpandoAttributes Ruft eine schreibgeschützte Auflistung von benutzerdefinierten Attributen (expando) ab, die vorher beim Page-Objekt registriert wurden.
Öffentliche Methode GetRegisteredHiddenFields Ruft eine schreibgeschützte Auflistung von ausgeblendeten Feldern ab, die vorher beim Page-Objekt registriert wurden.
Öffentliche Methode GetRegisteredOnSubmitStatements Ruft eine schreibgeschützte Auflistung von onsubmit-Anweisungen ab, die vorher beim Page-Objekt registriert wurden.
Öffentliche Methode GetRegisteredStartupScripts Ruft eine schreibgeschützte Auflistung von Startskripts ab, die vorher beim Page-Objekt registriert wurden.
Öffentliche Methode GetRouteUrl(Object) Ruft die URL ab, die einem Satz von Routenparametern entspricht. (Von Control geerbt.)
Öffentliche Methode GetRouteUrl(RouteValueDictionary) Ruft die URL ab, die einem Satz von Routenparametern entspricht. (Von Control geerbt.)
Öffentliche Methode GetRouteUrl(String, Object) Ruft die URL ab, die einem Satz von Routenparametern und einem Routennamen entspricht. (Von Control geerbt.)
Öffentliche Methode GetRouteUrl(String, RouteValueDictionary) Ruft die URL ab, die einem Satz von Routenparametern und einem Routennamen entspricht. (Von Control geerbt.)
Öffentliche Methode GetStateString Ruft eine Zeichenfolge mit Schlüssel-Wert-Paaren ab, die den Zustand der Webseite darstellen.
Öffentliche Methode GetType Ruft den Type der aktuellen Instanz ab. (Von Object geerbt.)
Öffentliche Methode GetUniqueIDRelativeTo Gibt den mit einem Präfix versehenen Abschnitt der UniqueID-Eigenschaft des angegebenen Steuerelements zurück. (Von Control geerbt.)
Öffentliche Methode HasControls Ermittelt, ob das Serversteuerelement untergeordnete Steuerelemente enthält. (Von Control geerbt.)
Geschützte Methode HasEvents Gibt einen Wert zurück, der angibt, ob Ereignisse für das Steuerelement oder für untergeordnete Steuerelemente registriert werden. (Von Control geerbt.)
Geschützte Methode IsLiteralContent Infrastruktur. Ermittelt, ob das Serversteuerelement nur literalen Inhalt enthält. (Von Control geerbt.)
Geschützte Methode LoadControlState Stellt die Informationen zum Steuerelementzustand aus einer früheren Seitenanforderung wieder her, die durch die SaveControlState-Methode gespeichert wurden. (Von Control geerbt.)
Geschützte Methode LoadPostData Liest vom Browser an den Server gesendete Formulardaten und ermittelt die Quelle des asynchronen Postbacks.
Geschützte Methode LoadViewState Stellt die Informationen zum Ansichtszustand aus einer früheren Seitenanforderung wieder her, die durch die SaveViewState-Methode gespeichert wurden. (Von Control geerbt.)
Geschützte Methode MapPathSecure Ruft den physikalischen Pfad ab, auf den ein absoluter bzw. relativer virtueller Pfad verweist. (Von Control geerbt.)
Geschützte Methode MemberwiseClone Erstellt eine flache Kopie des aktuellen Object. (Von Object geerbt.)
Geschützte Methode OnAsyncPostBackError Löst das AsyncPostBackError-Ereignis aus.
Geschützte Methode OnBubbleEvent Bestimmt, ob das Ereignis für das Serversteuerelement in der Serversteuerelementhierarchie der Benutzeroberfläche der Seite nach oben weitergegeben wird. (Von Control geerbt.)
Geschützte Methode OnDataBinding Löst das DataBinding-Ereignis aus. (Von Control geerbt.)
Geschützte Methode OnInit Löst das Init-Ereignis aus und stellt sicher, dass auf der Seite nur ein einzelnes ScriptManager-Steuerelement vorhanden ist. (Überschreibt Control.OnInit(EventArgs).)
Geschützte Methode OnLoad Löst das Load-Ereignis aus. (Von Control geerbt.)
Geschützte Methode OnPreRender Löst das PreRender-Ereignis aus und registriert Skriptdateien und Dienste für Teilaktualisierungen von Seiten. (Überschreibt Control.OnPreRender(EventArgs).)
Geschützte Methode OnResolveCompositeScriptReference Löst das ResolveCompositeScriptReference-Ereignis aus.
Geschützte Methode OnResolveScriptReference Löst das ResolveScriptReference-Ereignis für jeden Skriptverweis aus, der vom ScriptManager-Steuerelement verwaltet wird.
Geschützte Methode OnUnload Löst das Unload-Ereignis aus. (Von Control geerbt.)
Geschützte Methode OpenFile Ruft einen Stream zum Lesen einer Datei ab. (Von Control geerbt.)
Geschützte Methode RaiseBubbleEvent Weist dem übergeordneten Element des Steuerelements alle Ereignisquellen und zugehörige Informationen zu. (Von Control geerbt.)
Geschützte Methode RaisePostBackEvent Verarbeitet ein Postbackereignis, das vom ScriptManager-Steuerelement ausgelöst wurde, und lädt den Verlaufszustand der Webseite.
Geschützte Methode RaisePostDataChangedEvent Löst Ereignisse für das ScriptManager-Steuerelement aus, wenn ein Postback an den Server ausgeführt wird.
Öffentliche Methode Statischer Member 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.
Öffentliche Methode Statischer Member 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.
Öffentliche Methode RegisterAsyncPostBackControl Registriert ein Steuerelement als Trigger für asynchrone Postbacks.
Öffentliche Methode Statischer Member 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 dann den Skriptblock der Seite hinzu.
Öffentliche Methode Statischer Member 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 dann den Skriptblock der Seite hinzu.
Öffentliche Methode Statischer Member RegisterClientScriptInclude(Control, Type, String, String) Registriert eine Clientscriptdatei 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.
Öffentliche Methode Statischer Member RegisterClientScriptInclude(Page, Type, String, String) Registriert Clientskripts bei jedem asynchronen Postback beim ScriptManager-Steuerelement und fügt der Seite dann einen Skriptdateiverweis hinzu.
Öffentliche Methode Statischer Member 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.
Öffentliche Methode Statischer Member RegisterClientScriptResource(Page, Type, String) Registriert eine in einer Assembly eingebettete Clientskriptdatei bei jedem asynchronen Postback beim ScriptManager-Steuerelement.
Öffentliche Methode RegisterDataItem(Control, String) Sendet während des Teilrenderings von Seiten benutzerdefinierte Daten an ein Steuerelement.
Öffentliche Methode 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.
Öffentliche Methode RegisterDispose Registriert ein dispose-Skript für ein Steuerelement in einem UpdatePanel-Steuerelement. Das Skript wird ausgeführt, wenn das UpdatePanel-Steuerelement aktualisiert oder gelöscht wird.
Öffentliche Methode Statischer Member RegisterExpandoAttribute Registriert ein Name-Wert-Paar beim ScriptManager-Steuerelement als benutzerdefiniertes Attribut (Expando-Attribut) eines angegebenen Steuerelements.
Öffentliche Methode RegisterExtenderControl<TExtenderControl> Registriert ein Extendersteuerelement bei der aktuellen Instanz von ScriptManager.
Öffentliche Methode Statischer Member RegisterHiddenField(Control, String, String) Registriert ein ausgeblendetes Feld beim UpdatePanel-Steuerelement für ein Steuerelement, das sich in einem ScriptManager-Steuerelement befindet.
Öffentliche Methode Statischer Member RegisterHiddenField(Page, String, String) Registriert ein ausgeblendetes Feld bei jedem asynchronen Postback beim ScriptManager-Steuerelement.
Öffentliche Methode Statischer Member RegisterOnSubmitStatement(Control, Type, String, String) Registriert ECMAScript-Code (JavaScript), der beim Senden des Formulars ausgeführt wird, beim ScriptManager-Steuerelement für ein Steuerelement, das mit einem UpdatePanel-Steuerelements verwendet wird.
Öffentliche Methode Statischer Member RegisterOnSubmitStatement(Page, Type, String, String) Registriert ECMAScript-Code (JavaScript), der beim Senden des Formulars ausgeführt wird, beim ScriptManager-Steuerelement für ein Steuerelement, das mit einem UpdatePanel-Steuerelements verwendet wird.
Öffentliche Methode RegisterPostBackControl 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.
Öffentliche Methode RegisterScriptControl<TScriptControl> Registriert ein Skriptsteuerelement bei der aktuellen Instanz von ScriptManager.
Öffentliche Methode 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.
Öffentliche Methode 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.
Öffentliche Methode Statischer Member 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.
Öffentliche Methode Statischer Member 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.
Geschützte Methode RemovedControl Wird aufgerufen, nachdem ein untergeordnetes Steuerelement aus der Controls-Auflistung des Control-Objekts entfernt wurde. (Von Control geerbt.)
Geschützte Methode Render Rendert den Inhalt des ScriptManager-Steuerelements mithilfe des angegebenen HtmlTextWriter-Objekts im Browser. (Überschreibt Control.Render(HtmlTextWriter).)
Geschützte Methode RenderChildren Gibt den Inhalt der untergeordneten Elemente eines Serversteuerelements an ein bereitgestelltes HtmlTextWriter-Objekt aus, das den Inhalt zum Rendern auf den Client schreibt. (Von Control geerbt.)
Öffentliche Methode RenderControl(HtmlTextWriter) Gibt den Inhalt des Serversteuerelements an ein angegebenes HtmlTextWriter-Objekt aus und speichert Ablaufverfolgungsinformationen zum Steuerelement, sofern die Ablaufverfolgung aktiviert ist. (Von Control geerbt.)
Geschützte Methode RenderControl(HtmlTextWriter, ControlAdapter) Gibt Inhalte von Serversteuerelementen mithilfe eines bereitgestellten ControlAdapter-Objekts an ein bereitgestelltes HtmlTextWriter-Objekt aus. (Von Control geerbt.)
Geschützte Methode ResolveAdapter Ruft den Steuerelementadapter ab, der für das Rendern des angegebenen Steuerelements verantwortlich ist. (Von Control geerbt.)
Öffentliche Methode ResolveClientUrl Ruft eine URL ab, die vom Browser verwendet werden kann. (Von Control geerbt.)
Öffentliche Methode ResolveUrl Konvertiert eine URL in eine vom anfordernden Client verwendbare URL. (Von Control geerbt.)
Geschützte Methode SaveControlState Speichert alle Änderungen am Zustand des Serversteuerelements, die seit dem letzten Postback der Seite an den Server aufgetreten sind. (Von Control geerbt.)
Geschützte Methode SaveViewState Speichert alle Änderungen am Ansichtszustand des Serversteuerelements, die seit dem letzten Postback der Seite an den Server aufgetreten sind. (Von Control geerbt.)
Geschützte Methode SetDesignModeState Legt Entwurfszeitdaten für ein Steuerelement fest. (Von Control geerbt.)
Öffentliche Methode SetFocus(Control) Legt den Browserfokus auf das angegebene Steuerelement fest.
Öffentliche Methode SetFocus(String) Legt den Browserfokus auf das über die ID angegebene Steuerelement fest.
Öffentliche Methode SetRenderMethodDelegate Infrastruktur. Beauftragt einen Ereignishandlerdelegaten, das Serversteuerelement und seinen Inhalt im übergeordneten Steuerelement zu rendern. (Von Control geerbt.)
Öffentliche Methode ToString Gibt eine Zeichenfolge zurück, die das aktuelle Objekt darstellt. (Von Object geerbt.)
Geschützte Methode 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 Control.ViewState-Eigenschaft zugegriffen werden. (Von Control geerbt.)
Zum Seitenanfang
  Name Beschreibung
Öffentliches Ereignis AsyncPostBackError Tritt bei einem Seitenfehler während eines asynchronen Postbacks auf.
Öffentliches Ereignis DataBinding Tritt ein, wenn das Serversteuerelement eine Bindung an eine Datenquelle durchführt. (Von Control geerbt.)
Öffentliches Ereignis 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. (Von Control geerbt.)
Öffentliches Ereignis Init Tritt bei der Initialisierung des Serversteuerelements ein. Dies ist der erste Schritt in dessen Lebenszyklus. (Von Control geerbt.)
Öffentliches Ereignis Load Tritt ein, wenn das Serversteuerelement in das Page-Objekt geladen wird. (Von Control geerbt.)
Öffentliches Ereignis Navigate Tritt auf, wenn der Benutzer auf die Schaltfläche Zurück oder Weiter des Browsers klickt.
Öffentliches Ereignis PreRender Tritt nach dem Laden des Control-Objekts, jedoch vor dem Rendern ein. (Von Control geerbt.)
Öffentliches Ereignis ResolveCompositeScriptReference Tritt auf, wenn ein zusammengesetztes Skript beim ScriptManager-Steuerelement registriert wird.
Öffentliches Ereignis ResolveScriptReference Tritt auf, wenn ein Member der Scripts-Auflistung beim ScriptManager-Steuerelement registriert wird.
Öffentliches Ereignis Unload Tritt ein, wenn das Serversteuerelement aus dem Speicher entladen wird. (Von Control geerbt.)
Zum Seitenanfang
  Name Beschreibung
Öffentliche Erweiterungsmethode FindDataSourceControl Gibt die Datenquelle zurück, die dem Datensteuerelement für das angegebene Steuerelement zugeordnet ist. (Durch DynamicDataExtensions definiert.)
Öffentliche Erweiterungsmethode FindFieldTemplate Gibt die Feldvorlage für die angegebene Spalte im Benennungscontainer des angegebenen Steuerelements zurück. (Durch DynamicDataExtensions definiert.)
Öffentliche Erweiterungsmethode FindMetaTable Gibt das Metatabellenobjekt für das enthaltende Datensteuerelement zurück. (Durch DynamicDataExtensions definiert.)
Zum Seitenanfang
  Name Beschreibung
Explizite Schnittstellenimplementierung Private Eigenschaft IControlBuilderAccessor.ControlBuilder Eine Beschreibung dieses Members finden Sie unter der IControlBuilderAccessor.ControlBuilder-Methode. (Von Control geerbt.)
Explizite Schnittstellenimplementierung Private Methode IControlDesignerAccessor.GetDesignModeState Eine Beschreibung dieses Members finden Sie unter der IControlDesignerAccessor.GetDesignModeState-Methode. (Von Control geerbt.)
Explizite Schnittstellenimplementierung Private Methode IControlDesignerAccessor.SetDesignModeState Eine Beschreibung dieses Members finden Sie unter der IControlDesignerAccessor.SetDesignModeState-Methode. (Von Control geerbt.)
Explizite Schnittstellenimplementierung Private Methode IControlDesignerAccessor.SetOwnerControl Infrastruktur. Eine Beschreibung dieses Members finden Sie unter der IControlDesignerAccessor.SetOwnerControl-Methode. (Von Control geerbt.)
Explizite Schnittstellenimplementierung Private Eigenschaft IControlDesignerAccessor.UserData Eine Beschreibung dieses Members finden Sie unter der IControlDesignerAccessor.UserData-Methode. (Von Control geerbt.)
Explizite Schnittstellenimplementierung Private Eigenschaft IDataBindingsAccessor.DataBindings Eine Beschreibung dieses Members finden Sie unter der IDataBindingsAccessor.DataBindings-Methode. (Von Control geerbt.)
Explizite Schnittstellenimplementierung Private Eigenschaft IDataBindingsAccessor.HasDataBindings Eine Beschreibung dieses Members finden Sie unter der IDataBindingsAccessor.HasDataBindings-Methode. (Von Control geerbt.)
Explizite Schnittstellenimplementierung Private Eigenschaft IExpressionsAccessor.Expressions Eine Beschreibung dieses Members finden Sie unter der IExpressionsAccessor.Expressions-Methode. (Von Control geerbt.)
Explizite Schnittstellenimplementierung Private Eigenschaft IExpressionsAccessor.HasExpressions Eine Beschreibung dieses Members finden Sie unter der IExpressionsAccessor.HasExpressions-Methode. (Von Control geerbt.)
Explizite Schnittstellenimplementierung Private Methode IParserAccessor.AddParsedSubObject Eine Beschreibung dieses Members finden Sie unter IParserAccessor.AddParsedSubObject. (Von Control geerbt.)
Explizite Schnittstellenimplementierung Private Methode IPostBackDataHandler.LoadPostData Eine Beschreibung dieses Members finden Sie unter IPostBackDataHandler.LoadPostData.
Explizite Schnittstellenimplementierung Private Methode IPostBackDataHandler.RaisePostDataChangedEvent Eine Beschreibung dieses Members finden Sie unter IPostBackDataHandler.RaisePostDataChangedEvent.
Explizite Schnittstellenimplementierung Private Methode IPostBackEventHandler.RaisePostBackEvent Ermöglicht es dem ScriptManager-Steuerelement, ein Postbackereignis zu verarbeiten und den Verlaufszustand der Webseite zu laden.
Zum Seitenanfang

In diesem Thema:

Einführung

Das ScriptManager-Steuerelement ist für die AJAX-Funktionalität in ASP.NET unerlässlich. Das Steuerelement verwaltet alle ASP.NET-Ajax-Ressourcen auf einer Seite. Dazu zählen das Herunterladen von Microsoft Ajax Library-Skripts in den Browser und das Koordinieren von Teilaktualisierungen von Seiten, die mithilfe von UpdatePanel-Steuerelementen aktiviert werden. Außerdem ermöglicht Ihnen das ScriptManager-Steuerelement Folgendes:

  • Registrieren eines Skripts, das mit Teilaktualisierungen von Seiten kompatibel ist. Um den Abhängigkeiten zwischen dem Skript und der Kernbibliothek zu entsprechen, werden alle von Ihnen registrierten Skripts nach dem Microsoft Ajax Library-Skript geladen.

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

  • Stellen Sie den Zugriff auf Webdienstmethoden von Skripts bereit, indem Sie Webdienste beim ScriptManager-Steuerelement registrieren.

  • Stellen Sie den Zugriff auf ASP.NET-Authentifizierungs-, Rollen- und Profilanwendungsdienste von Clientskripts bereit, indem Sie diese Dienste beim ScriptManager-Steuerelement registrieren.

  • Aktivieren Sie die kulturspezifische Anzeige von ECMAScript-Funktionen (JavaScript) für Date, Number und String im Browser.

  • Greifen Sie auf Lokalisierungsressourcen für eingebettete Skriptdateien oder für eigenständige Skriptdateien zu, indem Sie die ResourceUICultures-Eigenschaft des ScriptReference-Steuerelements verwenden.

  • Registrieren Sie Serversteuerelemente, die die IExtenderControl-Schnittstelle oder die IScriptControl-Schnittstelle implementieren, beim ScriptManager-Steuerelement, sodass von Clientkomponenten und Verhalten angeforderte Skripts gerendert werden.

Teilrendering von Seiten

Die Fähigkeit einer ASP.NET-Seite, Teilrendering von Seiten zu unterstützen, wird von den folgenden Faktoren beeinflusst:

Sie können den Wert der EnablePartialRendering-Eigenschaft zur Laufzeit während oder vor dem Init-Ereignis der Seite festlegen. Wenn Sie versuchen, diese Eigenschaft nach dem Init-Ereignis der Seite zu ändern, wird eine InvalidOperationException-Ausnahme ausgelöst.

Wenn Teilrendering von Seiten unterstützt wird, rendert das ScriptManager-Steuerelement Skripts, um asynchrone Postbacks und Teilaktualisierungen von Seiten zu aktivieren. Die zu aktualisierenden Bereiche der Seite werden mithilfe von UpdatePanel-Steuerelementen festgelegt. Das ScriptManager-Steuerelement behandelt die asynchronen Postbacks und aktualisiert nur die Bereiche der Seite, die aktualisiert werden müssen. Weitere Informationen zum Teilrendering von Seiten finden Sie unter Übersicht über das Teilrendering von Seiten. Weitere Informationen zu den Bedingungen, die zu einer Aktualisierung führen, finden Sie unter Übersicht über das UpdatePanel-Steuerelement.

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

In der Hierarchie einer Seite kann nur ein ScriptManager-Steuerelement enthalten sein. Wenn Sie Dienste und Skripts für geschachtelte Seiten, Benutzersteuerelemente oder Komponenten registrieren möchten, wenn die übergeordnete Seite bereits ein ScriptManager-Steuerelement aufweist, verwenden Sie das ScriptManagerProxy-Steuerelement. Weitere Informationen finden Sie unter Verwenden des ASP.NET-UpdatePanel-Steuerelements mit Masterseiten.

Skriptverwaltung und Registrierung

Das ScriptManager-Steuerelement ermöglicht es Ihnen, Skripts zu registrieren, die dann als Teil der Seite gerendert werden. Die Registrierungsmethoden für das ScriptManager-Steuerelement können in die folgenden drei Kategorien eingeteilt werden:

  • Registrierungsmethoden, die garantieren, dass die Abhängigkeiten des Skripts von Microsoft Ajax Library beibehalten werden.

  • Registrierungsmethoden, die nicht von Microsoft Ajax Library abhängig, jedoch 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 von benutzerdefiniertem Clientskript mithilfe der Microsoft AJAX-Bibliothek.

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

Mit den folgenden Methoden können Sie Skriptdateien so registrieren, dass sämtliche Abhängigkeiten von Microsoft Ajax Library garantiert beibehalten werden. 

Methode

Definition

RegisterScriptControl<TScriptControl>

Registriert ein Serversteuerelement, das die zum Definieren eines Sys.Component-Clientobjekts verwendete IScriptControl-Schnittstelle implementiert. Das ScriptManager-Steuerelement rendert Skripts, die das Clientobjekt unterstützen.

RegisterExtenderControl<TExtenderControl>

Registriert ein Serversteuerelement, das die zum Definieren eines Sys.UI.Behavior-Clientobjekts verwendete IExtenderControl-Schnittstelle implementiert. Das ScriptManager-Steuerelement rendert Skripts, die das Clientobjekt unterstützen.

Registrieren mit Teilaktualisierungen von Seiten kompatibler Skripts

Mit den folgenden Methoden können Sie Skriptdateien registrieren, die nicht von Microsoft Ajax Library abhängig, jedoch mit UpdatePanel-Steuerelementen kompatibel sind. Diese Methoden entsprechen ähnlichen Methoden des ClientScriptManager-Steuerelements. 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. Falls das Array noch nicht vorhanden ist, wird dieses erstellt.

RegisterClientScriptBlock

Rendert nach dem öffnenden <form>-Tag der Seite ein script-Element. Das Skript wird als Zeichenfolgenparameter angegeben.

RegisterClientScriptInclude

Rendert nach dem öffnenden <form>-Tag der Seite ein script-Element. Der Skriptinhalt wird durch Festlegen des src-Attributs auf eine URL angegeben, die auf eine Skriptdatei zeigt.

RegisterClientScriptResource

Rendert nach dem öffnenden <form>-Tag der Seite ein script-Element. Der Skriptinhalt wird mit einem Ressourcennamen in einer Assembly angegeben. Das src-Attribut wird durch einen Aufruf eines HTTP-Handlers, der das benannte Skript von der Assembly abruft, automatisch mit einer URL gefüllt.

RegisterExpandoAttribute

Rendert ein benutzerdefiniertes Name-Wert-Attributpaar (Expando-Attribute) im Markup zu einem angegebenen Steuerelement.

RegisterHiddenField

Rendert ein ausgeblendetes Feld.

RegisterOnSubmitStatement

Registriert ein Skript, das in Antwort auf das submit-Ereignis des form-Elements ausgeführt wird. Das onSubmit-Attribut verweist auf das angegebene Skript.

RegisterStartupScript

Rendert direkt vor dem schließenden </form>-Tag der Seite einen Startskriptblock. Das zu rendernde Skript wird als Zeichenfolgenparameter angegeben.

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

Vermeiden Sie es beim Aufrufen der RegisterClientScriptInclude-Methode oder der RegisterClientScriptResource-Methode, Skripts zu registrieren, die Inlinefunktionen ausführen. Registrieren Sie stattdessen Skripts, die Funktionsdefinitionen enthalten, z. B. Ereignishandler oder benutzerdefinierte Klassendefinitionen für die Anwendung.

Registrierungsmethoden für UpdatePanel-Steuerelemente

Mit den folgenden Methoden können Sie Teilaktualisierungen von Seiten anpassen, wenn Sie UpdatePanel-Steuerelemente verwenden.

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 Freigabeskript für ein Steuerelement in einem UpdatePanel-Steuerelement. Das Skript wird ausgeführt, wenn das UpdatePanel-Steuerelement aktualisiert oder gelöscht wird. Die Freigabemethode wird für Clientkomponenten verwendet, die Teil von Microsoft Ajax Library 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, die andernfalls asynchrone Postbacks ausführen würden.

Webdienstverweise

Sie können einen Webdienst registrieren, sodass dieser von Clientskripts aufgerufen werden kann, indem Sie ein ServiceReference-Objekt erstellen und dieses 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 ServiceReference-Objekte hinzufügen, um zur Laufzeit Webdienste zu registrieren.

Weitere Informationen zum Zugreifen auf Webdienste in Skripts finden Sie unter Verfügbarmachen von Webdiensten, Clientskript und Aufrufen von Webdiensten von Clientskripts

Lokalisierung

Das ScriptManager-Steuerelement generiert Verweise auf der gerenderten Seite, die auf die entsprechenden lokalisierten Skriptdateien zeigen, d. h. in Assemblys eingebettete oder eigenständige Skriptdateien.

Wenn die EnableScriptLocalization-Eigenschaft auf true festgelegt ist, ruft das ScriptManager-Steuerelement für die aktuelle Kultur lokalisierte Ressourcen (z. B. lokalisierte Zeichenfolgen) ab, sofern solche vorhanden sind. Das ScriptManager-Steuerelement stellt die folgende Funktionalität für die Verwendung lokalisierter Ressourcen bereit:

  • In einer Assembly eingebettete Skriptdateien. Das ScriptManager-Steuerelement bestimmt die Skriptdatei der spezifischen Kultur oder Fallbackkultur, die an den Browser gesendet werden soll. Dazu werden das kulturspezifische NeutralResourcesLanguageAttribute-Assemblyattribut, die mit der Assembly gepackten Ressourcen sowie die UI-Kultur des Browsers (sofern vorhanden) verwendet.

  • Eigenständige Skriptdateien. Das ScriptManager-Steuerelement definiert die Liste der unterstützten UI-Kulturen durch Verwendung der ResourceUICultures-Eigenschaft des ScriptReference-Objekts.

  • Im Debugmodus. Das ScriptManager-Steuerelement versucht, eine kulturspezifische Skriptdatei mit Debuginformationen zu rendern. Wenn sich z. B. die Seite im Debugmodus befindet und die aktuelle Kultur auf en-MX festgelegt ist, rendert das Steuerelement eine mit scriptname.en-MX.debug.js benannte Skriptdatei, sofern eine solche 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 die Übersicht über Komponentenbibliotheken.

Fehlerbehandlung

Bei einem Seitenfehler während asynchroner Postbacks 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 benutzerdefinierten Fehlerabschnitt der Datei Web.config ab. Weitere Informationen finden Sie unter Anpassen der Fehlerbehandlung für ASP.NET-UpdatePanel-Steuerelemente.

Deklarative Syntax

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

In den folgenden Beispielen werden unterschiedliche Szenarios für die Verwendung des ScriptManager-Steuerelements veranschaulicht.

Aktivieren von Teilaktualisierungen von Seiten

Im folgenden Beispiel wird veranschaulicht, wie mit dem ScriptManager-Steuerelement Teilaktualisierungen von Seiten ermöglicht werden. In diesem Beispiel befinden sich ein Calendar-Steuerelement und ein DropDownList-Steuerelement in einem UpdatePanel-Steuerelement. In der Standardeinstellung sind der Wert der UpdateMode-Eigenschaft auf Always und der Wert der ChildrenAsTriggers-Eigenschaft auf true festgelegt. Deshalb bewirken untergeordnete Steuerelemente des Bereichs ein asynchrones Postback.

C#
VB
Kopieren 


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

Behandeln von Fehlern bei der Teilaktualisierung von Seiten und Registrieren von Skripts

Das folgende Beispiel zeigt, wie während der Teilaktualisierung von Seiten eine benutzerdefinierte Fehlerbehandlung bereitgestellt wird. Wenn während der Teilaktualisierung von Seiten ein Fehler auftritt, wird in der Standardeinstellung ein JavaScript-Meldungsfeld angezeigt. Im folgenden Beispiel wird veranschaulicht, wie die benutzerdefinierte Fehlerbehandlung durch Bereitstellen eines Handlers für das AsyncPostBackError-Ereignis und Festlegen der AsyncPostBackErrorMessage-Eigenschaft im Ereignishandler verwendet wird. Sie können auch die AllowCustomErrorsRedirect-Eigenschaft festlegen, um anzugeben, wie der benutzerdefinierte Fehlerabschnitt der Datei Web.config bei einem Fehler während der Teilaktualisierung von Seiten verwendet wird. In diesem Beispiel wird der Standardwert der AllowCustomErrorsRedirect-Eigenschaft verwendet. Wenn die Datei Web.config ein customErrors-Element enthält, bestimmt dieses Element daher, wie Fehler angezeigt werden. Weitere Informationen finden Sie unter customErrors-Element (ASP.NET-Einstellungsschema).

C#
VB
Kopieren 

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

Globalisieren des im Browser angezeigten Datums und der Uhrzeit

Im folgenden Beispiel wird veranschaulicht, wie die EnableScriptGlobalization-Eigenschaft so festgelegt wird, dass Clientskripts im Browser eine kulturspezifische Kombination von Datum und Uhrzeit anzeigen können. Im Beispiel wird das Culture-Attribut der @ Page-Direktive auf auto festgelegt. Dadurch bestimmt die erste in den aktuellen Browsereinstellungen angegebene Sprache die Kultur und die UI-Kultur der Seite. Weitere Informationen finden Sie unter Gewusst wie: Festlegen der Kultur und der Kultur der Benutzeroberfläche für die Globalisierung von ASP.NET-Webseiten.

C#
VB
Kopieren 

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

.NET Framework

Unterstützt in: 4, 3.5

Windows 7, Windows Vista SP1 oder höher, Windows XP SP3, Windows Server 2008 (Server Core wird nicht unterstützt), Windows Server 2008 R2 (Server Core wird mit SP1 oder höher unterstützt), Windows Server 2003 SP2

.NET Framework unterstützt nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen für .NET Framework.
Alle öffentlichen static (Shared in Visual Basic)-Member dieses Typs sind threadsicher. Bei Instanzmembern ist die Threadsicherheit nicht gewährleistet.
Fanden Sie dies hilfreich?
(1500 verbleibende Zeichen)
Community-Inhalt Hinzufügen
Anmerkungen FAQ
Microsoft führt eine Onlineumfrage durch, um Ihre Meinung zur MSDN-Website zu erfahren. Wenn Sie sich zur Teilnahme entscheiden, wird Ihnen die Onlineumfrage angezeigt, sobald Sie die MSDN-Website verlassen.

Möchten Sie an der Umfrage teilnehmen?
Informationen zur Datensicherheit