WebPartManager.BeginWebPartConnecting(WebPart) Méthode

  • Référence

Définition

Espace de noms:
System.Web.UI.WebControls.WebParts
Assembly:
System.Web.dll

Démarre le processus de connexion de deux contrôles WebPart.

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)

Paramètres

webPart
WebPart

Contrôle pour lequel la connexion est formée.

Exceptions

ArgumentNullException

webPart a la valeur null.

InvalidOperationException

Le mode d'affichage actuel sur la page n'est pas ConnectDisplayMode.

ArgumentException

webPart est fermé.

- ou -

webPart ne fait pas partie de la collection Controls.

ou

webPart est égal au contrôle SelectedWebPart.

Remarques

La BeginWebPartConnecting méthode existe afin que le processus de formation des connexions entre les contrôles puisse être effectué dans des phases distinctes, ce qui donne aux développeurs plus de contrôle sur le processus de connexion. La méthode effectue un ensemble de vérifications initiales pour s’assurer que webPart se trouve dans un état où une connexion peut légitimement être formée. Si webPart toutes les vérifications réussissent, il est alors défini comme le contrôle actuellement sélectionné (voir la SelectedWebPart propriété ) et le processus de connexion peut continuer.

Notes pour les héritiers

Les développeurs qui ont besoin d’étendre le WebPartManager contrôle peuvent vouloir remplacer cette méthode dans une classe dérivée. Une approche consiste à appeler la méthode de base, puis à ajouter une gestion personnalisée supplémentaire ; ou vous pouvez personnaliser complètement le processus de démarrage d’une connexion entre les contrôles. Par exemple, vous pouvez vérifier que certaines données sont disponibles avant de créer la connexion.

S’applique à

Voir aussi