WebPartManager.SelectedWebPartChanging Ereignis

  • Referenz

Definition

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

Tritt während des Prozesses ein, mit dem das auf der Webseite derzeit ausgewählte WebPart-Steuerelement oder Serversteuerelement geändert wird.

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

Ereignistyp

WebPartCancelEventHandler

Hinweise

Dieses Ereignis kann in Verbindung mit der OnSelectedWebPartChanging -Methode verwendet werden. Seitenentwickler können einen Ereignishandler in ihrem Code erstellen, indem sie das OnSelectedWebPartChanging Attribut dem <asp:webpartmanager> Element auf einer Seite hinzufügen und den Wert des Attributs auf den Namen einer benutzerdefinierten Methode festlegen, die das Ereignis behandelt.

Dieses Ereignis wird ausgelöst, wenn eine Verbindung zwischen Steuerelementen beginnt oder beendet wird, und wenn eine Bearbeitung eines Steuerelements beginnt und beendet wird. Ausführliche Informationen finden Sie in der OnSelectedWebPartChanging -Methode.

Wenn das SelectedWebPartChanging Ereignis als direktes Ergebnis der Aktion eines Benutzers ausgelöst wird, die das ausgewählte Steuerelement ändert, 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 enthaltenen Steuerelemente geschlossen werden, andernfalls wären sie verwaist. In diesem Fall schließt das WebPartManager Steuerelement die WebPart Steuerelemente, nicht der Benutzer, und es muss bestimmen, welches Steuerelement derzeit ausgewählt ist und wann die Auswahl ohne Unterbrechung geändert werden soll, damit es den Bereinigungsprozess aller Steuerelemente abschließen kann. Daher kann die SelectedWebPartChanging Methode in diesem Szenario nicht abgebrochen werden. Ein verwandtes Ereignis, das abgebrochen werden kann, finden Sie im WebPartClosing Ereignis.

Gilt für:

Weitere Informationen