<service>

Artikel
06/08/2023

Das service-Element enthält die Einstellungen für einen Windows Communication Foundation (WCF)-Dienst. Es enthält außerdem Endpunkte, die den Dienst verfügbar machen.

<configuration>
  <system.serviceModel>
    <services>
      <service>

Syntax

<service behaviorConfiguration="String"
         name="String">
</service>

Attribute und Elemente

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

Attribute

attribute	Beschreibung
behaviorConfiguration	Eine Zeichenfolge mit dem Namen des Verhaltens, das zum Instanziieren des Diensts verwendet werden soll. Der Verhaltensname muss sich bei der Dienstdefinition im Gültigkeitsbereich befinden. Der Standardwert ist eine leere Zeichenfolge.
name	Erforderliches Zeichenfolgenattribut, das den Typ des zu instanziierenden Diensts angibt. Diese Einstellung muss einem gültigen Typ entsprechen. Das Format muss `Namespace.Class.` lauten.

Untergeordnete Elemente

Element	BESCHREIBUNG
<endpoint>	Eine Auflistung von `endpoint`-Elementen, die diesen Dienst verfügbar machen.
<host>	Gibt den Host dieser Dienstinstanz an. Dieses Element ist vom Typ HostElement.

Übergeordnete Elemente

Element	BESCHREIBUNG
<services>	Das Stammelement aller WCF-Konfigurationselemente.

Bemerkungen

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.

Das behaviorConfiguration-Element ist optional. Es identifiziert das vom Dienst verwendete Verhalten. Das in diesem Attribut angegebene Verhalten muss mit einem Verhalten im Gültigkeitsbereich der gleichen Konfigurationsdatei verknüpft sein.

Jeder Dienst macht einen oder mehrere Endpunkte verfügbar, der über seine eigene Adresse und Bindung verfügt. 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 name-Attribut beschreibt, in welchem Abschnitt die Bindung definiert ist. Das bindingConfiguration-Attribut legt fest, welche Konfiguration innerhalb des Bindungsabschnitts verwendet wird. Ein Bindungsabschnitt kann verschiedene Konfigurationen definieren.

Beispiel

Dies ist ein Beispiel für eine Dienstkonfiguration.

<service behaviorConfiguration="testChannelBehavior"
         name="HelloWorld">
  <endpoint address="/HelloWorld2/"
            name="test"
            bindingNamespace="http://www.cohowinery.com/"
            binding="basicHttpBinding"
            contract="IHelloWorld" />
</service>