WebPartManager.WebPartClosing Ereignis

  • Referenz

Definition

Namespace:
System.Web.UI.WebControls.WebParts
Assembly:
System.Web.dll

Tritt ein, während ein WebPart-Steuerelement (oder ein Server- bzw. Benutzersteuerelement) von einer Seite entfernt wird.

public:
 event System::Web::UI::WebControls::WebParts::WebPartCancelEventHandler ^ WebPartClosing;
public event System.Web.UI.WebControls.WebParts.WebPartCancelEventHandler WebPartClosing;
member this.WebPartClosing : System.Web.UI.WebControls.WebParts.WebPartCancelEventHandler 
Public Custom Event WebPartClosing As WebPartCancelEventHandler

Ereignistyp

WebPartCancelEventHandler

Hinweise

Das WebPartClosing -Ereignis wird von der OnWebPartClosing -Methode ausgelöst, wenn das WebPartManager Steuerelement gerade ein Steuerelement schließt. Wenn das Entfernen des Steuerelements erfolgreich ist, folgt auf dieses Ereignis das WebPartClosed -Ereignis.

Seitenentwickler können einen benutzerdefinierten Handler für das Ereignis bereitstellen, indem sie dem OnWebPartClosed -Element auf einer Seite das <asp:webpartmanager> -Attribut hinzufügen und dem Attribut einen benutzerdefinierten Methodennamen zuweisen.

Wenn das WebPartClosing Ereignis als direktes Ergebnis des Schließens WebPart eines Steuerelements durch einen Benutzer ausgelöst wird, kann das Ereignis in der Regel abgebrochen werden. Es gibt jedoch ein Szenario, in dem das Ereignis nicht abgebrochen werden kann. Wenn ein WebPartZone Steuerelement gelöscht wird, müssen alle WebPart darin enthaltenen Steuerelemente geschlossen werden, andernfalls wären sie verwaist. In diesem Fall schließt das WebPartManager Steuerelement die WebPart Steuerelemente, nicht der Benutzer. Und wenn das WebPartManager -Steuerelement gerade die CloseWebPart -Methode aufruft, um jedes Steuerelement zu schließen, und das WebPartClosing Ereignis ausgelöst wird, kann das Ereignis (entwurfsbedingt) nicht abgebrochen werden, da die WebPartManager Aufgabe zum Bereinigen aller Steuerelemente der Zone abgeschlossen werden muss.

Gilt für:

Weitere Informationen