<endpoint> von <client>
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 |
---|---|
Eine Auflistung von Adressheadern. |
|
Eine Identität, mit der die Authentifizierung eines Endpunkts durch andere Endpunkte aktiviert wird, mit denen Nachrichten ausgetauscht werden. |
Übergeordnete Elemente
Element | Beschreibung |
---|---|
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