<endpoint> von <client>

Artikel
02/27/2011

Gibt die Vertrags-, Bindungs- und Adresseigenschaften für den Kanalendpunkt an, mit dem Clients eine Verbindung zu Dienstendpunkten auf dem Server herstellen.

Schemahierarchie

<<system.serviceModel>>
<client>
<endpoint> von <client>

Syntax

<endpoint address="String"
   behaviorConfiguration="String"
   binding="String"
   bindingConfiguration="String"
   contract="String"   endpointConfiguration=”String”   kind=”String”
   name="String"
</endpoint>

Attribute und Elemente

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

Attribute

Attribut	Beschreibung
address	Erforderliches Zeichenfolgeattribut. Gibt die Adresse des Endpunkts an. Der Standardwert ist eine leere Zeichenfolge. Die Adresse muss ein absoluter URI sein.
behaviorConfiguration	Eine Zeichenfolge mit dem Namen des Verhaltens, das zur Instanziierung des Endpunkts verwendet werden soll. Der Verhaltensname muss sich bei der Dienstdefinition im Gültigkeitsbereich befinden. Der Standardwert ist eine leere Zeichenfolge.
binding	Erforderliches Zeichenfolgenattribut. Eine Zeichenfolge, die den Typ der zu verwendenden Bindung angibt. Dieser muss einen registrierten Konfigurationsabschnitt aufweisen, um darauf verweisen zu können. Der Typ wird anhand des Abschnittsnamens registriert, nicht anhand des Typnamens der Bindung.
bindingConfiguration	Optional. Eine Zeichenfolge, die den Namen der Bindungskonfiguration enthält, die beim Instanziieren des Endpunkts verwendet werden soll. Die Bindungskonfiguration 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.
contract	Erforderliches Zeichenfolgenattribut. Eine Zeichenfolge, die angibt, welche Verträge von diesem Endpunkt verfügbar gemacht werden. Die Assembly muss den Vertragstyp implementieren.
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.
kind	Eine Zeichenfolge, die den Typ des angewendeten Standardendpunkts angibt. Der Typ muss im Abschnitt <extensions> oder in machine.config registriert werden. Wenn nichts angegeben wird, wird ein allgemeiner Channelendpunkt erstellt.
name	Optionales Zeichenfolgeattribut. Dieses Attribut identifiziert eindeutig einen Endpunkt für einen angegebenen Vertrag. Sie können für einen angegebenen Vertragstyp mehrere Clients definieren. Jede Definition muss sich durch einen eindeutigen Konfigurationsnamen unterscheiden. Wenn dieses Attribut nicht angegeben wird, wird der entsprechende Endpunkt als Standardendpunkt verwendet, der mit dem angegebenen Vertragstyp verknüpft ist. Der Standardwert ist eine leere Zeichenfolge. Das name-Attribut einer Bindung wird zum Definitionsexport durch WSDL verwendet.

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
<client>	Ein Konfigurationsabschnitt, der eine Liste mit Endpunkten definiert, zu denen ein Client eine Verbindung herstellen kann.

Beispiel

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

<endpoint address="/HelloWorld/"
    bindingConfiguration="usingDefaults"
    name="MyBinding"
    binding="customBinding"
    contract="HelloWorld">
</endpoint>

Siehe auch

Verweis

ChannelEndpointElement
ClientSection
ChannelEndpointElementCollection
Endpoints
ChannelEndpointElement

Weitere Ressourcen

WCF Client Configuration
Clients

Freigeben über