Sdílet prostřednictvím


<system.serviceModel>

Tato část konfigurace obsahuje všechny elementy konfigurace Modelu služby 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>

Atributy a prvky

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

Attributes

None

Podřízené prvky

prvek Description
<Chování> Tato část definuje dvě podřízené kolekce pojmenované endpointBehaviors a serviceBehaviors. Každá kolekce definuje prvky chování využívané koncovými body a službami. Každý prvek chování je identifikován jeho jedinečný name atribut.
<na něčí žádosti> Tento oddíl obsahuje kolekci standardních a vlastních vazeb. Každá položka je identifikována jeho jedinečným name. Služby používají vazby jejich propojením pomocí .name
<Klienta> Tato část obsahuje seznam koncových bodů, které klient používá k připojení ke službě.
<comContracts> Tato část definuje kontrakty MODELU COM povolené pro interoperabilitu WCF a COM.
<commonBehaviors> Tento oddíl lze definovat pouze v souboru machine.config. Definuje dvě podřízené kolekce pojmenované endpointBehaviors a serviceBehaviors. Každá kolekce definuje prvky chování spotřebované všemi koncovými body a službami WCF na počítači. Pokud je chování definováno v obou <commonBehaviors> částech i <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 směrovací tabulky, které definují cílové koncové body pro odesílání zpráv, když se filtr shoduje.
<serviceHostingEnvironment> Tato část definuje, jaký typ hostitelského prostředí služby vytvoří instanci konkrétního přenosu. 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 tento prvek service prvek určující nastavení pro službu.
<standardEndpoints> Tato část definuje kolekci standardních koncových bodů, které 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 opravený. Pomocí standardních koncových bodů můžete také rozšířit koncový bod 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é prvky

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

Poznámky

WCF nepřidává elementy do oddílů konfigurace jiných produktů.

Služby WCF jsou definovány v services čá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; Vlastnost ConfigurationName však můžete změnit na ServiceContractAttribute přepsání požadavku typu CLR.

Atribut behaviorConfiguration je nepovinný. Identifikuje chování služby používané službou. Chování určené tímto atributem musí propojit 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 rámci konfiguračního 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 rámci oddílu vazby se používá. Oddíl vazby může definovat několik nakonfigurovaných vazeb.

Example

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é