<System.servicemodel>
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>
