Udostępnij za pośrednictwem

<System.servicemodel>

  • Artykuł

Ta sekcja konfiguracji zawiera wszystkie elementy konfiguracji ServiceModel programu Windows Communication Foundation (WCF).

<Konfiguracji>
  <System.servicemodel>

Składnia

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

Atrybuty i elementy

W poniższych sekcjach opisano atrybuty, elementy podrzędne i elementy nadrzędne.

Atrybuty

Brak

Elementy podrzędne

Element Opis
<Zachowania> Ta sekcja definiuje dwie kolekcje podrzędne o nazwach endpointBehaviors i serviceBehaviors. Każda kolekcja definiuje elementy zachowania używane odpowiednio przez punkty końcowe i usługi. Każdy element zachowanie jest określony przez jego unikatowy name atrybutu.
<Powiązania> Ta sekcja zawiera kolekcję powiązań standardowych i niestandardowych. Każdy wpis jest identyfikowany przez unikatowy nameelement . Usługi używają powiązań, łącząc je przy użyciu elementu name.
<Klienta> Ta sekcja zawiera listę punktów końcowych używanych przez klienta do nawiązywania połączenia z usługą.
<comContracts> Ta sekcja definiuje kontrakty COM włączone dla międzyoperacyjności WCF i COM.
<commonBehaviors> Tę sekcję można zdefiniować tylko w pliku machine.config. Definiuje ona dwie kolekcje podrzędne o nazwach endpointBehaviors i serviceBehaviors. Każda kolekcja definiuje elementy zachowania używane odpowiednio przez wszystkie punkty końcowe i usługi WCF na maszynie. Jeśli zachowanie jest zdefiniowane w obu <commonBehaviors> sekcjach i <behaviors> , zachowanie w <sekcji zachowania> jest podane preferencji.
<Diagnostyka> Ta sekcja zawiera ustawienia funkcji diagnostycznych programu WCF. Użytkownik może włączać/wyłączać śledzenie, liczniki wydajności i dostawcę usługi WMI oraz dodawać niestandardowe filtry komunikatów.
<Rozszerzenia> Ta sekcja zawiera kolekcję rozszerzeń, które umożliwiają użytkownikowi tworzenie powiązań, zachowań i innych aspektów rozszerzeń zdefiniowanych przez użytkownika.
<protocolMapping> W tej sekcji zdefiniowano zestaw domyślnych mapowań protokołów między schematami protokołów transportu (np. http, net.tcp, net.pipe itp.) i powiązaniami programu WCF.
<Routingu> W tej sekcji zdefiniowano zestaw filtrów routingu, które określają typ programu Windows Communication Foundation (WCF)MessageFilter do użycia podczas oceniania komunikatów przychodzących, a także tabele routingu definiujące docelowe punkty końcowe do wysyłania komunikatów do momentu dopasowania filtru.
<serviceHostingEnvironment> W tej sekcji zdefiniowano typ wystąpienia środowiska hostingu usługi dla określonego transportu. Jeśli ta sekcja jest pusta, zostanie użyty typ domyślny.
<Usług> Sekcja zawiera kolekcję usług. Dla każdej usługi zdefiniowanej w zestawie ten element zawiera service element określający ustawienia usługi.
<standardEndpoints> Ta sekcja definiuje kolekcję standardowych punktów końcowych, które są wstępnie skonfigurowanymi punktami końcowymi wielokrotnego użytku. Standardowy punkt końcowy będzie miał co najmniej jeden adres, powiązanie i atrybut kontraktu ustawiony na stałą wartość. Na przykład w punkcie końcowym odnajdywania kontrakt jest stały. Możesz również użyć standardowych punktów końcowych, aby rozszerzyć punkt końcowy usługi o nowe właściwości podobne do definiowania powiązań niestandardowych.
<Śledzenia> Ta sekcja definiuje ustawienia śledzenia dla usługi przepływu pracy.

Elementy nadrzędne

Element Opis
<Konfiguracji> Element główny dla wszystkich elementów konfiguracji w PLiku konfiguracji PLatformy .NET.

Uwagi

Program WCF nie dodaje elementów do sekcji konfiguracji innych produktów.

Usługi WCF są definiowane w services sekcji pliku konfiguracji. Zestaw może zawierać dowolną liczbę usług. Każda usługa ma własną service sekcję konfiguracji. Sekcja i jej zawartość definiują kontrakt usługi, zachowanie i punkty końcowe określonej usługi.

Wymagany jest tylko atrybut usługi name . Domyślnie nazwa usługi opisuje podstawowy typ CLR używany do implementowania usługi; Można jednak zmienić właściwość ConfigurationName na ServiceContractAttribute , aby zastąpić wymaganie dotyczące typu CLR.

Atrybut behaviorConfiguration jest opcjonalny. Identyfikuje zachowanie usługi używane przez usługę. Zachowanie określone przez ten atrybut musi być połączone z zachowaniem usługi zdefiniowanym w zakresie tego samego pliku konfiguracji (tj. tego samego pliku lub pliku nadrzędnego).

Każda usługa uwidacznia co najmniej jeden punkt końcowy zdefiniowany w elemecie endpoint . Każdy punkt końcowy ma własny adres i powiązanie. Wszystkie powiązania używane w pliku konfiguracji muszą być zdefiniowane w zakresie pliku.

Powiązania są połączone z punktami końcowymi za pośrednictwem kombinacji atrybutów name i bindingConfiguration. Atrybut binding definiuje, w której sekcji definiowane jest powiązanie. Atrybut bindingConfiguration określa, które skonfigurowane powiązanie w sekcji powiązania jest używane. Sekcja powiązania może definiować kilka skonfigurowanych powiązań.

Przykład

Jest to przykład pliku konfiguracji programu 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>

Zobacz też