WebPartConnectionsEventArgs Klasse

Definition

Stellt die Ereignisdaten für das WebPartsConnected-Ereignis und das WebPartsDisconnected-Ereignis des WebPartManager-Steuerelements bereit.

public ref class WebPartConnectionsEventArgs : EventArgs
public class WebPartConnectionsEventArgs : EventArgs
type WebPartConnectionsEventArgs = class
    inherit EventArgs
Public Class WebPartConnectionsEventArgs
Inherits EventArgs
Vererbung
WebPartConnectionsEventArgs

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)

Gilt für:

Weitere Informationen