Élément <formatter> (instance)
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.
<configuration>
<system.runtime.remoting>
<channels>
<canal>
<serverProviders>
<formatter/>
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>
<canal>
<clientProviders>
<formatter/>
Un formateur spécifié à cet emplacement se substitue à la chaîne du récepteur de canal de ce canal et devient le nouveau formateur par défaut du modèle de canal.
<configuration>
<system.runtime.remoting>
<application>
<channels>
<canal>
<serverProviders>
<formatter/>
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>
<canal>
<clientProviders>
<formatter/>
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>
Élément <system.runtime.remoting>
Élément <application>
Élément <channels> (instance)
Élément <channel> (instance)
Élément <clientProviders> (instance)
Élément <formatter> (instance)
<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 : |
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 d'accès distant
BinaryClientFormatterSink
SoapClientFormatterSink
BinaryServerFormatterSink
SoapServerFormatterSink
.gif)
Copyright ©2007 par Microsoft Corporation. Tous droits réservés.