每个终结点都具有与其关联的地址,该地址用于查找和标识终结点。 此地址主要包括指定终结点位置的统一资源标识符 (URI)。 通过 Windows Communication Foundation (WCF) 编程模型中表示终结点地址xref:System.ServiceModel.EndpointAddress类,该类包含一个可选xref:System.ServiceModel.EndpointAddress.Identity*进行身份验证的其他终结点的终结点的属性,交换消息,以及一组可选xref:System.ServiceModel.EndpointAddress.Headers*属性,用于定义访问的服务所需的任何其他 SOAP 头。 可选头提供其他的更详细寻址信息以标识服务终结点或与之交互。 终结点的地址在网络上表示为 WS-Addressing 终结点引用 (EPR)。
地址的 URI 结构
大多数传输的地址 URI 包含四个部分。 例如,URI 的四个部分 http://www.fabrikam.com:322/mathservice.svc/secureEndpoint 可以详细列举了,如下所示:
-
方案:
http: -
计算机:
www.fabrikam.com -
(可选)端口:322
-
路径:/mathservice.svc/secureEndpoint
定义服务地址
您可以通过使用代码以强制方式或通过配置以声明方式指定服务的终结点地址。 在代码中定义终结点通常是不可行的,因为已部署服务的绑定和地址通常与在部署服务时所用的绑定和地址不同。 一般而言,使用配置定义服务终结点比使用代码更为可行。 通过在代码之外保存绑定和寻址信息,无须重新编译或重新部署应用程序即可更改它们。
在配置中定义地址
若要在配置文件中定义终结点,请使用<终结点 >元素。 有关详细信息和示例,请参阅指定一个终结点地址。
在代码中定义地址
在代码中可以使用 xref:System.ServiceModel.EndpointAddress 类创建终结点地址。 有关详细信息和示例,请参阅指定一个终结点地址。
WSDL 中的终结点
在 WSDL 中终结点地址也可以表示为对应终结点的 wsdl:port 元素内的 WS-Addressing EPR 元素。 EPR 包含终结点的地址以及所有的地址属性。 有关详细信息和示例,请参阅指定一个终结点地址。
多个 IIS 绑定在.NET Framework 3.5 中支持
Internet 服务提供商通常在同一服务器和站点上承载许多应用程序,以增加站点密度和降低总拥有成本。 这些应用程序通常绑定到不同的基址。 Internet 信息服务 (IIS) 网站可以包含多个应用程序。 可以通过一个或多个 IIS 绑定访问站点中的应用程序。
IIS 绑定提供了两则信息:绑定协议和绑定信息。 绑定协议定义发生通信所依据的方案,而绑定信息是用于访问站点的信息。
下面的示例演示可以存在于 IIS 绑定中的组件:
-
绑定协议:HTTP
-
绑定信息:IP 地址、 端口、 主机标头
IIS 可以为每个站点指定多个绑定,这会导致每个方案有多个基址。 早于.NET Framework 3.5,WCF 的架构不支持多个地址,并且如果它们已指定,则引发xref:System.ArgumentException在激活过程。
通过 .NET Framework 3.5,Internet 服务提供商可以在同一站点上使用同一方案的不同基址承载多个应用程序。
例如,一个站点可能包含以下基址:
-
http://payroll.myorg.com/Service.svc -
http://shipping.myorg.com/Service.svc
使用 .NET Framework 3.5,可以在配置文件中指定 AppDomain 级别的前缀筛选器。 为此可以使用 <baseAddressPrefixFilters >元素,它包含的前缀列表。 基于可选前缀列表筛选由 IIS 提供的传入基址。 默认情况下,如果未指定前缀,则使所有地址通过。 指定前缀导致仅使该方案的匹配基址通过。
下面的配置代码示例使用前缀筛选器。
<system.serviceModel>
<serviceHostingEnvironment>
<baseAddressPrefixFilters>
<add prefix="net.tcp://payroll.myorg.com:8000"/>
<add prefix="http://shipping.myorg.com:8000"/>
</baseAddressPrefixFilters>
</serviceHostingEnvironment>
</system.serviceModel>
在前面的示例中,net.tcp://payroll.myorg.com:8000和http://shipping.myorg.com:8000是通过传递其各自方案的唯一基址。
baseAddressPrefixFilter 不支持通配符。
IIS 提供的基址可能具有绑定到 baseAddressPrefixFilters 列表中不存在的其他方案的地址。 不会筛选出这些地址。
.NET Framework 4 以及更高版本中的多个 IIS 绑定支持
从 .NET 4 开始,通过将 xref:System.ServiceModel.ServiceHostingEnvironment 的 xref:System.ServiceModel.ServiceHostingEnvironment.MultipleSiteBindingsEnabled* 设置为 True,你无需选取单个基址便可实现对 IIS 中多个绑定的支持。 此支持限于 HTTP 协议方案。
以下是示例的配置代码上使用 multipleSiteBindingsEnabled <serviceHostingEnvironment >。
<system.serviceModel>
<serviceHostingEnvironment multipleSiteBindingsEnabled="true" >
</serviceHostingEnvironment>
</system.serviceModel>
对于 HTTP 和非 HTTP 协议,当使用此设置启用多个网站绑定时,忽略任何 baseAddressPrefixFilter 设置。
有关详细信息和示例,请参阅支持多个 IIS 站点绑定和xref:System.ServiceModel.ServiceHostingEnvironment.MultipleSiteBindingsEnabled*。
在 WCF 服务中扩展寻址
默认寻址模式的 WCF 服务使用终结点地址 URI 用于下列目的:
-
指定服务侦听地址,即终结点侦听消息的位置,
-
指定 SOAP 地址筛选器,即终结点期望作为 SOAP 头的地址。
可以单独指定用于其中每个目的的值,从而允许涉及有用方案的若干寻址扩展:
-
SOAP 媒介:客户端发送的消息在到达其最终目的地之前遍历一个或多个处理消息的其他服务。 SOAP 媒介可以执行各种任务,如对消息进行缓存、路由、负载平衡或架构验证。 此方案是通过将消息发送到单独的物理地址(
via,以媒介为目标),而不是仅发送到逻辑地址(wsa:To,以最终目的地为目标)完成的。 -
终结点的侦听地址是专用 URI,它设置为与其
listenURI属性不同的值。
via 指定的传输地址是将消息发往 to 参数指定的、服务所在的某个其他远程地址途中应该最初发送到的地址。 在大多数 Internet 方案中,via URI 与服务的最终 xref:System.ServiceModel.EndpointAddress.Uri* 地址的 to 属性相同。 仅当必须执行手动路由时,才区分这两个地址。
寻址头
除了其基本 URI 外,终结点可以按一个或多个 SOAP 标头寻址。 这一点在其中很有用的一组方案是一组 SOAP 媒介方案,其中终结点要求该终结点的客户端包括以媒介为目标的 SOAP 头。
可以通过两种方法定义自定义地址头 - 使用代码或使用配置:
-
在代码中,通过使用 xref:System.ServiceModel.Channels.AddressHeader 类创建自定义地址头,然后在构造 xref:System.ServiceModel.EndpointAddress 时使用它。
配置通常比代码更可取,因为它允许你在部署后更改头。
自定义侦听地址
可以将侦听地址设置为与终结点的 URI 不同的值。 在要公开的 SOAP 地址为公共 SOAP 媒介的地址,而终结点实际侦听的地址是专用网络地址的媒介方案中,这是很有用的。
可以通过使用代码或配置指定自定义侦听地址:
-
在代码中,通过将 xref:System.ServiceModel.Description.ClientViaBehavior 类添加到终结点的行为集合指定自定义侦听地址。
-
在配置中,指定使用自定义侦听地址
ListenUri服务的特性<终结点 >元素。
自定义 SOAP 地址筛选器
xref:System.ServiceModel.EndpointAddress.Uri* 与任何 xref:System.ServiceModel.EndpointAddress.Headers* 属性联合使用,以定义终结点的 SOAP 地址筛选器 (xref:System.ServiceModel.Dispatcher.EndpointDispatcher.AddressFilter*)。 默认情况下,此筛选器验证传入消息是否具有与终结点的 URI 匹配的 To 消息头,以及所有必需的终结点头是否存在于消息中。
在某些方案中,终结点接收抵达基础传输的所有消息,而不仅仅是具有相应 To 头的消息。 若要启用这一点,用户可以使用 xref:System.ServiceModel.Dispatcher.MatchAllMessageFilter 类。
请参阅
历史资料。此文对应 2019-08-18 的中文文档快照,适用产品版本和命令行为以原文为准。
来源与署名:Microsoft 和文档贡献者。固定版本原文。文档采用 CC BY 4.0,示例代码采用 MIT 授权。本站展开固定版本仓库内的引用内容,将 Markdown 转为 HTML,规范化链接,移除外部媒体和导航标记。
