Freigeben über


WebPartManager.WebPartsDisconnecting Ereignis

Definition

Tritt ein, während die Verbindung zwischen zuvor verbundenen WebPart-Steuerelementen oder Serversteuerelementen beendet wird.

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, dass ein Benutzer auf ein Verbindungsverb geklickt hat, oder dass die DisconnectWebParts Methode anderweitig aufgerufen wurde. Das Ereignis bietet die Möglichkeit, den Vorgang des Beendens einer Verbindung abzubrechen, bevor er abgeschlossen ist. Wenn die Verbindung erfolgreich beendet wurde, folgt auf dieses Ereignis das WebPartsDisconnected Ereignis.

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

Wenn das WebPartsDisconnecting Ereignis als direktes Ergebnis der Aktion eines Benutzers ausgelöst wird, die eine Verbindung beendet, kann das Ereignis in der Regel abgebrochen werden. Es gibt jedoch mehrere Szenarien, in denen das Ereignis nicht abgebrochen werden kann. Das erste Szenario ist: Wenn ein WebPartZone Steuerelement gelöscht wird, müssen die WebPart enthaltenen Steuerelemente alle 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 Die Gefahr einer Unterbrechung zu beenden, damit es den Vorgang des Bereinigens und Schließens 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 z. B. bei jeder Anforderung an eine Seite aufgerufen), und es gibt einen Konflikt in den vorhandenen Verbindungen auf einer Seite. Beispielsweise kann ein Benutzer steuerelement x mit Steuerelement y verbinden, 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, indem es die DisconnectWebPart -Methode aufruft und die Verbindung zwischen x und z für den jeweiligen Benutzer beendet. Da diese Trennung für die Konfliktlösung 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, ist, wenn ein WebPart Oder-Serversteuerelement, das derzeit verbunden ist, entweder gelöscht oder geschlossen wird. Da das Steuerelement definitiv von der Seite entfernt wird, ist es eine logische Notwendigkeit, die Verbindung zu entfernen. Wenn das Steuerelement also die WebPartManagerDisconnectWebPart -Methode aufruft, die wiederum das WebPartsDisconnecting Ereignis auslöst, besteht standardmäßig keine Möglichkeit, das Ereignis abzubrechen.

Gilt für:

Weitere Informationen