<system.serviceModel>

Article
09/12/2008

Cette section de configuration contient tous les éléments de configuration ServiceModel de Windows Communication Foundation (WCF).

<system.serviceModel>
    <behaviors>
    </behaviors>
    <bindings>
    </bindings>
    <client>
    </client>
    <comContracts>
    </comContracts>
    <commonBehaviors>
    </commonBehaviors>
    <diagnostics>
    </diagnostics>
    <extensions>
    </extensions>
    <serviceHostingEnvironment>
    </serviceHostingEnvironment>
    <services>
    </services>
</system.serviceModel>

Attributs et éléments

Attributs

Aucun

Éléments enfants

Élément	Description
<behaviors>	Cet élément définit deux collections enfants nommées endpointBehaviors et serviceBehaviors. Chaque collection définit des éléments de comportement consommés respectivement par les points de terminaison et les services. Chaque élément de comportement est identifié par son attribut name unique.
<bindings>	Cet élément conserve une collection de liaisons standard et personnalisées. Chaque entrée est identifiée par son name unique. Les services utilisent les liaisons en les liant à l'aide du name.
<client>	Cet élément contient la liste des points de terminaison utilisés par un client pour se connecter à un service.
<comContracts>	Cet élément définit des contrats COM activés pour interagir avec WCF et COM.
<commonBehaviors>	Cet élément peut uniquement être défini dans le fichier machine.config. Il définit deux collections enfants nommées endpointBehaviors et serviceBehaviors. Chaque collection définit des éléments de comportement consommés respectivement par tous les points de terminaison et services de WCF sur l'ordinateur. Si un comportement est défini dans les sections <commonBehaviors> et <behaviors>, le comportement de la section <behaviors> a la préférence.
<extensions>, section	Cet élément contient une collection d'extensions, qui permettent à l'utilisateur de créer des liaisons, des comportements et d'autres aspects d'extensions définis par l'utilisateur.
<diagnostics>	Cet élément contient les paramètres des fonctionnalités de diagnostic de WCF. L'utilisateur peut activer/désactiver le suivi, les compteurs de performance et le fournisseur WMI et ajouter des filtres de messages personnalisés.
<serviceHostingEnvironment>	Cet élément définit le type instancié par l'environnement d'hébergement de service correspondant à un transport particulier. Si cette section est vide, le type par défaut est utilisé.
<services>	Élément contenant une collection de services. Pour chaque service défini dans l'assembly, cet élément contient un élément service indiquant les paramètres du service.

Éléments parents

Élément	Description
<configuration>	Élément racine correspondant à tous les éléments de configuration qui se trouvent dans un fichier de configuration .NET.

Notes

WCF n'ajoute pas d'éléments aux sections de configuration d'autres produits.

Les services WCF sont définis dans la section services du fichier de configuration. Un assembly peut contenir n'importe quel nombre de services. Chaque service dispose de sa propre section de configuration de service. Cette section et son contenu définissent le contrat, le comportement et les points de terminaison du service en question.

Seul l'attribut name d'un service est requis. Par défaut, le nom d'un service décrit le type CLR sous-jacent utilisé pour implémenter un service ; toutefois, vous pouvez modifier la propriété ConfigurationName d'un ServiceContractAttribute pour remplacer la spécification de type CLR.

L'attribut behaviorConfiguration est facultatif. Il identifie le comportement utilisé par un service. Le comportement spécifié par cet attribut doit être lié à un comportement de service défini dans l'étendue du même fichier de configuration (c'est-à-dire le même fichier ou un fichier parent).

Chaque service expose un ou plusieurs points de terminaison définis dans un élément endpoint. Chaque point de terminaison possède sa propre adresse et sa propre liaison. Toutes les liaisons utilisées dans le fichier de configuration doivent être définies dans l'étendue du fichier.

Les liaisons sont liées aux points de terminaison grâce à la combinaison des attributs name et bindingConfiguration. L'attribut binding définit la section dans laquelle la liaison est définie. L'attribut bindingConfiguration définit parmi les liaisons configurées figurant dans la section de liaison celle qui est utilisée. Une section de liaison peut définir plusieurs liaisons configurées.

Exemple

Voici un exemple de fichier de configuration WCF.

<?xml version="1.0" encoding="utf-8"?>
<configuration>
    <system.serviceModel>
        <behaviors>
           <!-- List of Behaviors -->
        </behaviors>
        <client>
           <!-- List of Endpoints -->
        </client>
        <diagnostics wmiProviderEnabled="false" performanceCountersEnabled="false" tracingEnabled="false">
        </diagnostics>
        <serviceHostingEnvironment>
           <!-- List of entries -->
        </serviceHostingEnvironment>
        <comContracts>
           <!-- List of COM+ Contracts -->
        </comContracts>        
        <services>
           <!-- List of Services -->
        </services>
        <bindings>
           <!-- List of Bindings -->
        </bindings>
    </system.serviceModel>
</configuration>

Voir aussi

Référence

ServiceModelSectionGroup

Partager via