<System.servicemodel>

  • Článek

Tato část konfigurace obsahuje všechny elementy konfigurace Modelu služby Windows Communication Foundation (WCF).

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

Atributy a elementy

Následující části popisují atributy, podřízené prvky a nadřazené prvky.

Atributy

Žádné

Podřízené elementy

Element Popis
<Chování> Tato část definuje dvě podřízené kolekce s názvem endpointBehaviors a serviceBehaviors. Každá kolekce definuje prvky chování spotřebované koncovými body a službami v uvedeném pořadí. Každý prvek chování je identifikován jeho jedinečné name atributu.
<Vazby> Tento oddíl obsahuje kolekci standardních a vlastních vazeb. Každá položka je identifikována jedinečným nameobjektem . Služby používají vazby tak, že je propojí pomocí .name
<Klienta> Tato část obsahuje seznam koncových bodů, které klient používá pro připojení ke službě.
<comContracts> Tato část definuje kontrakty MODELU COM, které jsou povolené pro zprostředkovatele WCF a COM.
<commonBehaviors> Tento oddíl lze definovat pouze v souboru machine.config. Definuje dvě podřízené kolekce s názvem endpointBehaviors a serviceBehaviors. Každá kolekce definuje prvky chování spotřebované všemi koncovými body WCF a službami na počítači v uvedeném pořadí. Pokud je chování definováno v oddílech i <commonBehaviors><behaviors> v oddílech>, dává se přednost chování v oddílu <chování.
<Diagnostika> Tato část obsahuje nastavení pro diagnostické funkce WCF. Uživatel může povolit nebo zakázat trasování, čítače výkonu a poskytovatele rozhraní WMI a může přidávat vlastní filtry zpráv.
<Rozšíření> Tato část obsahuje kolekci rozšíření, která uživateli umožňují vytvářet uživatelem definované vazby, chování a další aspekty rozšíření.
<protocolMapping> Tato část definuje sadu výchozích mapování protokolů mezi schématy přenosového protokolu (např. http, net.tcp, net.pipe atd.) a vazbami WCF.
<Směrování> Tato část definuje sadu filtrů směrování, které určují typ technologie Windows Communication Foundation (WCF),MessageFilter která se má použít při vyhodnocování příchozích zpráv, a také směrovací tabulky, které definují cílové koncové body, do kterých se mají zprávy odesílat při shodování filtru.
<serviceHostingEnvironment> Tato část definuje, jaký typ hostitelského prostředí služby vytvoří instanci pro konkrétní přenos. Pokud je tento oddíl prázdný, použije se výchozí typ.
<Služby> Oddíl obsahuje kolekci služeb. Pro každou službu definovanou v sestavení obsahuje service tento prvek prvek určující nastavení pro službu.
<standardní koncové body> Tato část definuje kolekci standardních koncových bodů, což jsou opakovaně použitelné předkonfigurované koncové body. Standardní koncový bod bude mít jeden nebo více atributů adresy, vazby a kontraktu nastavené na pevnou hodnotu. Například v koncovém bodu zjišťování je kontrakt pevný. Můžete také použít standardní koncové body k rozšíření koncového bodu služby o nové vlastnosti podobné definování vlastních vazeb.
<Sledování> Tato část definuje nastavení sledování pro službu pracovního postupu.

Nadřazené elementy

Element Popis
<Konfigurace> Kořenový element pro všechny elementy konfigurace v konfiguračním souboru .NET.

Poznámky

WCF nepřidává prvky do konfiguračních oddílů jiných produktů.

Služby WCF jsou definovány services v části konfiguračního souboru. Sestavení může obsahovat libovolný počet služeb. Každá služba má vlastní service oddíl konfigurace. Oddíl a jeho obsah definují kontrakt služby, chování a koncové body konkrétní služby.

Vyžaduje se name pouze atribut služby. Ve výchozím nastavení název služby popisuje základní typ CLR použitý k implementaci služby. Můžete však změnit vlastnost ConfigurationName na ServiceContractAttribute a přepsat požadavek na typ CLR.

Atribut behaviorConfiguration je volitelný. Identifikuje chování služby používané službou. Chování určené tímto atributem musí být propojeno s chováním služby definovaným v oboru stejného konfiguračního souboru (tj. stejného souboru nebo nadřazeného souboru).

Každá služba zveřejňuje jeden nebo více koncových bodů definovaných v elementu endpoint . Každý koncový bod má svou vlastní adresu a vazbu. Všechny vazby použité v konfiguračním souboru musí být definovány v oboru souboru.

Vazby jsou propojeny s koncovými body prostřednictvím kombinace atributů name a bindingConfiguration. Atribut binding definuje, ve které části je vazba definována. Atribut bindingConfiguration definuje, která nakonfigurovaná vazba v oddílu vazby se používá. Oddíl vazby může definovat několik nakonfigurovaných vazeb.

Příklad

Toto je příklad konfiguračního souboru 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>

Viz také