Comment : déclarer une connexion statique entre deux contrôles WebPart

Article
10/22/2014

Mise à jour : novembre 2007

Les développeurs peuvent créer une connexion de WebParts statique entre deux contrôles serveur en déclarant la connexion dans le format de persistance de page. Une connexion statique devient un objet permanent sur une page Web, comme un contrôle déclaré. Tous les utilisateurs peuvent consulter une connexion statique (parce qu'il s'agit d'un objet partagé) et ils ne peuvent jamais supprimer l'objet de connexion, bien qu'ils puissent le déconnecter si cela est permis dans les options d'interface utilisateur. Les connexions statiques sont une option intéressante lorsque vous souhaitez une connexion qui soit toujours disponible à l'ensemble des utilisateurs et que vous ne souhaitez pas que les utilisateurs aient la possibilité de la supprimer de la page. Pour plus d'informations sur les connections, consultez WebPartConnection et Vue d'ensemble des connexions des WebParts. Pour plus d'informations sur les connexions statiques, consultez IsStatic. Cette rubrique montre comment créer une connexion statique entre deux contrôles WebPart.

Remarque :
Cette rubrique traite de la déclaration d'une connexion statique dans le balisage d'une page Web. Pour déclarer une connexion de WebParts statique entre deux contrôles serveur, les contrôles doivent être conçus correctement pour gérer des connexions et ils doivent résider dans une zone WebPartZoneBase. Pour une description complète des configurations requises pour les contrôles qui participent aux connexions, consultez WebPartConnection. Pour obtenir l'exemple de code pour les deux contrôles WebPart et la page Web utilisée pour héberger la connexion statique qui est présentée dans cette rubrique, consultez la section Exemple de la propriété IsStatic.

Cette rubrique traite de la déclaration d'une connexion statique dans le balisage d'une page Web. Pour déclarer une connexion de WebParts statique entre deux contrôles serveur, les contrôles doivent être conçus correctement pour gérer des connexions et ils doivent résider dans une zone WebPartZoneBase. Pour une description complète des configurations requises pour les contrôles qui participent aux connexions, consultez WebPartConnection. Pour obtenir l'exemple de code pour les deux contrôles WebPart et la page Web utilisée pour héberger la connexion statique qui est présentée dans cette rubrique, consultez la section Exemple de la propriété IsStatic.

Pour déclarer des contrôles serveur dans une zone

Ajoutez un élément <webpartzone> dans la section de corps de la page Web qui contiendra votre connexion et ajoutez un élément <zonetemplate> enfant pour contenir les contrôles serveur que vous ajoutez à la zone. Le code doit ressembler à l'exemple suivant :
```
<asp:WebPartZone ID="WebPartZone1" >
  <ZoneTemplate>
  </ZoneTemplate>
</asp:WebPartZone>
```
Entre les balises de l'élément <zonetemplate>, déclarez les contrôles serveur qui agiront comme les contrôles fournisseur et consommateur dans une connexion de WebParts. Ces contrôles doivent déjà être conçus pour participer aux connexions. Vous pouvez également ajouter d'autres contrôles serveur à la zone. Comme remarqué précédemment dans cette rubrique, les contrôles déclarés dans cet exemple sont obtenus à partir de l'exemple de code trouvé dans la propriété IsStatic. Le code pour la zone entière avec les contrôles serveur ressemble aux éléments suivants.
```
<asp:WebPartZone ID="WebPartZone1" >
  <ZoneTemplate>
    <aspSample:ZipCodeWebPart ID="zip1" 
       Title="ZIP Code Provider"  />
    <aspSample:WeatherWebPart ID="weather1"  
       Title="ZIP Code Consumer" />
  </ZoneTemplate>
</asp:WebPartZone> 
```

Pour déclarer une connexion statique

Votre page Web doit déjà comporter un élément <asp:webpartmanager> qui est requis sur les pages qui utilisent les contrôles WebPart. Ajoutez un élément <staticconnections> en tant qu'enfant de l'élément <asp:webpartmanager> pour contenir une ou plusieurs connexions statiques déclarées. Le code doit ressembler à l'exemple suivant :
```
<asp:WebPartManager ID="mgr"  >
  <StaticConnections>
  </StaticConnections> 
</asp:WebPartManager> 
```
Dans l'élément <staticconnections>, déclarez un élément <asp:webpartconnection>. Pour la connexion, vous devez spécifier les attributs requis suivants en plus des attributs id et runat :
- ConsumerID - Indique l'ID du contrôle consommateur dans la connexion.
- ConsumerConnectionPointID - Indique l'ID d'une méthode de rappel spéciale dans le consommateur utilisé pour établir la connexion. Cet attribut est uniquement requis lorsque le consommateur dispose de plusieurs points de connexion. Pour plus d'informations sur les points de connexion, consultez ConnectionPoint.
- ProviderID - Indique l'ID du contrôle fournisseur dans la connexion.
- ProviderConnectionPointID - Indique l'ID d'une méthode de rappel spéciale dans le fournisseur utilisé pour établir la connexion. Cet attribut est uniquement requis lorsque le fournisseur dispose de plusieurs points de connexion.
Le code complété pour l'élément <asp:webpartmanager> et la connexion statique enfant doit ressembler à l'exemple suivant.
```
<asp:WebPartManager ID="mgr"  >
  <StaticConnections>
    <asp:WebPartConnection ID="conn1"
      ConsumerConnectionPointID="ZipCodeConsumer"
      ConsumerID="weather1" 
      ProviderConnectionPointID="ZipCodeProvider" 
      ProviderID="zip1" />
  </StaticConnections>      
</asp:WebPartManager>
```

Voir aussi

Concepts

Vue d'ensemble des connexions des WebParts

Vue d'ensemble des WebParts ASP.NET

Référence

WebPartConnection

IsStatic

Partager via