Freigeben über


<endpoint>-Element

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

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

<endpoint address="String"
   behaviorConfiguration="String"
   binding="String"
   bindingConfiguration="String"
   bindingName="String"
   bindingNamespace="String"
   contract="String"
      listenUriMode="Explicit/Unique"
   listenUri="Uri"
</endpoint>

Attribute und Elemente

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 Zeichenfolgeattribut.

Gibt den Typ der zu verwendenden Bindung an. 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.

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.

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

Referenz

ServiceEndpointElement
EndpointAddress
ServiceEndpoint

Weitere Ressourcen

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