<channel>, élément (modèle)

Article
08/21/2007

Contient le modèle de canal qui peut être spécifié et configuré par l'application pour communiquer avec les demandes d'objets distants ou les écouter. À chaque endroit où un canal peut être inscrit en vue d'une utilisation, vous pouvez définir l'attribut id de l'élément d'instance <channel> avec l'attribut ref de ce modèle.

<configuration>, élément
  <system.runtime.remoting>, élément
    <channels>, élément (modèle)
      <channel>, élément (modèle)

<channel  
   id="channelID" 
   type="ChannelType, ChannelAssembly"
   displayName="displayName"
   customChannelProperty="customChannelValue"
   <!-- Available only to client configurations -->
   delayLoadAsClientChannel="true|false"
/>

Attributs et éléments

Les sections suivantes décrivent des attributs, des éléments enfants et des éléments parents.

Attributs

Attribut	Description
customChannelProperty	Attribut facultatif. Indique une propriété de canal personnalisé prise en charge. Vous pouvez spécifier autant de propriétés de canal que les canaux peuvent en accepter. Une propriété de canal personnalisé est spécifiée à l'aide d'une paire attribut/valeur. Par exemple : `<channel id="CustomChannel" type="Namespace.CustomChannel, CustomChannels" customProperty="PropertyValue"/>`
delayLoadAsClientChannel	Attribut facultatif. Indique si ce canal doit être chargé lorsque le client n'inscrit pas de canal pour l'application. Cette valeur est de type booléen et n'affecte que le comportement du client. La valeur true indique que le système distant .NET Framework doit tester le canal au moment de l'exécution pour vérifier s'il prend en charge une connexion cliente utilisant le schéma de protocole spécifié dans l'URL d'activation à distance. Si la valeur n'est pas spécifiée, la valeur par défaut est false.
displayName	Attribut facultatif. Cet attribut est utilisé par l'outil .NET Framework Configuration Tool pour créer la liste des canaux utilisés par cette application. Le système distant .NET Framework n'utilise pas cet attribut.
id	Attribut requis. Fournit la chaîne utilisée par les applications pour identifier le canal lors de l'inscription. Pour faire référence au modèle de canal, assignez à cet attribut la valeur de l'attribut ref dans l'élément d'instance <channel>.

Éléments enfants

Élément	Description
<serverProviders>	Contient les fournisseurs de récepteurs pour les récepteurs qui doivent être insérés dans la chaîne d'appel du récepteur de canal côté serveur. Si un fournisseur est spécifié, il substitue le fournisseur par défaut du canal. Peut apparaître une seule fois dans l'élément de modèle <channel>.
<clientProviders>	Contient les fournisseurs de récepteurs pour les récepteurs qui doivent être insérés dans la chaîne d'appel du récepteur de canal côté client. Si un fournisseur est spécifié, il substitue le fournisseur par défaut du canal. Peut apparaître une seule fois dans l'élément de modèle <channel>.

Éléments parents

Élément	Description
channels	Contient les modèles de canaux que l'application utilise pour communiquer avec les objets distants. Les canaux déclarés sous cet élément peuvent être référencés à tout endroit où un canal est inscrit.
configuration	Élément racine de chaque fichier de configuration utilisé par le Common Language Runtime et les applications .NET Framework.
system.runtime.remoting	Spécifie l'élément racine de la section de configuration ASP.NET.

Notes

Les modèles de canaux peuvent figurer dans le fichier de configuration machine, dans le fichier de l'application ou dans tout autre fichier chargé en appelant RemotingConfiguration.Configure().

Exemple

Le fichier de configuration suivant utilise un élément de modèle <channels> pour déclarer un HttpChannel avec l'id « httpbinary » utilisant le BinaryClientFormatterSink pour sérialiser les appels distants. Il demande ensuite que l'application cliente utilise cette configuration de canal spécifique en définissant ref="httpbinary" dans l'élément d'instance <channel> à l'intérieur de l'élément <application>. Enfin, il ajoute un fournisseur de récepteur de canal « propsetter » et passe certains éléments de configuration personnalisés qui seront utilisés par le fournisseur de récepteur de canal. Notez que toute utilisation de l'attribut type pour spécifier un type dans un assembly qui se trouve dans le Global Assembly Cache nécessite des informations de type complètes, y compris la version, la culture et les informations de clé publique. Ces informations ont été omises dans les attributs type suivants pour des raisons de brièveté.

<configuration>
   <system.runtime.remoting>
      <channelSinkProviders>
         <clientProviders>
            <provider 
               id="propsetter" 
               type="ChannelSinkPropertySetterProvider, PropsSink" 
            />
         </clientProviders>
      <channels>
         <channel 
            type="System.Runtime.Remoting.Channels.Http.HttpChannel, System.Runtime.Remoting, ...." 
            id="httpbinary"
         >
            <clientProviders>
               <formatter                   type="System.Runtime.Remoting.Channels.BinaryClientFormatterSinkProvider, System.Runtime.Remoting, ...."
               />
            </clientProviders>
         </channel>
      </channels>
      <application>
         <channels>
            <channel ref="httpbinary">
               <clientProviders>
                  <provider 
                     ref="propsetter" 
                     username="somename" 
                     writeToConsole="true"
                  >
                     <endpoint url="contoso.com:9000" password="xyz" />
                     <endpoint url="contoso.com:9001" password="123" />
                  </provider>
               </clientProviders>
            </channel>
         </channels>
         <client>
            <wellknown 
               url="http://computername:80/RemoteType.rem"
               type="RemoteType, RemoteAssembly"
            />
         </client>
      </application>
   </system.runtime.remoting>
</configuration>

Voir aussi

Référence

Schéma des paramètres d'accès distant
HttpChannel
HttpClientChannel
HttpServerChannel
TcpChannel
TcpClientChannel
TcpServerChannel

Partager via