WebPartManager.BeginWebPartConnecting(WebPart) Méthode
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
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
webPart
a la valeur null
.
Le mode d'affichage actuel sur la page n'est pas ConnectDisplayMode.
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.