<<system.serviceModel>>

  • Artikel

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

<system.serviceModel>
    <behaviors>
    </behaviors>
    <bindings>
    </bindings>
    <client>
    </client>
    <comContracts>
    </comContracts>
    <commonBehaviors>
    </commonBehaviors>
    <diagnostics>
    </diagnostics>
    <extensions>
    </extensions>
    <serviceHostingEnvironment>
    </serviceHostingEnvironment>
    <services>
    </services>
</system.serviceModel>

Attribute und Elemente

Attribute

None

Untergeordnete Elemente

Element Beschreibung

<behaviors>

Dieses Element definiert zwei untergeordnete Auflistungen mit den Namen endpointBehaviors und serviceBehaviors. Jede Auflistung definiert von Endpunkten und Diensten verwendete Verhaltenselemente. Jedes Verhaltenselement wird durch seinen eindeutigen name identifiziert.

<bindings>

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

Dieses Element enthält eine Liste mit Endpunkten, die ein Client für die Verbindungsherstellung mit einem Dienst verwendet.

<comContracts>

Dieses Element definiert für WCF und COM-Interop aktivierte COM-Verträge.

<commonBehaviors>

Dieses Element kann nur in der Datei machine.config definiert werden. Es 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 <commonBehaviors>-Abschnitt und im <behaviors>-Abschnitt definiert ist, wird dem Verhalten im <behaviors>-Abschnitt Priorität eingeräumt.

<extensions>-Abschnitt

Dieses Element enthält eine Auflistung von Erweiterungen, mit deren Hilfe der Benutzer benutzerdefinierte Bindungen, Verhalten und andere Aspekte von Erweiterungen erstellen kann.

<diagnostics>

Dieses Element enthält Einstellungen für die Diagnosefeatures von WCF. Der Benutzer kann Ablaufverfolgung, Leistungsindikatoren und den WMI-Anbieter aktivieren/deaktivieren und benutzerdefinierte Meldungsfilter hinzufügen.

<serviceHostingEnvironment>

Dieses Element definiert den Typ, der von der Diensthostumgebung für einen besonderen Transport instanziiert wird. Wenn dieser Abschnitt leer ist, wird der Standardtyp verwendet.

<services>

Das Element 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.

Übergeordnete Elemente

Element Beschreibung

<Konfiguration>

Das Stammelement für alle Konfigurationselemente in einer Konfigurationsdatei.

Hinweise

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

WCF-Dienste werden im services-Abschnitt 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 bindungConfiguration-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

Referenz

ServiceModelSectionGroup