Delen via

<system.serviceModel>

  • Artikel

Deze configuratiesectie bevat alle ServiceModel-configuratie-elementen van Windows Communication Foundation (WCF).

<configuratie>
  <system.serviceModel>

Syntax

<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>

Kenmerken en elementen

In de volgende secties worden kenmerken, onderliggende elementen en bovenliggende elementen beschreven.

Kenmerken

Geen

Onderliggende elementen

Element Beschrijving
<Gedrag> In deze sectie worden twee onderliggende verzamelingen met de naam endpointBehaviors en serviceBehaviorsgedefinieerd. Elke verzameling definieert gedragselementen die respectievelijk worden gebruikt door eindpunten en services. Elk gedragselement wordt geïdentificeerd door het unieke name kenmerk.
<Bindings> Deze sectie bevat een verzameling standaard- en aangepaste bindingen. Elke vermelding wordt geïdentificeerd aan de unieke name. Services gebruiken bindingen door deze te koppelen met behulp van de name.
<Client> Deze sectie bevat een lijst met eindpunten die een client gebruikt om verbinding te maken met een service.
<comContracts> In deze sectie worden COM-contracten gedefinieerd die zijn ingeschakeld voor WCF en COM-interoperabiliteit.
<commonBehaviors> Deze sectie kan alleen worden gedefinieerd in het machine.config-bestand. Het definieert twee onderliggende verzamelingen met de naam endpointBehaviors en serviceBehaviors. Elke verzameling definieert gedragselementen die worden gebruikt door respectievelijk alle WCF-eindpunten en -services op de computer. Als een gedrag is gedefinieerd in zowel secties <behaviors> als <commonBehaviors> secties, krijgt het gedrag in de <sectie gedrag> de voorkeur.
<Diagnostics> Deze sectie bevat instellingen voor de diagnostische functies van WCF. De gebruiker kan tracering, prestatiemeteritems en de WMI-provider in-/uitschakelen en aangepaste berichtfilters toevoegen.
<Extensies> Deze sectie bevat een verzameling extensies, waarmee de gebruiker door de gebruiker gedefinieerde bindingen, gedrag en andere aspecten van extensies kan maken.
<protocolMapping> In deze sectie wordt een set standaardprotocoltoewijzingen tussen transportprotocolschema's (bijvoorbeeld http, net.tcp, net.pipe, enzovoort) en WCF-bindingen gedefinieerd.
<Routering> In deze sectie wordt een set routeringsfilters gedefinieerd, die bepalen welk type WCF (Windows Communication Foundation)MessageFilter moet worden gebruikt bij het evalueren van binnenkomende berichten, evenals routeringstabellen die de doeleindpunten definiëren waarnaar berichten moeten worden verzonden wanneer een filter overeenkomt.
<serviceHostingEnvironment> In deze sectie wordt gedefinieerd welk type de servicehostingomgeving voor een bepaald transport instanteert. Als deze sectie leeg is, wordt het standaardtype gebruikt.
<Diensten> De sectie bevat een verzameling services. Voor elke service die in de assembly is gedefinieerd, bevat dit element een service element waarmee de instellingen voor de service worden opgegeven.
<standardEndpoints> In deze sectie wordt een verzameling standaardeindpunten gedefinieerd. Dit zijn herbruikbare vooraf geconfigureerde eindpunten. Een standaardeindpunt heeft een of meer adres-, bindings- en contractkenmerken die zijn ingesteld op een vaste waarde. In het detectie-eindpunt is het contract bijvoorbeeld vast. U kunt ook standaardeindpunten gebruiken om het service-eindpunt uit te breiden met nieuwe eigenschappen die vergelijkbaar zijn met het definiëren van aangepaste bindingen.
<Bijhouden> In deze sectie worden traceringsinstellingen voor een werkstroomservice gedefinieerd.

Bovenliggende elementen

Element Beschrijving
<configuratie> Het hoofdelement voor alle configuratie-elementen in een .NET-configuratiebestand.

Opmerkingen

WCF voegt geen elementen toe aan de configuratiesecties van andere producten.

WCF-services worden gedefinieerd in de services sectie van het configuratiebestand. Een assembly kan een willekeurig aantal services bevatten. Elke service heeft een eigen service configuratiesectie. De sectie en de inhoud ervan definiëren het servicecontract, het gedrag en de eindpunten van de specifieke service.

Alleen het kenmerk van name een service is vereist. Standaard beschrijft de naam van een service het onderliggende CLR-type dat wordt gebruikt om een service te implementeren; U kunt echter de eigenschap ConfigurationName op een ServiceContractAttribute wijzigen om de vereiste clr-type te overschrijven.

Het behaviorConfiguration kenmerk is optioneel. Het identificeert het servicegedrag dat door een service wordt gebruikt. Het gedrag dat door dit kenmerk wordt opgegeven, moet zijn gekoppeld aan een servicegedrag dat is gedefinieerd in het bereik van hetzelfde configuratiebestand (dat wil doen hetzelfde bestand of een bovenliggend bestand).

Elke service maakt een of meer eindpunten beschikbaar die in een endpoint element zijn gedefinieerd. Elk eindpunt heeft een eigen adres en binding. Alle bindingen die in het configuratiebestand worden gebruikt, moeten worden gedefinieerd in het bereik van het bestand.

Bindingen worden gekoppeld aan eindpunten via de combinatie van de kenmerken name en bindingConfiguration. Het binding kenmerk definieert in welke sectie de binding wordt gedefinieerd. Het bindingConfiguration kenmerk definieert welke geconfigureerde binding binnen de bindingssectie wordt gebruikt. Een bindingssectie kan verschillende geconfigureerde bindingen definiëren.

Voorbeeld

Dit is een voorbeeld van een WCF-configuratiebestand.

<?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>

Zie ook