<endpointDiscovery>

Artikel
04/07/2023

Gibt die verschiedenen Ermittlungseinstellungen für einen Endpunkt an, z. B. seine Ermittelbarkeit, seine Bereiche und benutzerdefinierte Erweiterungen seiner Metadaten.

<configuration>
  <system.serviceModel>
    <behaviors>
      <endpointBehaviors>
        <behavior>
          <endpointDiscovery>

Syntax

<behaviors>
  <endpointBehaviors>
    <behavior name="String">
      <endpointDiscovery enabled="Boolean">
        <scopes>
          <add scope="URI"/>
        </scopes>
        <extensions />
      </endpointDiscovery>
    </behavior>
  </endpointBehaviors>
</behaviors>

Attribute und Elemente

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

Attribute

attribute	BESCHREIBUNG
enabled	Ein boolescher Wert, der angibt, ob die Ermittelbarkeit für diesen Endpunkt aktiviert ist. Der Standardwert ist `false`.

Untergeordnete Elemente

Element	BESCHREIBUNG
<Bereiche>	Eine Auflistung von Bereichs-URIs für den Endpunkt. Einem Endpunkt können mehrere Bereichs-URIs zugeordnet werden.
<extensions> [von <endpointDiscovery>]	Eine Auflistung von XML-Elementen, die Ihnen ermöglicht, benutzerdefinierte Metadaten anzugeben, die für einen Endpunkt veröffentlicht werden sollen.
<types>	Eine Auflistung von Schnittstellen, nach denen gesucht werden soll.

Übergeordnete Elemente

Element	BESCHREIBUNG
<behavior>	Gibt ein Verhaltenselement an.

Bemerkungen

Bei Hinzufügung zur Verhaltenskonfiguration des Endpunkts und bei Festlegen des enabled-Attributs auf true aktiviert dieses Konfigurationselement seine Ermittelbarkeit. Darüber hinaus können Sie mit dem untergeordneten <scopes>-Element benutzerdefinierte Bereichs-URIs angeben, mit denen Dienstendpunkte während der Abfrage gefiltert werden können, und mit dem untergeordneten <extensions>-Element können Sie benutzerdefinierte Metadaten angeben, die mit den standardmäßig sichtbaren Metadaten (EPR, ContractTypeName, BindingName, Scope und ListenURI) veröffentlicht werden sollen.

Dieses Konfigurationselement ist abhängig vom <serviceDiscovery>-Element, das die Steuerung der Ermittelbarkeit auf Dienstebene bereitstellt. Das heißt, die Einstellungen dieses Elements werden ignoriert, wenn <serviceDiscovery> in der Konfiguration nicht vorhanden ist.

Beispiel

Im folgenden Konfigurationsbeispiel werden Filterbereiche und Erweiterungsmetadaten angegeben, die für einen Endpunkt veröffentlicht werden sollen.

<services>
  <service name="CalculatorService"
           behaviorConfiguration="CalculatorServiceBehavior">
    <endpoint binding="basicHttpBinding"
              address="calculator"
              contract="ICalculatorService"
              behaviorConfiguration="calculatorEndpointBehavior" />
  </service>
</services>
<behaviors>
  <serviceBehaviors>
    <behavior name="CalculatorServiceBehavior">
      <serviceDiscovery />
    </behavior>
  </serviceBehaviors>
  <endpointBehaviors>
    <behavior name="calculatorEndpointBehavior">
      <endpointDiscovery enabled="true">
        <scopes>
          <add scope="http://contoso/test1" />
          <add scope="http://contoso/test2" />
        </scopes>
        <extensions>
          <e:Publisher xmlns:e="http://example.org">
            <e:Name>The Example Organization</e:Name>
            <e:Address>One Example Way, ExampleTown, EX 12345</e:Address>
            <e:Contact>support@example.org</e:Contact>
          </e:Publisher>
          <AnotherCustomMetadata>Custom Metadata</AnotherCustomMetadata>
        </extensions>
      </endpointDiscovery>
    </behavior>
  </endpointBehaviors>
</behaviors>

Siehe auch

EndpointDiscoveryBehavior

Share via