<endpoint> 元素

  • 项目

指定用于公开服务的服务终结点的绑定、协定和地址属性。

<system.serviceModel>
  <service>
    <endpoint> 元素

<endpoint address="String"
   behaviorConfiguration="String"
   binding="String"
   bindingConfiguration="String"
   bindingName="String"
   bindingNamespace="String"
   contract="String"
      listenUriMode="Explicit/Unique"
   listenUri="Uri"
</endpoint>

属性和元素

属性

属性 说明

address

一个包含终结点地址的字符串。可以将地址指定为绝对地址或相对地址。如果提供的是相对地址，则需要主机提供适合于绑定中所使用的传输方案的基址。如果未配置地址，则假定基址为该终结点的地址。

默认值为一个空字符串。

behaviorConfiguration

一个字符串，其中包含要用于终结点的行为的名称。

binding

必需的字符串属性。

指定要使用的绑定的类型。该类型必须具有一个已注册的配置节，才能加以引用。该类型是按节名而不是绑定的类型名注册的。

bindingConfiguration

一个字符串，指定实例化终结点时所使用的绑定的绑定名称。定义终结点时，绑定名称必须在作用域内。默认值为一个空字符串。

此属性与 binding 结合使用，以引用配置文件中的特定绑定配置。如果尝试使用自定义绑定，请设置此属性。否则，可能引发异常。

bindingName

一个字符串，指定绑定的唯一限定名称，用于通过 WSDL 进行的定义导出。默认值为一个空字符串。

bindingNamespace

一个字符串，指定绑定的命名空间的限定名称，用于通过 WSDL 进行的定义导出。默认值为一个空字符串。

contract

一个字符串，指示此终结点公开了哪个协定。程序集必须实现该协定类型。如果服务实现所实现的是单个协定类型，则可以省略此属性。默认值为一个空字符串。

listenUriMode

指定传输如何处理供服务侦听的 ListenUri。有效值为

  • Explicit
  • Unique

默认值为 Explicit。

listenUri

一个字符串，指定服务终结点侦听的 URI。默认值为一个空字符串。

子元素

元素 说明

<headers>

一个地址标头集合。

<identity>

一个标识，与某个终结点交换消息的其他终结点可以使用该标识对该终结点进行身份验证。

父元素

元素 说明

<service>

一个配置节，定义客户端可以连接的终结点的列表。

示例

这是服务终结点配置的一个示例。

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

另请参见

参考

ServiceEndpointElement
EndpointAddress
ServiceEndpoint

其他资源

Endpoints: Addresses, Bindings, and Contracts
How to: Create a Service Endpoint in Configuration