Dela via

<system.serviceModel>

  • Artikel

Det här konfigurationsavsnittet innehåller alla konfigurationselement för Windows Communication Foundation (WCF) ServiceModel.

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

Attribut och element

I följande avsnitt beskrivs attribut, underordnade element och överordnade element.

Attribut

Ingen

Underordnade element

Element Beskrivning
<Beteenden> Det här avsnittet definierar två underordnade samlingar med namnet endpointBehaviors och serviceBehaviors. Varje samling definierar beteendeelement som används av slutpunkter respektive tjänster. Varje beteendeelement identifieras med sitt unika name attribut.
<Bindningar> Det här avsnittet innehåller en samling standardbindningar och anpassade bindningar. Varje post identifieras av dess unika name. Tjänster använder bindningar genom att länka dem med hjälp av name.
<Klient> Det här avsnittet innehåller en lista över slutpunkter som en klient använder för att ansluta till en tjänst.
<comContracts> Det här avsnittet definierar COM-kontrakt som är aktiverade för WCF och COM-interop.
<commonBehaviors> Det här avsnittet kan bara definieras i filen machine.config. Den definierar två underordnade samlingar med namnet endpointBehaviors och serviceBehaviors. Varje samling definierar beteendeelement som används av alla WCF-slutpunkter respektive tjänster på datorn. Om ett beteende definieras i båda <commonBehaviors> avsnitten och <behaviors> ges beteendet i beteendeavsnittet><företräde.
<Diagnostik> Det här avsnittet innehåller inställningar för diagnostikfunktionerna i WCF. Användaren kan aktivera/inaktivera spårning, prestandaräknare och WMI-providern och lägga till anpassade meddelandefilter.
<Tillägg> Det här avsnittet innehåller en samling tillägg som gör det möjligt för användaren att skapa användardefinierade bindningar, beteenden och andra aspekter av tillägg.
<protocolMapping> Det här avsnittet definierar en uppsättning standardprotokollmappningar mellan transportprotokollscheman (t.ex. http, net.tcp, net.pipe osv.) och WCF-bindningar.
<Routning> Det här avsnittet definierar en uppsättning routningsfilter som bestämmer vilken typ av WCF (Windows Communication Foundation)MessageFilter som ska användas vid utvärdering av inkommande meddelanden, samt routningstabeller som definierar målslutpunkterna för att skicka meddelanden till när ett filter matchar.
<serviceHostingEnvironment> Det här avsnittet definierar vilken typ av tjänstvärdmiljö som instansierar för en viss transport. Om det här avsnittet är tomt används standardtypen.
<Tjänster> Avsnittet innehåller en samling tjänster. För varje tjänst som definierats i sammansättningen innehåller det här elementet ett service element som anger inställningar för tjänsten.
<standardEndpoints> Det här avsnittet definierar en samling standardslutpunkter, som är återanvändbara förkonfigurerade slutpunkter. En standardslutpunkt har ett eller flera av adress-, bindnings- och kontraktsattributen inställda på ett fast värde. I identifieringsslutpunkten är till exempel kontraktet fast. Du kan också använda standardslutpunkter för att utöka tjänstslutpunkten med nya egenskaper som liknar definitionen av anpassade bindningar.
<Spårning> Det här avsnittet definierar spårningsinställningar för en arbetsflödestjänst.

Överordnade element

Element Beskrivning
<Konfiguration> Rotelementet för alla konfigurationselement i en .NET-konfigurationsfil.

Kommentarer

WCF lägger inte till element i konfigurationsavsnitten för andra produkter.

WCF-tjänster definieras i services avsnittet i konfigurationsfilen. En sammansättning kan innehålla valfritt antal tjänster. Varje tjänst har ett eget service konfigurationsavsnitt. Avsnittet och dess innehåll definierar tjänstkontraktet, beteendet och slutpunkterna för den specifika tjänsten.

Endast en tjänsts name attribut krävs. Som standard beskriver en tjänsts namn den underliggande CLR-typen som används för att implementera en tjänst. Du kan dock ändra egenskapen ConfigurationName på en ServiceContractAttribute för att åsidosätta kravet på CLR-typ.

Attributet behaviorConfiguration är valfritt. Den identifierar tjänstbeteendet som används av en tjänst. Beteendet som anges av det här attributet måste länka till ett tjänstbeteende som definierats i omfånget för samma konfigurationsfil (dvs. samma fil eller en överordnad fil).

Varje tjänst exponerar en eller flera slutpunkter som definierats i ett endpoint element. Varje slutpunkt har sin egen adress och bindning. Alla bindningar som används i konfigurationsfilen måste definieras i omfånget för filen.

Bindningar länkas till slutpunkter via kombinationen av attributen name och bindingConfiguration. Attributet binding definierar i vilket avsnitt bindningen definieras. Attributet bindingConfiguration definierar vilken konfigurerad bindning i bindningsavsnittet som används. Ett bindningsavsnitt kan definiera flera konfigurerade bindningar.

Exempel

Det här är ett exempel på en WCF-konfigurationsfil.

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

Se även