WebPartManager.ConnectWebParts, méthode (WebPart, ProviderConnectionPoint, WebPart, ConsumerConnectionPoint, WebPartTransformer)
Mise à jour : novembre 2007
Crée une connexion entre deux contrôles WebPart ou GenericWebPart à l'aide des références aux contrôles, de leurs objets ConnectionPoint spécifiés et d'un objet WebPartTransformer.
Assembly : System.Web (dans System.Web.dll)
public virtual WebPartConnection ConnectWebParts( WebPart provider, ProviderConnectionPoint providerConnectionPoint, WebPart consumer, ConsumerConnectionPoint consumerConnectionPoint, WebPartTransformer transformer )
public WebPartConnection ConnectWebParts( WebPart provider, ProviderConnectionPoint providerConnectionPoint, WebPart consumer, ConsumerConnectionPoint consumerConnectionPoint, WebPartTransformer transformer )
public function ConnectWebParts( provider : WebPart, providerConnectionPoint : ProviderConnectionPoint, consumer : WebPart, consumerConnectionPoint : ConsumerConnectionPoint, transformer : WebPartTransformer ) : WebPartConnection
Paramètres
- provider
- Type : System.Web.UI.WebControls.WebParts.WebPart
WebPart dont le rôle est de fournir des données à un autre contrôle connecté.
- providerConnectionPoint
- Type : System.Web.UI.WebControls.WebParts.ProviderConnectionPoint
Méthode publique dans provider qui est marquée avec un attribut de métadonnées ConnectionProvider et qui sert de méthode de rappel pour la connexion.
- consumer
- Type : System.Web.UI.WebControls.WebParts.WebPart
WebPart dont le rôle est de recevoir des données de provider ou de transformer et de les traiter ou de les afficher.
- consumerConnectionPoint
- Type : System.Web.UI.WebControls.WebParts.ConsumerConnectionPoint
Méthode publique dans consumer qui est marquée avec un attribut de métadonnées ConnectionConsumer et se connecte avec providerConnectionPoint pour recevoir les données pour la connexion.
- transformer
- Type : System.Web.UI.WebControls.WebParts.WebPartTransformer
WebPartTransformer qui active une connexion entre deux contrôles en convertissant les données de provider dans un format pouvant être traité par consumer.
Valeur de retour
Type : System.Web.UI.WebControls.WebParts.WebPartConnectionWebPartConnection qui contient les informations relatives au fournisseur, au consommateur et au transformateur nécessaires pour une connexion.
| Exception | Condition |
|---|---|
| InvalidOperationException | Des connexions ont déjà été activées dans PreRender. |
La surcharge ConnectWebParts(WebPart, ProviderConnectionPoint, WebPart, ConsumerConnectionPoint, WebPartTransformer) est utilisée pour connecter des contrôles lorsque leurs points de connexion sont incompatibles. L'incompatibilité se produit lorsque consumer implémente une interface différente de provider comme point de connexion. Le transformateur convertit les données en un type compréhensible par consumer.
Windows Vista, Windows XP SP2, Windows XP Media Center Edition, Windows XP Professionnel Édition x64, Windows XP Starter Edition, Windows Server 2003, Windows Server 2000 SP4, Windows Millennium Edition, Windows 98
Le .NET Framework et le .NET Compact Framework ne prennent pas en charge toutes les versions de chaque plateforme. Pour obtenir la liste des versions prises en charge, consultez Configuration requise du .NET Framework.