Élément <provider> (modèle)
Contient le modèle de fournisseur de récepteur de canal du récepteur de canal qui doit être inséré dans la chaîne du récepteur de canal client ou serveur. Il existe deux hiérarchies possibles pour l'inclusion de cet élément.
<configuration>
Élément <system.runtime.remoting>
Élément <channelSinkProviders>
Élément <clientProviders> (instance)
Élément <provider> (modèle)
<provider
id="ProviderID"
type="ProviderType, ProviderAssembly"
customChannelSinkProperty="customProperty"
/>
Attributs et éléments
Les sections suivantes décrivent des attributs, des éléments enfants et des éléments parents.
Attributs
Attribut | Description |
---|---|
id |
Attribut requis. Spécifie une chaîne qui identifie ce fournisseur de récepteur de canal. Les autres peuvent utiliser cette chaîne dans leur attribut ref pour créer une liaison vers ce fournisseur de récepteur de canal. |
type |
Attribut requis. Spécifie le nom complet du type du fournisseur de récepteur de canal et le nom de l'assembly qui contient l'implémentation du fournisseur. Cela inclut les informations de version, de culture et de clé publique si l'assembly conteneur se trouve dans le Global Assembly Cache. |
customChannelSinkProperty |
Attribut facultatif. Indique une propriété de récepteur de canal personnalisé prise en charge. Vous pouvez spécifier autant de propriétés de fournisseur et de récepteur de canal que les fournisseurs de récepteurs de canaux personnalisés et leurs récepteurs peuvent en accepter. Une propriété de récepteur de canal personnalisé est spécifiée à l'aide d'une paire attribut/valeur. Dans l'exemple :
l'attribut Les données d'un fournisseur de canal personnalisé peuvent également être spécifiées à cet emplacement. Un seul niveau de nœuds est pris en charge. Dans l'exemple :
les informations supplémentaires seront disponibles en tant que ICollection du SinkProviderData dans le constructeur du fournisseur. |
Éléments enfants
Aucun.
Éléments parents
Élément | Description |
---|---|
channelSinkProviders |
Contient les modèles pour les fournisseurs de récepteurs de canaux clients et serveur. Tout fournisseur de récepteur de canal spécifié sous cet élément peut être référencé à n'importe quel endroit où un fournisseur de récepteur de canal peut être inscrit. |
clientProviders |
Contient les fournisseurs des récepteurs de canaux qui doivent faire partie de la chaîne d'appel du récepteur de canal par défaut côté client pour ce modèle de canal lorsqu'il est fait référence au modèle à un autre endroit du fichier de configuration. Les fournisseurs spécifiés dans l'un ou l'autre des emplacements ci-dessous se substituent aux récepteurs de canaux par défaut du canal ; si vous prévoyez que l'un de ces récepteurs de canaux sera inséré dans la chaîne d'appel du récepteur de canal de ce modèle, vous devez le spécifier à cet emplacement. |
configuration |
Élément racine de chaque fichier de configuration utilisé par le common language runtime et les applications .NET Framework. |
system.runtime.remoting |
Contient des informations sur les canaux et les objets distants. |
Exemple
Le fichier de configuration suivant utilise un élément d'instance <provider> pour assigner au HttpChannel le fournisseur de récepteurs de canaux « propsetter » et « null » qui ont eux-mêmes été déclarés avec les éléments de modèle <provider>. De plus, le fournisseur de récepteur de canal « propsetter » est créé avec les propriétés du fournisseur personnalisé spécifiées comme attributs sur l'élément d'instance du fournisseur et comme paires nom/valeur de l'attribut enfant <endpoint>
.
<configuration>
<system.runtime.remoting>
<application>
<client>
<wellknown
type="RemoteType, RemoteAssembly"
url="http://computername:8080/RemoteType.rem"/>
</client>
<channels>
<channel ref="http">
<clientProviders>
<formatter ref="soap"/>
<provider
ref="propsetter"
username="bob"
writeToConsole="true"
>
<endpoint url="contoso.com:9000" someProperty="xyz" />
<endpoint url="contoso.com:9001" someProperty="123" />
</provider>
<provider ref="null" writeToConsole="true" />
</clientProviders>
</channel>
</channels>
</application>
<channelSinkProviders>
<clientProviders>
<provider
id="propsetter"
type="ChannelSinkPropertySetterProvider, SinkAssembly"
/>
<provider
id="null"
type="NullSinkProvider, SinkAssembly"
/>
</clientProviders>
</channelSinkProviders>
<debug loadTypes="true" />
</system.runtime.remoting>
</configuration>
Voir aussi
Référence
Schéma des paramètres d'accès distant
Concepts
Récepteurs et chaînes de récepteurs
Copyright ©2007 par Microsoft Corporation. Tous droits réservés.