Élément <formatter> (instance)

Cette rubrique est spécifique à la technologie héritée assurant la compatibilité descendante avec des applications existantes et n'est pas recommandée en cas de nouveau développement. Les applications distribuées doivent maintenant être développées à l'aide de Windows Communication Foundation (WCF).

Contient le fournisseur de récepteur de canal du récepteur de formateur qui doit être inséré dans la chaîne du récepteur de canal. Cet élément peut se trouver dans le fichier de configuration de l'ordinateur et dans le fichier de configuration de l'application.

<configuration>

<system.runtime.remoting>

<channels>

<channel>

<serverProviders>

Élément <formatter> (instance)

Un formateur spécifié à cet emplacement se substitue à la chaîne de récepteur du canal de ce canal et devient le nouveau formateur par défaut du modèle de canal.

<configuration>

<system.runtime.remoting>

<channels>

<channel>

<clientProviders>

Élément <formatter> (instance)

Un formateur spécifié à cet emplacement se substitue à la chaîne de récepteur du canal de ce canal et devient le nouveau formateur par défaut du modèle de canal.

<configuration>

<system.runtime.remoting>

<application>

<channels>

<channel>

<serverProviders>

Élément <formatter> (instance)

Un formateur spécifié à cet emplacement se substitue à la chaîne du récepteur de canal par défaut de cette instance de canal.

<configuration>

<system.runtime.remoting>

<application>

<channels>

<channel>

<clientProviders>

Élément <formatter> (instance)

Un formateur spécifié à cet emplacement se substitue à la chaîne du récepteur de canal par défaut de cette instance de canal.

Schema Hierarchy

<configuration>
  Élément <system.runtime.remoting>
    Élément <application>
      Élément <channels> (instance)
        Élément <channel> (instance)
          Élément <clientProviders> (instance)
            Élément <formatter> (instance)

Syntaxe

<formatter 
   ref="FormatterReference"
   type="FormatterSinkProviderType, FormatterAssembly"
   customFormatterProperty="customProperty"
   includeVersions="true"
   strictBinding="false"
...typeFilterLevel="Low | Full"
/>

Attributs et éléments

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

Attributs

Attribut	Description
ref	Attribut requis. Spécifie l'ID du modèle de fournisseur de récepteur de formateur correspondant au formateur que votre client prévoit d'inscrire en vue de son utilisation. Si vous spécifiez l'attribut ref, il est inutile de définir l'attribut type.
type	Attribut requis. Spécifie le nom complet du type du fournisseur de récepteur de formateur 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. Cet attribut n'est obligatoire que si vous n'utilisez pas d'attribut ref.
customFormatterProperty	Attribut facultatif. Indique une propriété de formateur personnalisé prise en charge. Vous pouvez spécifier autant de propriétés de formateur que les formateurs personnalisés peuvent en accepter. Une propriété de formateur personnalisé est spécifiée à l'aide d'une paire attribut/valeur. Par exemple : <formatter id="CustomFormatterSinkProvider" type="Namespace.CustomFormatterSinkProvider, CustomFormatters" customFormatterProperty="FormatterPropertyValue"/>.
includeVersions	Attribut facultatif. Indique qu'un formateur d'envoi inclut des informations complètes de version d'assembly et de type lors de la sérialisation des informations de type. Pour les informations importantes, consultez la section Notes ci-dessous. La valeur par défaut pour les deux formateurs fournis par le système est true.
strictBinding	Attribut facultatif. Indique qu'un formateur de réception essaiera d'abord d'identifier le type à l'aide des informations de version complètes si elles existent avant d'utiliser uniquement le nom du type et de l'assembly sans les informations de version. Pour les informations importantes, consultez la section Notes ci-dessous. La valeur par défaut pour les deux formateurs fournis par le système est false.
typeFilterLevel	Attribut facultatif. Valeur de chaîne spécifiant le niveau de désérialisation automatique que tente un formateur dans la chaîne de récepteurs de canal serveur. Les valeurs prises en charge sont Low (valeur par défaut) et Full. Pour plus d'informations sur les niveaux de désérialisation, consultez Automatic Deserialization in .NET Remoting. Cette propriété n'est prise en charge que dans le .NET Framework version 1.1 sur les plateformes suivantes : Windows 98, Windows NT 4.0, Windows Millennium, Windows 2000, Windows XP Édition Familiale, Windows XP Professionnel et la famille Windows Server 2003.

Éléments enfants

Aucun.

Éléments parents

Élément	Description
application	Contient des informations sur les objets distants utilisés et exposés par l'application.
channel	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 de canal avec l'attribut ref de ce modèle.
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.
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.

Notes

Vous pouvez faire référence à un modèle de fournisseur en utilisant la valeur id de ce modèle comme valeur ref de cette instance. Bien qu'il n'existe pas de limites sur le nombre de modèles pouvant être déclarés, un seul récepteur de formateur peut figurer dans une chaîne d'appel de récepteur de canal.

L'élément d'instance <formatter> peut apparaître à quatre emplacements. Lorsqu'il est spécifié sous un élément de modèle <channel> (dans l'un des deux éléments <serverProvider> ou <clientProvider>), cet élément spécifie un formateur qui se substitue à tout formateur par défaut du canal et devient le récepteur de formateur par défaut pour ce canal donné lorsqu'une instance <channel> de l'application fait référence au canal. Lorsqu'il est spécifié sous un élément <application>, il se substitue à tout récepteur de formateur qui a pu être déclaré dans le modèle ou l'instance du canal en cours.

Le tableau suivant décrit l'interaction entre les attributs includeVersions et strictBinding lorsqu'ils apparaissent ensemble.

includeVersions (formateur d'envoi)	strictBinding (formateur de réception)	Mode de chargement du type
true	true	Le type exact est chargé ou une exception TypeLoadException est levée.
false	true	Le type est chargé à l'aide du nom du type et du nom de l'assembly uniquement ou une exception TypeLoadException est levée.
true	false	Le type exact est chargé s'il est présent ; dans le cas contraire, le type est chargé à l'aide du nom du type et du nom de l'assembly uniquement. En cas d'échec, une exception TypeLoadException est levée.
false	false	Le type est chargé à l'aide du nom du type et du nom de l'assembly uniquement ou une exception TypeLoadException est levée.

Exemple

Le fichier de configuration suivant déclare une instance <channel> qui utilise l'élément d'instance <formatter> pour spécifier au BinaryClientFormatterSinkProvider par défaut d'utiliser la sérialisation binaire avec le HttpChannel.

<configuration>
   <system.runtime.remoting>
      <application>
         <channels>
            <channel ref="http">
               <clientProviders>
                  <formatter ref="binary"/>
               </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 de communication à distance
BinaryClientFormatterSink
SoapClientFormatterSink
BinaryServerFormatterSink
SoapServerFormatterSink

Date de génération : 2010-02-13