<endpointDiscovery>

  • [アーティクル]

エンドポイントのさまざまな探索設定を指定します (探索可能性、スコープ、メタデータに対するカスタム拡張など)。

configuration
  system.serviceModel
    behaviors
      endpointBehaviors
        behavior
          <endpointDiscovery>

構文

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

属性および要素

以降のセクションでは、属性、子要素、および親要素について説明します。

属性

属性 説明
enabled 探索可能性をこのエンドポイントで有効にするかどうかを指定するブール値。 既定では、 falseです。

子要素

要素 説明
<scopes> エンドポイントのスコープ URI のコレクション。 複数の URI を 1 つのエンドポイントに関連付けることができます。
<extensions> [<endpointDiscovery> の] エンドポイントで発行されるカスタム メタデータを指定できる、XML 要素のコレクション。
<types> 検索するインターフェイスのコレクション。

親要素

要素 説明
<behavior> 動作の要素を指定します。

解説

エンドポイントの動作構成に追加し、enabled 属性を true に設定すると、この構成要素の探索可能性が有効になります。 <scopes> 子要素を使用して、クエリの実行中にサービス エンドポイントのフィルターに使用できるカスタム スコープ URI を指定することもできます。また、<extensions> 子要素を使用して、標準の探索可能なメタデータと共に発行する必要のあるカスタム メタデータを指定することも可能です (EPR、ContractTypeName、BindingName、Scope、ListenURI)。

この構成要素は、探索可能性のサービス レベルでの制御を提供する <serviceDiscovery> 要素に依存します。 これは、構成に <serviceDiscovery> が指定されていない場合、この要素の設定が無視されることを意味します。

例

次の構成例では、フィルターのスコープと、エンドポイントで発行される拡張メタデータを指定しています。

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

関連項目