<endpoint>-Element

Gibt die Bindung, den Vertrag und Adresseigenschaften für einen Dienstendpunkt an, der zur Verfügbarmachung von Diensten verwendet wird.

Schemahierarchie

<<system.serviceModel>>
  <service>
    <endpoint>-Element

Syntax

<endpoint address="String"
   behaviorConfiguration="String"
   binding="String"
   bindingConfiguration="String"
   bindingName="String"
   bindingNamespace="String"
   contract="String"
   endpointConfiguration=”String”   isSystemEndpoint=”Boolean”   kind=”String”   listenUriMode="Explicit/Unique"
   listenUri="Uri"
</endpoint>

Attribute und Elemente

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

Attribute

Attribut Beschreibung

address

Eine Zeichenfolge mit der Adresse des Endpunkts. Die Adresse kann als absolute oder relative Adresse angegeben werden. Bei Bereitstellung einer relativen Adresse wird vom Host erwartet, dass er eine Basisadresse bereitstellt, die für das in der Bindung verwendete Transportschema geeignet ist. Wenn keine Adresse konfiguriert wird, wird angenommen, dass die Basisadresse der Adresse für diesen Endpunkt entspricht.

Der Standardwert ist eine leere Zeichenfolge.

behaviorConfiguration

Eine Zeichenfolge mit dem Namen des Verhaltens, das am Endpunkt verwendet werden soll.

binding

Erforderliches Zeichenfolgenattribut, das den Typ der zu verwendenden Bindung angibt. Dieser muss einen registrierten Konfigurationsabschnitt aufweisen, da sonst nicht auf ihn verwiesen werden kann. Der Typ wird anhand des Abschnittsnamens registriert, nicht anhand des Typnamens der Bindung.

bindingConfiguration

Eine Zeichenfolge, die den Namen der Bindung enthält, die beim Instanziieren des Endpunkts verwendet werden soll. Der Name der Bindung muss sich bei der Endpunktdefinition im Gültigkeitsbereich befinden. Der Standardwert ist eine leere Zeichenfolge.

Dieses Attribut wird zusammen mit binding zum Verweisen auf eine spezifische Bindungskonfiguration in der Konfigurationsdatei verwendet. Legen Sie dieses Attribut fest, wenn Sie eine benutzerdefinierte Bindung verwenden möchten. Andernfalls wird unter Umständen eine Ausnahme ausgelöst.

bindingName

Eine Zeichenfolge, die den eindeutigen qualifizierten Namen der Bindung für den Definitionsexport über WSDL definiert. Der Standardwert ist eine leere Zeichenfolge.

bindingNamespace

Eine Zeichenfolge, die den qualifizierten Namen des Namespaces der Bindung für den Definitionsexport über WSDL definiert. Der Standardwert ist eine leere Zeichenfolge.

contract

Eine Zeichenfolge, die angibt, welche Verträge von diesem Endpunkt verfügbar gemacht werden. Die Assembly muss den Vertragstyp implementieren. Wenn eine Dienstimplementierung einen einzelnen Vertragstyp implementiert, kann diese Eigenschaft ausgelassen werden. Der Standardwert ist eine leere Zeichenfolge.

endpointConfiguration

Eine Zeichenfolge, die den Namen des Standardendpunkts angibt, der mit dem kind-Attribut festgelegt wird, das auf die zusätzlichen Konfigurationsinformationen dieses Standardendpunkts verweist. Der gleiche Name muss im Abschnitt <standardEndpoints> definiert werden.

isSystemEndpoint

Ein boolescher Wert, der angibt, ob ein Endpunkt ein Infrastrukturendpunkt ist.

kind

Eine Zeichenfolge, die den Typ des angewendeten Standardendpunkts angibt. Der Typ muss im Abschnitt <extensions> oder in machine.config registriert werden. Wenn kein Wert angegeben wird, wird ein allgemeiner Dienstendpunkt erstellt.

listenUriMode

Gibt an, wie der Transport die ListenUri verarbeitet, die für die Überwachung durch den Dienst bereitgestellt wurde. Gültige Werte sind:

  • Explicit

  • Unique

Der Standardwert ist Explicit.

listenUri

Eine Zeichenfolge mit dem URI, an dem der Dienstendpunkt die Überwachung vornimmt. Der Standardwert ist eine leere Zeichenfolge.

name

Optionales Attribut. Eine Zeichenfolge, die den Namen des Dienstendpunkts angibt. Der Standardwert ist die Verkettung des Bindungsnamen und des Vertragsbeschreibungsnamens. Dienste haben möglicherweise mehrere Endpunkte, sodass das name-Attribut des Endpunkts sich vom Namen des Diensts unterscheidet.

Untergeordnete Elemente

Element Beschreibung

<headers>

Eine Auflistung von Adressheadern.

<identity>

Eine Identität, mit der die Authentifizierung eines Endpunkts durch andere Endpunkte aktiviert wird, mit denen Nachrichten ausgetauscht werden.

Übergeordnete Elemente

Element Beschreibung

<service>

Ein Konfigurationsabschnitt, der eine Liste mit Endpunkten definiert, zu denen ein Client eine Verbindung herstellen kann.

Beispiel

Dies ist ein Beispiel für eine Dienstendpunkt-Konfiguration.

<endpoint 
    address="/HelloWorld/"
    bindingConfiguration="usingDefaults"
    bindingName="MyBinding"
    binding="customBinding"
    contract="HelloWorld">
    <Headers>
       <Region xmlns="http://tempuri.org/">EastCoast</Region>
       <Member xmlns="http://tempuri.org/">Gold</Member>
    </Headers>
</endpoint>

Siehe auch

Verweis

ServiceEndpointElement
EndpointAddress
ServiceEndpoint

Weitere Ressourcen

Endpoints: Addresses, Bindings, and Contracts
How to: Create a Service Endpoint in Configuration