WebPartManager.BeginWebPartConnecting(WebPart) Methode

  • Referenz

Definition

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

Startet den Prozess, mit dem zwei WebPart-Steuerelemente miteinander verbunden werden.

public:
 virtual void BeginWebPartConnecting(System::Web::UI::WebControls::WebParts::WebPart ^ webPart);
public virtual void BeginWebPartConnecting (System.Web.UI.WebControls.WebParts.WebPart webPart);
abstract member BeginWebPartConnecting : System.Web.UI.WebControls.WebParts.WebPart -> unit
override this.BeginWebPartConnecting : System.Web.UI.WebControls.WebParts.WebPart -> unit
Public Overridable Sub BeginWebPartConnecting (webPart As WebPart)

Parameter

webPart
WebPart

Das Steuerelement, für das die Verbindung gebildet wird.

Ausnahmen

ArgumentNullException

webPart ist null.

InvalidOperationException

Der aktuelle Anzeigemodus auf der Seite lautet nicht ConnectDisplayMode.

ArgumentException

Der webPart ist geschlossen.

- oder -

webPart gehört nicht der Controls-Auflistung an.

- oder -

webPart ist identisch mit dem SelectedWebPart-Steuerelement.

Hinweise

Die BeginWebPartConnecting -Methode ist vorhanden, sodass der Prozess des Herstellens von Verbindungen zwischen Steuerelementen in unterschiedlichen Phasen durchgeführt werden kann, sodass Entwickler mehr Kontrolle über den Verbindungsprozess erhalten. Die Methode führt eine Reihe von anfänglichen Überprüfungen durch, um sicherzustellen, dass sich in einem Zustand befindet, webPart in dem eine Verbindung legitim hergestellt werden kann. Wenn webPart alle Überprüfungen übergeben werden, wird es als das aktuell ausgewählte Steuerelement festgelegt (siehe die SelectedWebPart -Eigenschaft), und der Verbindungsvorgang kann fortgesetzt werden.

Hinweise für Vererber

Entwickler, die das WebPartManager Steuerelement erweitern müssen, möchten diese Methode möglicherweise in einer abgeleiteten Klasse überschreiben. Ein Ansatz wäre, die Basismethode aufzurufen und dann zusätzliche benutzerdefinierte Behandlung hinzuzufügen. Oder Sie können den Prozess zum Starten einer Verbindung zwischen Steuerelementen vollständig anpassen. Sie können beispielsweise überprüfen, ob bestimmte Daten verfügbar sind, bevor Sie die Verbindung erstellen.

Gilt für:

Weitere Informationen