Freigeben über

<Endpoint-Element>

Gibt Bindungs-, Vertrags- und Adresseigenschaften für einen Dienstendpunkt an, der zum Verfügbarmachen von Diensten verwendet wird.

<Konfiguration>
   <system.serviceModel>
     <Dienstleistungen>
       <Service>
         <Endpunkt>

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 sowie untergeordnete und übergeordnete Elemente beschrieben.

Attribute

Merkmal Description
address Eine Zeichenfolge, die die Adresse des Endpunkts enthält. Die Adresse kann als absolute oder relative Adresse angegeben werden. Wenn eine relative Adresse angegeben wird, wird erwartet, dass der Host eine Basisadresse bereitstellt, die für das transportschema geeignet ist, das in der Bindung verwendet wird. Wenn keine Adresse konfiguriert ist, wird die Basisadresse als Adresse für diesen Endpunkt angenommen.

Der Standardwert ist eine leere Zeichenfolge.
behaviorConfiguration Eine Zeichenfolge, die den Namen des Verhaltens enthält, das im Endpunkt verwendet werden soll.
binding Erforderliches Zeichenfolgen-Attribut, das den Typ der zu verwendenden Bindung angibt. Der Typ muss über einen registrierten Konfigurationsabschnitt verfügen, um darauf zu verweisen. Der Typ ist der name des Abschnitts und nicht der Typ der Bindung.
bindingConfiguration Eine Zeichenfolge, die den Bindungsnamen der Bindung angibt, die verwendet werden soll, wenn der Endpunkt instanziiert wird. Der Bindungsname muss sich am Punkt befinden, an dem der Endpunkt definiert ist. Der Standardwert ist eine leere Zeichenfolge.

Dieses Attribut wird zusammen mit binding dem Verweis auf eine bestimmte Bindungskonfiguration in der Konfigurationsdatei verwendet. Legen Sie dieses Attribut fest, wenn Sie versuchen, eine benutzerdefinierte Bindung zu verwenden. Andernfalls kann eine Ausnahme ausgelöst werden.
bindingName Eine Zeichenfolge, die den eindeutigen qualifizierten Namen der Bindung für den Definitionsexport über WSDL angibt. Der Standardwert ist eine leere Zeichenfolge.
bindingNamespace Eine Zeichenfolge, die den qualifizierten Namen des Namespace der Bindung für den Definitionsexport über WSDL angibt. Der Standardwert ist eine leere Zeichenfolge.
Vertrag Eine Zeichenfolge, die angibt, welchen Vertrag dieser Endpunkt verfügbar macht. Die Assembly muss den Vertragstyp implementieren. Wenn eine Dienstimplementierung einen einzelnen Vertragstyp implementiert, kann diese Eigenschaft weggelassen werden. Der Standardwert ist eine leere Zeichenfolge.
endpointConfiguration Eine Zeichenfolge, die den Namen des Vom Attribut festgelegten kind Standardendpunkts angibt, der auf die zusätzlichen Konfigurationsinformationen dieses Standardendpunkts verweist. Derselbe Name muss im <standardEndpoints> Abschnitt definiert werden.
isSystemEndpoint Ein boolescher Wert, der angibt, ob ein Endpunkt ein Infrastrukturendpunkt ist.
freundlich Eine Zeichenfolge, die den Typ des angewendeten Standardendpunkts angibt. Der Typ muss im <extensions> Abschnitt oder in machine.configregistriert werden. Wenn nichts angegeben ist, wird ein gemeinsamer Dienstendpunkt erstellt.
Listenurimode Gibt an, wie der Transport den ListenUri bereitgestellten Dienst behandelt, um aufzuhören. Gültige Werte sind

-Explizit
-Einzigartige

Der Standardwert ist "Explicit".
Listenuri Eine Zeichenfolge, die den URI angibt, an dem der Dienstendpunkt lauscht. Der Standardwert ist eine leere Zeichenfolge.
name Optionales Attribut. Eine Zeichenfolge, die den Namen des Dienstendpunkts angibt. Der Standardwert ist die Verkettung des Bindungsnamens und des Vertragsbeschreibungsnamens. Dienste verfügen möglicherweise über mehrere Endpunkte, sodass sich das Attribut des Endpunkts vom Namen des Diensts name unterscheidet.

Untergeordnete Elemente

Element Description
<Header> Eine Sammlung von Adressheadern.
<Identität> Eine Identität, die die Authentifizierung eines Endpunkts durch andere Endpunkte ermöglicht, die Nachrichten damit austauschen.

Übergeordnete Elemente

Element Description
<Service> Ein Konfigurationsabschnitt, der eine Liste von Endpunkten definiert, mit denen ein Client eine Verbindung herstellen kann.

Example

Dies ist ein Beispiel für eine Dienstendpunktkonfiguration.

<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

  • Last updated on