Freigeben über


ScriptManager.RegisterDispose(Control, String) Methode

Definition

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.

public:
 void RegisterDispose(System::Web::UI::Control ^ control, System::String ^ disposeScript);
public void RegisterDispose (System.Web.UI.Control control, string disposeScript);
member this.RegisterDispose : System.Web.UI.Control * string -> unit
Public Sub RegisterDispose (control As Control, disposeScript As String)

Parameter

control
Control

Das Steuerelement, für das das dispose-Skript vorgesehen ist.

disposeScript
String

Das dispose-Skript.

Ausnahmen

control ist null.

- oder - disposeScript ist null.

control wurde auf der Seite nicht gefunden.

- oder - control befindet sich nicht in einem UpdatePanel-Steuerelement.

Hinweise

Verwenden Sie die RegisterDispose Methode, um Skripts für Steuerelemente zu registrieren dispose , die sich innerhalb eines UpdatePanel Steuerelements befinden. Während asynchroner Postbacks UpdatePanel können Steuerelemente aktualisiert, gelöscht oder erstellt werden. Wenn ein Panel aktualisiert oder gelöscht wird, werden alle dispose Skripts, die für Steuerelemente registriert sind UpdatePanel , aufgerufen. In typischen Seitenentwicklungsszenarien müssen Sie die RegisterDispose Methode nicht aufrufen.

Die RegisterDispose Methode soll von Steuerelemententwicklern verwendet werden, um Skripts zu registrieren oder Steuerelemente zu erstellen, die von der IScriptControl Schnittstelle erben. Sie können beispielsweise ein Skript verwenden, wenn Sie ein dispose Clientsteuerelement mithilfe der Komposition entwickeln. In Ihrem Steuerelement implementieren IScriptControl und rendern Sie einzelne Steuerelemente. Sie registrieren die dispose Methode eines Elements, das keiner definierten Clientkomponente entspricht, z Sys.TextBox. B. . Wenn Ihr benutzerdefiniertes Steuerelement Elemente erstellt, die Clientkomponenten in der Microsoft Ajax-Bibliothek entsprechen, müssen Sie kein dispose Skript registrieren, da dispose automatisch aufgerufen wird. Verwenden Sie daher die RegisterDispose Methode für Clientkomponenten, die Teil der Microsoft Ajax-Bibliothek sind, und müssen Ressourcen freigeben, wenn eine Komponente nicht mehr verwendet wird.

Die RegisterDispose Methode kann mehrmals für ein Steuerelement aufgerufen werden. Mehrere Skripts werden aggregiert. Die Reihenfolge des Verordnens von Skripts entspricht der Reihenfolge, in der die Skripts registriert wurden.

Wenn Sie ein dispose Skript für ein Steuerelement registrieren, das sich nicht in einem UpdatePanel Steuerelement befindet, wird eine Ausnahme ausgelöst. Das dispose Skript wird zwischen den pageLoading pageLoaded Ereignissen der PageRequestManager Klasse aufgerufen.

Gilt für

Siehe auch