<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

子元素

元素 说明
<范围> 终结点的范围 URI 集合。 一个终结点可以与多个范围 URI 关联。
<扩展> [of <endpointDiscovery>] 一个 XML 元素集合,用于指定要对终结点发布的自定义元数据。
<types> 要搜索的接口集合。

父元素

元素 说明
<behavior> 指定行为元素。

备注

如果将此配置元素添加到终结点的行为配置,并将 enabled 特性设置为 true,此配置元素将启用该终结点的可发现性。 此外,还可以使用 子元素指定可用于在查询时筛选服务终结点的自定义范围 URI,并使用 子元素指定应随可检测到的标准元数据(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>

请参阅