托管在 Internet 信息服务 (IIS) 和从公共虚拟目录中运行的大多数 Windows Communication Foundation (WCF) 示例。 此一次性安装过程的磁盘; 上创建一个文件夹它还添加到名为的 IIS 虚拟目录ServiceModelSamples。
ServiceModelSamples虚拟目录用于生成和运行使用 IIS 承载的服务的所有示例。 这是运行示例所需的唯一虚拟目录。 绑定示例将替换以前在此虚拟目录部署的所有服务;只有最近生成的示例将在此虚拟目录中部署并可用。
Note: 必须在本地管理员帐户下运行所有命令。 如果使用的是 Windows 7、Windows Vista 或 Windows Server 2008 R2,则还必须用提升的特权运行命令提示。 为此,请右键单击命令提示符图标,然后依次以管理员身份运行。 本主题中的所有命令都必须在具有合适路径设置的命令提示中运行。 确保这一点的最简单方法是使用 Visual Studio 命令提示。 若要打开此提示,请单击启动,选择所有程序,向下滚动到Visual Studio 2010,选择Visual Studio Tools,右键单击Visual Studio 命令提示符 (2010),然后单击以管理员身份运行。 如果安装了 Visual Studio 学习版,但此命令提示不可用,则必须向系统路径添加“C:\Windows\Microsoft.Net\Framework\v4.0”。
WCF 示例的一次性安装过程
-
请确保设置 ASP.NET。 有关如何设置 ASP.NET 的详细信息,请参阅Internet 信息服务承载说明。
-
确保已安装 .NET Framework 版本 4。 搜索以下目录的 v4.0 (或更高版本): \Windows\Microsoft.NET\Framework
-
如果没有安装 Visual Studio 2012,并且你的操作系统不是 Windows Server 2008 SP2 或更高版本,安装修补程序 251798。
-
运行以下命令。 为什么必须运行这些命令的详细信息,请参阅IIS 宿主服务失败。
WARNING 如果重新安装 IIS,则需要再次运行以下命令。
"%WINDIR%\Microsoft.Net\Framework\v4.0.30319\aspnet_regiis" –i –enable "%WINDIR%\Microsoft.Net\Framework\v4.0.30319\ServiceModelReg.exe" -rWARNING 运行命令
aspnet_regiis –i –enable将使默认应用程序池运行使用.NET Framework 4,这可能会产生的同一台计算机上其他应用程序不兼容性问题。 -
请按照防火墙说明启用示例所使用的端口。
-
检查以下默认目录:<安装驱动器 >:\WF_WCF_Samples。 如果之前已安装这些示例,则该目录为默认目录。
-
如果未安装这些示例,它们从安装的示例下载位置Visual C#或Visual Basic。
-
后安装这些示例,请转到:<InstallDrive>:\WF_WCF_Samples\WCF\Setup\
-
运行Setupvroot.bat批处理文件。 将执行以下步骤:
-
将在 IIS 中创建一个名为 ServiceModelSamples 的虚拟目录。
-
新建名为 %SystemDrive%\Inetpub\wwwroot\ServiceModelSamples 和 %SystemDrive%\Inetpub\wwwroot\ServiceModelSamples\bin 的磁盘目录。
如果想要手动设置这些目录,请参阅虚拟目录设置说明。 若要恢复此步骤中所进行的所有更改,请在使用完示例后运行一次 cleanupvroot.bat。
NOTE 除非运行 cleanupvroot.bat,否则此过程只能在计算机上执行一次。
-
-
您必须向在其下生成示例的帐户和 Network Service 用户授予对 %SystemDrive%\inetpub\wwwroot 的修改权限。 在生成过程中,某些 Web 承载的示例可能会尝试将已编译的二进制文件复制到上述位置,如果你没有设置相应权限,则生成过程将中断。 或者,可以保持权限不变,并以管理员身份运行 SDK 命令提示或 Visual Studio 命令提示 (2012) 或生成在 Visual Studio 2012 中,还以管理员身份运行示例。
NOTE 如果未完成此步骤,IIS 承载的所有示例都将在生成时失败。 确保正确设置权限,或者同时以管理员身份运行 SDK 命令提示和 Visual Studio 命令提示 (2012)。
-
在计算机上创建一个 C:\logs 目录;某些示例可能需要此目录。 确保向合适的帐户授予了对此文件夹的写访问权限。 适用于 Windows 7 Windows Vista,并且 Windows Server 2008 R2,此帐户是网络服务。 对于 Windows Server 2008,该帐户为 NT Authority\Network Service。 对于 Windows XP 和 Windows Server 2003,该帐户为 ASPNET。
-
运行 Setupcerttool.bat 文件。 此文件位于<InstallPath > \WF_WCF_Samples\WCF\Setup\ 文件夹。 此脚本将执行以下任务:
-
生成 FindPrivateKey 工具。
-
创建一个名为 %ProgramFiles%\ServiceModelSampleTools 的目录。
-
将新的 FindPrivateKey 工具复制到此目录。
使用证书且承载于 IIS 中的示例需要使用此工具。
NOTE 出于安全方面的考虑,请记住在完成这些示例后,通过运行名为 Cleanupvroot.bat 的批处理文件来移除虚拟目录定义和在上面的设置步骤中授予的权限。
-
-
自承载(不承载于 IIS 中)的示例需要在计算机上注册要侦听的 HTTP 地址的权限。 用于 HTTP 命名空间预留的权限由用于运行该示例的用户帐户提供。 默认情况下,管理员帐户具有注册任何 HTTP 地址的权限。 必须向非管理员帐户授予针对示例所使用的 HTTP 命名空间的权限。 有关如何配置命名空间预留的详细信息,请参阅配置 HTTP 和 HTTPS。
-
有些示例需要使用消息队列。 请参阅安装消息队列 (MSMQ)有关安装说明。
NOTE 确保在运行需要消息队列的任何示例之前启动 MSMQ 服务。
-
有些示例需要使用证书。 请参阅Internet 信息服务 (IIS) 服务器证书安装说明。
历史资料。此文对应 2019-08-18 的中文文档快照,适用产品版本和命令行为以原文为准。
来源与署名:Microsoft 和文档贡献者。固定版本原文。文档采用 CC BY 4.0,示例代码采用 MIT 授权。本站展开固定版本仓库内的引用内容,将 Markdown 转为 HTML,规范化链接,移除外部媒体、发布器占位标签和导航标记。
