<client> 的 <endpoint>

指定通道终结点的协定、绑定和地址属性,客户端使用通道终结点与服务器上的服务终结点连接。

<system.serviceModel>
  <client>
    <client> 的 <endpoint>

<endpoint address="String"
   behaviorConfiguration="String"
   binding="String"
   bindingConfiguration="String"
   contract="String"
   name=="String"
</endpoint>

属性和元素

属性

属性 说明

address

必需的字符串属性。

指定终结点的地址。默认值为一个空字符串。该地址必须为绝对 URI。

behaviorConfiguration

一个字符串,其中包含要用于实例化终结点的行为的行为名。定义服务时,该行为名必须在作用域内。默认值为一个空字符串。

binding

必需的字符串属性。

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

bindingConfiguration

可选。一个字符串,其中包含实例化终结点时要使用的绑定配置的名称。定义终结点时,绑定配置必须在作用域内。默认值为一个空字符串。

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

contract

必需的字符串属性。

一个字符串,指示此终结点公开了哪个协定。程序集必须实现该协定类型。

name

可选的字符串属性。此属性唯一标识给定协定的终结点。可以为一个给定协定类型定义多个客户端。每个定义都必须用唯一的配置名称加以区分。如果省略此属性,则将对应的终结点用作与指定协定类型相关联的默认终结点。默认值为一个空字符串。

绑定的 name 属性用于通过 WSDL 进行的定义导出。

子元素

元素 说明

<headers>

一个地址标头集合。

<identity>

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

父元素

元素 说明

<client>

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

示例

这是通道终结点配置的一个示例。

<endpoint address="/HelloWorld/"
    bindingConfiguration="usingDefaults"
    name="MyBinding"
    binding="customBinding"
    contract="HelloWorld">
</endpoint>

另请参见

参考

ChannelEndpointElement
ClientSection
ChannelEndpointElementCollection
Endpoints
ChannelEndpointElement

其他资源

WCF Client Configuration
Clients