<endpoint> 元素

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

架构层次结构

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

语法

<endpoint address="String"
   behaviorConfiguration="String"
   binding="String"
   bindingConfiguration="String"
   bindingName="String"
   bindingNamespace="String"
   contract="String"
   endpointConfiguration=”String”   isSystemEndpoint=”Boolean”   kind=”String”   listenUriMode="Explicit/Unique"
   listenUri="Uri"
</endpoint>

属性和元素

以下几节描述了属性、子元素和父元素。

属性

属性	说明
address	一个包含终结点地址的字符串。可以将地址指定为绝对地址或相对地址。如果提供的是相对地址，则需要主机提供适合于绑定中所使用的传输方案的基址。如果未配置地址，则假定基址为该终结点的地址。 默认值为一个空字符串。
behaviorConfiguration	一个字符串，其中包含要在终结点中使用的行为的名称。
绑定	必需的字符串属性，此属性指定要使用的绑定类型。该类型必须具有一个已注册的配置节，才能加以引用。该类型是按节名而不是绑定的类型名注册的。
bindingConfiguration	一个字符串，指定实例化终结点时所使用的绑定的绑定名称。定义终结点时，绑定名称必须在作用域内。默认值为一个空字符串。 此属性与 binding 结合使用，以引用配置文件中的特定绑定配置。如果尝试使用自定义绑定，请设置此属性。否则，可能引发异常。
bindingName	一个字符串，指定绑定的唯一限定名称，用于通过 WSDL 进行的定义导出。默认值为一个空字符串。
bindingNamespace	一个字符串，指定绑定的命名空间的限定名称，用于通过 WSDL 进行的定义导出。默认值为一个空字符串。
contract	一个字符串，指示此终结点公开了哪个协定。程序集必须实现该协定类型。如果服务实现所实现的是单个协定类型，则可以省略此属性。默认值为一个空字符串。
endpointConfiguration	一个字符串，指定由 kind 特性设置的标准终结点的名称，此名称引用此标准终结点的其他配置信息。必须在 <standardEndpoints> 节中定义相同的名称。
isSystemEndpoint	一个布尔值，指定终结点是否是基础结构终结点。
kind	一个字符串，指定应用的标准终结点的类型。此类型必须在 <extensions> 节或 machine.config 中进行注册。如果未指定任何值，则创建常规服务终结点。
listenUriMode	指定传输如何处理供服务侦听的 ListenUri。有效值为 Explicit Unique 默认值为 Explicit。
listenUri	一个字符串，指定服务终结点侦听的 URI。默认值为一个空字符串。
name	可选的特性。一个指定服务终结点名称的字符串。默认值为绑定名称和协定说明名称的串联。服务可能有多个终结点，因此终结点的 name 特性是通过服务名称区分的。

子元素

元素	说明
<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