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