<system.serviceModel>

  • Article

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

<configuration>
  <system.serviceModel>

Syntaxe

<system.serviceModel>
  <behaviors>
  </behaviors>
  <bindings>
  </bindings>
  <client>
  </client>
  <comContracts>
  </comContracts>
  <commonBehaviors>
  </commonBehaviors>
  <diagnostics>
  </diagnostics>
  <extensions>
  </extensions>
  <protocolMapping>
  </protocolMapping>
  <routing>
  </routing>
  <serviceHostingEnvironment>
  </serviceHostingEnvironment>
  <services>
  </services>
  <standardEndpoints>
  </standardEndpoints>
  <tracking>
  </tracking>
</system.serviceModel>

Attributs et éléments

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

Attributs

Aucun

Éléments enfants

Élément Description
<behaviors> Cette section 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> Cette section contient 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 de name.
<client> Cette section contient la liste des points de terminaison utilisés par un client pour se connecter à un service.
<comContracts> Cette section définit des contrats COM activés pour interagir avec WCF et COM.
<commonBehaviors> Cette section peut uniquement être définie dans le fichier machine.config. Elle définit deux collections enfants nommées endpointBehaviors et serviceBehaviors. Chaque collection définit les éléments de comportement consommés respectivement par tous les points de terminaison et services WCF sur l’ordinateur. Si un comportement est défini dans les sections <commonBehaviors> et <behaviors>, le comportement de la section <behaviors> est prioritaire.
<diagnostics> Cette section 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.
<extensions> Cette section 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.
<protocolMapping> Cette section définit un ensemble de mappages de protocole par défaut entre des schémas de protocole de transport (par exemple, http, net.tcp, net.pipe, etc.) et des liaisons WCF.
<routing> Cette section définit un ensemble de filtres de routage, qui déterminent le type de MessageFilter WCF (Windows Communication Foundation) à utiliser pendant l’évaluation des messages entrants, ainsi que les tables de routage qui définissent les points de terminaison cibles auxquels envoyer les messages quand un filtre correspond.
<serviceHostingEnvironment> Cette section définit le type instancié par l'environnement d'hébergement de service pour un transport particulier. Si cette section est vide, le type par défaut est utilisé.
<services> Cette section contient 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.
<standardEndpoints> Cette section définit une collection de points de terminaison standard, qui sont des points de terminaison préconfigurés réutilisables. Un point de terminaison standard possède un ou plusieurs attributs d’adresse, de liaison et de contrat ayant une valeur fixe. Par exemple, dans le point de terminaison de découverte, le contrat est fixe. Vous pouvez également utiliser des points de terminaison standard pour étendre le point de terminaison de service avec de nouvelles propriétés, ce qui revient à définir des liaisons personnalisées.
<tracking> Cette section définit les paramètres de suivi pour un service de workflow.

É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. Chacun 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