<system.serviceModel>

  • Artikel

Dieser Konfigurationsabschnitt enthält alle WCF-ServiceModel-Konfigurationselemente (Windows Communication Foundation).

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

Attribute und Elemente

In den folgenden Abschnitten werden Attribute sowie untergeordnete und übergeordnete Elemente beschrieben.

Attribute

Keine

Untergeordnete Elemente

Element BESCHREIBUNG
<behaviors> In diesem Abschnitt werden zwei untergeordnete Auflistungen mit den Namen endpointBehaviors und serviceBehaviors definiert. Jede Auflistung definiert von Endpunkten und Diensten verwendete Verhaltenselemente. Jedes Verhaltenselement wird durch seinen eindeutigen name identifiziert.
<bindings> Dieser Abschnitt enthält eine Auflistung von standardmäßigen und benutzerdefinierten Bindungen. Jeder Eintrag wird durch seinen eindeutigen name identifiziert. Dienste verwenden Bindungen, indem sie sie mithilfe des name verknüpfen.
<client> Dieser Abschnitt enthält eine Liste mit Endpunkten, die ein Client für die Verbindungsherstellung mit einem Dienst verwendet.
<comContracts> Dieser Abschnitt definiert für WCF und COM-Interop aktivierte COM-Verträge.
<commonBehaviors> Dieser Abschnitt kann nur in der Datei machine.config definiert werden. Er definiert zwei untergeordnete Auflistungen mit den Namen endpointBehaviors und serviceBehaviors. Jede Auflistung definiert Verhaltenselemente, die von allen WCF-Endpunkten und -Diensten auf dem Computer verwendet werden. Wenn ein Verhalten im Abschnitt <commonBehaviors> und im Abschnitt <behaviors> definiert ist, hat das Verhalten im Abschnitt <behaviors> höhere Priorität.
<diagnostics> Dieser Abschnitt enthält Einstellungen für die Diagnosefunktionen von WCF. Der Benutzer kann Ablaufverfolgung, Leistungsindikatoren und den WMI-Anbieter aktivieren/deaktivieren und benutzerdefinierte Meldungsfilter hinzufügen.
<extensions> Dieser Abschnitt enthält eine Auflistung von Erweiterungen, mit deren Hilfe der Benutzer benutzerdefinierte Bindungen, Verhalten und andere Aspekte von Erweiterungen erstellen kann.
<protocolMapping> Dieser Abschnitt definiert einen Satz von Standardprotokollzuordnungen zwischen Transportprotokollschemas (z. B. http, net.tcp, net.pipe usw.) und WCF-Bindungen.
<routing> Dieser Konfigurationsabschnitt dient zum Definieren von Routingfiltern, die den Typ von MessageFilter in WCF (Windows Communication Foundation) bestimmen, der bei der Auswertung eingehender Meldungen verwendet werden soll, sowie zum Definieren von Routingtabellen mit den Zielendpunkten, an die Meldungen bei Filterübereinstimmung gesendet werden sollen.
<serviceHostingEnvironment> Dieser Abschnitt definiert den Typ, der von der Diensthostumgebung für einen besonderen Transport instanziiert wird. Wenn dieser Abschnitt leer ist, wird der Standardtyp verwendet.
<services> Der Abschnitt enthält eine Auflistung von Diensten. Für jeden in der Assembly definierten Dienst enthält dieses Element ein service-Element mit den Einstellungen für den Dienst.
<standardEndpoints> Dieser Abschnitt definiert eine Auflistung von Standardendpunkten, bei denen es sich um wiederverwendbare vorkonfigurierte Endpunkte handelt. Bei einem Standardendpunkt werden eines oder mehrere der Attribute für Adresse, Bindung und Vertrag vorab festgelegt. Zum Beispiel ist der Vertrag im Ermittlungsendpunkt ein fester Wert. Sie können Standardendpunkte auch verwenden, um Dienstendpunkte mit neuen Eigenschaften zu erweitern, ähnlich wie bei der Definition benutzerdefinierter Bindungen.
<tracking> In diesem Abschnitt werden Überwachungseinstellungen für einen Workflowdienst definiert.

Übergeordnete Elemente

Element BESCHREIBUNG
<Konfiguration> Das Stammelement für alle Konfigurationselemente in einer Konfigurationsdatei.

Bemerkungen

WCF fügt den Konfigurationsabschnitten anderer Produkte keine Elemente hinzu.

WCF-Dienste werden im Abschnitt services der Konfigurationsdatei definiert. Eine Assembly kann eine beliebige Anzahl von Diensten enthalten. Jeder Dienst hat seinen eigenen service-Konfigurationsabschnitt. Dieser Abschnitt und sein Inhalt definieren den Dienstvertrag, das Verhalten und die Endpunkte des Diensts.

Es wird lediglich das name-Attribut eines Diensts benötigt. Standardmäßig beschreibt ein Dienstname den zugrunde liegenden CLR-Typ, der für die Implementierung eines Diensts verwendet wird. Sie können jedoch die ConfigurationName-Eigenschaft eines ServiceContractAttribute ändern, um die CLR-Typanforderung zu überschreiben.

Das behaviorConfiguration-Attribut ist optional. Es identifiziert das von einem Dienst verwendete Dienstverhalten. Das von diesem Attribut angegebene Verhalten muss mit einem Dienstverhalten im Gültigkeitsbereich der gleichen Konfigurationsdatei (das heißt derselben Datei oder einer übergeordneten Datei) verknüpft sein.

Jeder Dienst macht einen oder mehrere in einem endpoint-Element definierte Endpunkte verfügbar. Jeder Endpunkt hat eine eigene Adresse und eine eigene Bindung. Alle Bindungen innerhalb der Konfigurationsdatei müssen im Gültigkeitsbereich der Datei definiert sein.

Bindungen sind durch die Kombination aus name-Attribut und bindingConfiguration-Attribut mit Endpunkten verknüpft. Das binding-Attribut definiert, in welchem Abschnitt die Bindung definiert ist. Das bindingConfiguration-Attribut legt fest, welche konfigurierte Bindung innerhalb des Bindungsabschnitts verwendet wird. Ein Bindungsabschnitt kann verschiedene konfigurierte Bindungen definieren.

Beispiel

Hier sehen Sie ein Beispiel einer WCF-Konfigurationsdatei.

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

Siehe auch