WebPartManager.BeginWebPartConnecting(WebPart) Methode
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.
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
webPart
ist null
.
Der aktuelle Anzeigemodus auf der Seite lautet nicht ConnectDisplayMode.
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.