WebPartConnectionsEventArgs Klasse
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.
Stellt die Ereignisdaten für das WebPartsConnected-Ereignis und das WebPartsDisconnected-Ereignis des WebPartManager-Steuerelements bereit.
public ref class WebPartConnectionsEventArgs : EventArgspublic class WebPartConnectionsEventArgs : EventArgstype WebPartConnectionsEventArgs = class
inherit EventArgsPublic Class WebPartConnectionsEventArgs
Inherits EventArgs- Vererbung
Hinweise
Mithilfe der Funktionen des Webparts-Steuerelementsatzes ist es möglich, eine Verbindung zwischen zwei WebPart oder anderen Serversteuerelementen herzustellen, wobei ein Steuerelement als Anbieter und das andere als Consumer von Daten fungiert. Zum Herstellen einer Verbindung müssen sich die beiden Steuerelemente in einer Zone befinden, die von der WebPartZoneBase -Klasse erbt (z. B. das WebPartZone -Steuerelement), und sie müssen ordnungsgemäß so konzipiert sein, dass Daten über eine gemeinsame Schnittstelle freigegeben werden. Ausführliche Informationen zu Webpartverbindungen finden Sie unter WebPartConnectionUnd Webpartverbindungen Übersicht.
Die WebPartConnectionsEventArgs -Klasse übergibt Ereignisdaten an Methoden, die den WebPartConnectionsEventHandler Delegat verwenden, um Ereignisse zu behandeln. Es gibt zwei solche verbindungsbezogenen Methoden, die Ereignisse auslösen und die WebPartConnectionsEventArgs -Klasse verwenden, um Ereignisdaten bereitzustellen. Beide sind Elemente des Steuerelements WebPartManager . Die OnWebPartsConnected -Methode löst das WebPartsConnected Ereignis aus, nachdem zwei Serversteuerelemente erfolgreich verbunden wurden, und die OnWebPartsDisconnected -Methode löst das WebPartsDisconnected Ereignis aus, nachdem zwei Serversteuerelemente getrennt wurden.
Entwickler können benutzerdefinierte Ereignishandlermethoden für die WebPartsConnected Ereignisse und WebPartsDisconnected erstellen, und in diesen Methoden können sie die WebPartConnectionsEventArgs -Klasse verwenden, um auf Details einer Verbindung zuzugreifen. Beispielsweise kann ein Entwickler das Attribut für das OnWebPartsConnected<asp:webpartmanager> -Element deklarieren und ihm einen benutzerdefinierten Methodennamen zuweisen, der das Ereignis behandelt. In der benutzerdefinierten Handlermethode können Entwickler auf die Details einer Verbindung zugreifen, indem sie das WebPartConnectionsEventArgs -Objekt verwenden, das als Parameter an die -Methode übergeben wird.
Die WebPartConnectionsEventArgs -Klasse verfügt über zwei Überladungen des Konstruktors. Der WebPartConnectionsEventArgs.WebPartConnectionsEventArgs(WebPart, ProviderConnectionPoint, WebPart, ConsumerConnectionPoint) Konstruktor ist der Standardwert. Er initialisiert die Eigenschaftswerte für die -Klasse. Der WebPartConnectionsEventArgs.WebPartConnectionsEventArgs(WebPart, ProviderConnectionPoint, WebPart, ConsumerConnectionPoint, WebPartConnection) Konstruktor ruft den parameterlosen Konstruktor auf und initialisiert dann auch die Connection Eigenschaft.
Die WebPartConnectionsEventArgs -Klasse verfügt über mehrere Eigenschaften, die alle auf die wesentlichen Aspekte einer Webpartverbindung verweisen. Die Connection -Eigenschaft verweist auf das zugeordnete WebPartConnection Objekt, das die gesamte Verbindung darstellt. Die Provider -Eigenschaft verweist auf ein WebPart oder ein anderes Serversteuerelement, das als Anbieter in der Verbindung fungiert, und die Consumer -Eigenschaft verweist auf ein WebPart Oder-Serversteuerelement, das als Consumer fungiert. Die ProviderConnectionPoint -Eigenschaft verweist auf das Objekt der ProviderConnectionPoint Verbindung, während die ConsumerConnectionPoint -Eigenschaft auf das ConsumerConnectionPoint -Objekt verweist.
Konstruktoren
| WebPartConnectionsEventArgs(WebPart, ProviderConnectionPoint, WebPart, ConsumerConnectionPoint) |
Initialisiert eine neue Instanz der WebPartConnectionsEventArgs-Klasse, ohne dass ein WebPartConnection-Objekt erforderlich ist. |
| WebPartConnectionsEventArgs(WebPart, ProviderConnectionPoint, WebPart, ConsumerConnectionPoint, WebPartConnection) |
Initialisiert eine neue Instanz der Klasse unter Verwendung des angegebenen WebPartConnection-Objekts. |
Eigenschaften
| Connection |
Ruft das WebPartConnection-Objekt der aktuellen Verbindung ab. |
| Consumer |
Ruft das WebPart-Steuerelement ab, das in der Verbindung als Consumer fungiert. |
| ConsumerConnectionPoint |
Ruft das ConsumerConnectionPoint-Objekt der aktuellen Verbindung ab. |
| Provider |
Ruft das WebPart-Steuerelement ab, das in der Verbindung als Anbieter fungiert. |
| ProviderConnectionPoint |
Ruft das ProviderConnectionPoint-Objekt der aktuellen Verbindung ab. |
Methoden
| Equals(Object) |
Bestimmt, ob das angegebene Objekt gleich dem aktuellen Objekt ist. (Geerbt von Object) |
| GetHashCode() |
Fungiert als Standardhashfunktion. (Geerbt von Object) |
| GetType() |
Ruft den Type der aktuellen Instanz ab. (Geerbt von Object) |
| MemberwiseClone() |
Erstellt eine flache Kopie des aktuellen Object. (Geerbt von Object) |
| ToString() |
Gibt eine Zeichenfolge zurück, die das aktuelle Objekt darstellt. (Geerbt von Object) |
