WebPartManager.WebPartsDisconnecting Ereignis
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.
Tritt während des Vorgangs des Beendens der Verbindung zwischen zuvor verbundenen WebPart oder Serversteuerelementen auf.
public:
event System::Web::UI::WebControls::WebParts::WebPartConnectionsCancelEventHandler ^ WebPartsDisconnecting;public event System.Web.UI.WebControls.WebParts.WebPartConnectionsCancelEventHandler WebPartsDisconnecting;member this.WebPartsDisconnecting : System.Web.UI.WebControls.WebParts.WebPartConnectionsCancelEventHandler Public Custom Event WebPartsDisconnecting As WebPartConnectionsCancelEventHandler Ereignistyp
Hinweise
Das WebPartsDisconnecting Ereignis wird von der OnWebPartsDisconnecting Methode ausgelöst und signalisiert die Tatsache, dass ein Benutzer auf ein Verb zum Trennen geklickt hat, oder die DisconnectWebParts Methode wurde andernfalls aufgerufen. Das Ereignis bietet die Möglichkeit, den Vorgang des Beendens einer Verbindung abzubrechen, bevor sie abgeschlossen ist. Wenn die Verbindung erfolgreich beendet wurde, folgt diesem Ereignis das WebPartsDisconnected Ereignis.
Seitenentwickler können einen benutzerdefinierten Handler für das Ereignis hinzufügen, indem sie dem OnWebPartsDisconnecting Element das <asp:webpartmanager> Attribut hinzufügen und dem Attribut einen benutzerdefinierten Methodennamen zuweisen.
Wenn das WebPartsDisconnecting Ereignis normalerweise als direktes Ergebnis der Aktion eines Benutzers ausgelöst wird, die eine Verbindung beendet, kann das Ereignis abgebrochen werden. Es gibt jedoch mehrere Szenarien, in denen das Ereignis nicht abgebrochen werden kann. Das erste Szenario lautet: Wenn ein WebPartZone Steuerelement gelöscht wird, müssen die 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 es muss auch in der Lage sein, die Verbindungen aller verbundenen Steuerelemente ohne Unterbrechung zu beenden, damit er den Vorgang zum Bereinigen und Schließen aller Steuerelemente abschließen kann. Daher kann die WebPartsDisconnecting Methode in diesem Szenario nicht abgebrochen werden. Ein verwandtes Ereignis, das abgebrochen werden kann, finden Sie im WebPartClosing Ereignis.
Das zweite Szenario, in dem das WebPartsDisconnecting Ereignis nicht abgebrochen werden kann, ist der Aufruf der ActivateConnections Methode (dies wird bei jeder Anforderung an eine Seite aufgerufen), und es gibt einen Konflikttyp in den vorhandenen Verbindungen auf einer Seite. Beispielsweise verbindet ein Benutzer beispielsweise Steuerelement x mit Steuerelement y, aber ein freigegebener Benutzer verbindet Steuerelement x mit Steuerelement z, und dennoch darf Steuerelement x nicht mehrere Verbindungen bilden. In diesem Fall haben die Einstellungen des einzelnen Benutzers für die Verbindung Vorrang, und das WebPartManager Steuerelement löst den Konflikt durch Aufrufen der DisconnectWebPart Methode und Beenden der Verbindung zwischen x und z für den jeweiligen Benutzer. Da diese Trennung für die Lösung des Konflikts unerlässlich ist, kann das WebPartsDisconnecting Ereignis in diesem Szenario nicht abgebrochen werden.
Das dritte Szenario, in dem die WebPartsDisconnecting Methode nicht abgebrochen werden kann, besteht darin, dass ein aktuell WebPart verbundenes Serversteuerelement entweder gelöscht oder geschlossen wird. Da das Steuerelement definitiv von der Seite entfernt werden wird, ist es eine logische Notwendigkeit, seine Verbindung zu entfernen. Wenn das WebPartManager Steuerelement die Methode aufruft DisconnectWebPart , die wiederum das WebPartsDisconnecting Ereignis auslöst, besteht daher keine Möglichkeit, das Ereignis abzubrechen.
