开发和部署托管在 Internet Information Services (IIS) 中的 Windows Communication Foundation (WCF) 服务包括以下任务:
请确保正确安装和注册 IIS、ASP.NET、WCF 和 WCF 激活组件。
创建新的 IIS 应用程序或重新使用现有的 ASP.NET 应用程序。
为 WCF 服务创建 .svc 文件。
将服务实现部署到 IIS 应用程序。
配置 WCF 服务。
有关创建 IIS 托管的 WCF 服务的详细演练,请参阅
如何:在 IIS 中托管 WCF 服务
。
确保已正确安装和注册 IIS、ASP.NET 和 WCF
必须同时安装 WCF、IIS 和 ASP.NET,这样 IIS 托管的 WCF 服务才能正常工作。 安装 WCF(作为 NET Framework 的一部分)、ASP.NET 和 IIS 的过程因所使用的操作系统版本不同而不同。 若要详细了解如何安装 WCF 和 .NET Framework,请参阅
安装面向开发人员的 .NET Framework
。 若要在 Windows 10 上安装 IIS,请在“控制面板”中打开“程序和功能”,然后选择“打开或关闭 Windows 功能”。 在“Windows 功能”中,选择“Internet Information Services”,然后选择“确定”。
有关在其他操作系统上安装 IIS 的说明,请参阅
在 Windows Vista 和 Windows 7 上安装 ISS
和
在 Windows Server 2012 R2 上安装 IIS 8.5
。
如果计算机上已存在 IIS,则在安装 .NET Framework 的过程中会自动向 IIS 注册 WCF。 如果在 .NET Framework 之后安装 IIS,则需要执行额外的步骤来向 IIS 和 ASP.NET 注册 WCF。 根据您的操作系统,可以按如下所述执行此操作:
Windows 7 和 Windows Server 2003:使用
ServiceModel 注册工具 (ServiceModelReg.exe)
工具向 IIS 注册 WCF。 若要打开此工具,请在
Visual Studio 开发人员命令提示或 Visual Studio 开发人员 PowerShell
中输入
ServiceModelReg.exe /i /x
。
Windows 7:最后,必须确认已将 ASP.NET 配置为使用 .NET Framework 版本 4 或更高版本。 通过运行带
–i
选项的 ASPNET_Regiis 工具执行此操作。 有关详细信息,请参阅
ASP.NET IIS 注册工具
。
创建新的 IIS 应用程序或重新使用现有的 ASP.NET 应用程序
IIS 托管的 WCF 服务必须驻留在 IIS 应用程序内。 可以创建一个新的 IIS 应用程序来专门托管 WCF 服务。 或者,也可以将 WCF 服务部署到现有应用程序,该应用程序已经托管 ASP.NET 2.0 内容(例如 .aspx 页和 ASP.NET Web 服务 [ASMX])。 有关这些选项的详细信息,请参阅
WCF 服务和 ASP.NET
中的“与 ASP.NET 并行托管 WCF”和“在 ASP.NET 兼容模式下托管 WCF 服务”。
请注意,IIS 6.0 和更高版本定期重新启动独立的面向对象的编程应用程序。 默认值为 1740 分钟。 支持的最大值为 71,582 分钟。 可以禁用此重新启动。 有关此属性的详细信息,请参阅
PeriodicRestartTime
。
为 WCF 服务创建 .svc 文件
托管于 IIS 中的 WCF 服务在 IIS 应用程序内表示为特殊内容文件(.svc 文件)。 此模型与在 IIS 应用程序内将 ASMX 页表示为 .asmx 文件的方式类似。 .svc 文件包含 WCF 特定的处理指令 (
@ServiceHost
),该指令允许 WCF 托管基础结构激活所托管的服务以响应传入消息。 .svc 文件的最常见语法如以下语句所示。
<% @ServiceHost Service="MyNamespace.MyServiceImplementationTypeName" %>
它由
@ServiceHost
指令和单个属性
Service
组成。
Service
属性的值是服务实现的公共语言运行库 (CLR) 类型名称。 使用此指令与使用以下代码创建服务主机基本等效。
new ServiceHost( typeof( MyNamespace.MyServiceImplementationTypeName ) );
也可以执行其他承载配置,如创建服务的基址列表。 也可以使用自定义 ServiceHostFactory 扩展指令以用于自定义承载解决方案。 托管 WCF 服务的 IIS 应用程序不负责管理 ServiceHost 实例的创建和生存期。 收到 .svc 文件的第一个请求时,托管 WCF 托管基础结构动态创建必需的 ServiceHost 实例。 在代码显式关闭该实例之前或回收应用程序时,不释放该实例。
有关 .svc 文件语法的详细信息,请参阅 @ServiceHost。
将服务实现部署到 IIS 应用程序
托管于 IIS 中的 WCF 服务与 ASP.NET 2.0 使用相同的动态编译模型。 就像在 ASP.NET 中那样,可以在各种位置通过几种方式部署托管于 IIS 中的 WCF 服务的实现代码,如下所示:
作为全局程序集缓存 (GAC) 或应用程序的 \bin 目录中的预编译 .dll 文件。 在部署类库的新版本后,才更新预编译的二进制文件。
作为位于应用程序的 \App_Code 目录中的未编译源文件。 处理应用程序的第一个请求时,动态需要位于此目录中的源文件。 对 \App_Code 目录中文件进行的任何更改都导致在收到下一个请求时回收和重新编译整个应用程序。
作为直接放置在 .svc 文件中的未编译代码。 实现代码也可以按内联方式位于服务的 .svc 文件中,且在 @ServiceHost 指令之后。 对内联代码进行的任何更改导致在收到下一个请求时回收和重新编译应用程序。
有关 ASP.NET 2.0 编译模型的详细信息,请参阅 ASP.NET 编译概述。
托管于 IIS 中的 WCF 服务将其配置存储在应用程序 Web.config 文件中。 IIS 托管的服务使用与托管于 IIS 外部的 WCF 服务相同的配置元素和语法。 但是,下面的约束对 IIS 承载环境是唯一的:
承载于 IIS 中的服务的基址。
通过将一组基址 URI 传递到 ServiceHost 构造函数或者通过在服务配置中提供 <host> 元素,在 IIS 外部托管 WCF 服务的应用程序可以控制这些服务的基址。 承载于 IIS 中的服务无法控制其基址;承载于 IIS 中的服务的基址是其 .svc 文件的地址。
承载于 IIS 中的服务的终结点地址
承载于 IIS 中时,任何终结点地址始终被认为相对于表示服务的 .svc 文件的地址。 例如,如果 WCF 服务的基址是 http://localhost/Application1/MyService.svc
,并具有以下终结点配置:
<endpoint address="anotherEndpoint" />
这提供了一个可以在 http://localhost/Application1/MyService.svc/anotherEndpoint
处访问的终结点。
同样,将空字符串用作相对地址的终结点配置元素提供了一个可以在 http://localhost/Application1/MyService.svc
(它是基址)处访问的终结点。
<endpoint address="" />
对于承载于 IIS 中的服务的终结点,必须始终使用相对终结点地址。 如果终结点地址未指向承载公开终结点的服务的 IIS 应用程序,则提供完全限定的终结点地址(例如,http://localhost/MyService.svc
)可能导致在部署服务时出错。 对所承载的服务使用相对终结点地址避免了这些潜在冲突。
托管于 IIS 5.1 和 IIS 6.0 中的 WCF 服务被限制为使用基于 HTTP 的通信。 在这些 IIS 平台上,将所承载的服务配置为使用非 HTTP 绑定会导致服务激活期间出错。 对于 IIS 7.0,支持的传输包括 HTTP、Net.TCP、Net.Pipe、Net.MSMQ 以及用于与现有 MSMQ 应用程序向后兼容的 msmq.formatname。
HTTP 传输安全
托管于 IIS 中的 WCF 服务可以使用 HTTP 传输安全(例如 HTTPS 和 HTTP 身份验证方案,如基本、摘要式和 Windows 集成身份验证),前提是包含该服务的 IIS 虚拟目录支持这些设置。 所承载终结点的绑定上的 HTTP 传输安全设置必须与包含它的 IIS 虚拟目录上的传输安全设置匹配。
例如,配置为使用 HTTP 摘要式身份验证的 WCF 终结点必须驻留在也配置为允许 HTTP 摘要式身份验证的 IIS 虚拟目录中。 IIS 设置和 WCF 终结点设置的不匹配组合会导致服务激活期间出错。
在 Internet 信息服务中承载
Internet 信息服务承载最佳实践
Windows Server App Fabric 承载功能