使用 Visual Studio IDE 或使用可生成 Windows Communication Foundation (WCF) 示例msbuild命令从命令行。 本主题介绍这两个过程。
Note: 之前生成或运行任何 WCF 示例,请确保您已执行了的 Windows Communication Foundation 示例的一次性安装过程。
使用命令提示生成示例
-
打开 Visual Studio 开发人员命令提示符并导航到安装示例的目录位置下语言特定的子目录。
-
类型
msbuild在命令行。 生成客户端程序文件client\bin和服务程序文件构建到service\bin。 如果该服务由 Internet 信息服务 (IIS) 承载,服务程序文件也会复制到 servicemodelsamples 目录并将其 \bin 子目录。
Note: 必须设置 Acl %systemdrive%\inetpub\wwwroot授予修改权限的帐户在其下运行。 否则,某些后期生成事件将失败。 或者,您可以将 ACL 保留原样,而以管理员身份运行 SDK 命令提示。
使用 Visual Studio 生成示例
-
从文件在 Visual Studio 中,选择菜单打开 > 项目/解决方案。 导航到在其中安装示例的目录下语言特定的子目录,并双击.sln 文件图标,以在 Visual Studio 中打开的解决方案。
-
从构建菜单中,选择重新生成解决方案。
客户端程序文件在 client\bin 中生成,服务程序文件在 service\bin 中生成。 如果该服务在 IIS 中承载,服务程序文件也复制到 servicemodelsamples 目录并将其 \bin 子目录。
Note: 您必须在 %systemdrive%\inetpub\wwwroot 上设置 ACL,以便为您运行的帐户授予修改权限。 否则,某些后期生成事件将失败。 或者,您可以将 ACL 保留原样,而以管理员身份运行 SDK 命令提示或 Visual Studio。 某些 Visual Studio 操作(例如,为 ASP.Net 工作进程附加调试器)也需要管理特权。
设置批处理文件和脚本
Setup.exe 和 Cleanup.exe 批处理文件和脚本应运行从开发人员命令提示符处针对 Visual Studio。 有几个设置和清理文件将执行需要具有管理特权的任务,应使用管理特权来启动它们。
有关元数据终结点的重要安全信息
若要防止无意中泄漏可能敏感的服务元数据,Windows Communication Foundation (WCF) 服务的默认配置,请禁用元数据发布。 默认情况下此行为是安全的,但也意味着你无法使用元数据导入工具(例如 Svcutil.exe)生成调用服务所需的客户端代码,除非在配置中显式启用服务的元数据发布行为。 为了使示例体验更简单,几乎所有示例都公开一个不安全的元数据发布终结点。 此类终结点或许可以供未通过身份验证的匿名使用者使用,因此在部署此类终结点之前,必须谨慎以确保适合公开透露服务元数据。 有关发布服务元数据的详细信息,请参阅元数据发布行为示例。 请参阅自定义安全元数据终结点示例有关保护元数据终结点的示例。
异常处理
一般来说,这些示例不包括异常处理,以使代码集中处理示例的主题。 有关异常处理的详细信息,请参阅预期异常示例。
使用 Svcutil 重新生成客户端和配置
可以使用ServiceModel Metadata Utility Tool (Svcutil.exe)重新生成客户端代码和配置的大多数示例。 某些示例需要手动编辑的配置。 例如,如果您使用 Svcutil.exe 为某个使用客户端证书凭据的示例重新生成配置,必须手动指定之前配置的凭据。 某些示例使用特定的 Svcutil.exe 选项来影响生成的代码,这些选项在具体的示例主题中进行指定。
重新生成客户端和配置文件
-
打开 SDK 命令提示,然后定位到安装示例的目录位置下的语言特定的子目录。
-
如果服务是 Web 承载的类型,请使用以下命令。
svcutil.exe /n:"http://Microsoft.ServiceModel.Samples,Microsoft.ServiceModel.Samples" http://localhost/servicemodelsamples/service.svc/mex /out:generatedClient.cs如果服务是自承载类型,请键入以下命令。
svcutil.exe /n:"http://Microsoft.ServiceModel.Samples,Microsoft.ServiceModel.Samples" http://localhost:8000/servicemodelsamples/service.svc/mex /out:generatedClient.cs替换为
http://localhost:8000/ServiceModelSamples/service.svc/mex与自承载的服务的 mex 终结点的地址。若要在 Visual Basic 类型中生成客户端,请使用以下命令。
svcutil.exe /n:"http://Microsoft.ServiceModel.Samples,Microsoft.ServiceModel.Samples" http://localhost/servicemodelsamples/service.svc/mex /l:vb /out:generatedClient.vb如果服务是自承载类型,请使用以下命令。
svcutil.exe /n:"http://Microsoft.ServiceModel.Samples,Microsoft.ServiceModel.Samples" http://localhost:8000/servicemodelsamples/service.svc/mex /l:vb /out:generatedClient.vbNOTE 若要跳过客户端配置的生成将添加 /noConfig选项。
请参阅
历史资料。此文对应 2019-08-18 的中文文档快照,适用产品版本和命令行为以原文为准。
来源与署名:Microsoft 和文档贡献者。固定版本原文。文档采用 CC BY 4.0,示例代码采用 MIT 授权。本站将 Markdown 转为 HTML,规范化链接,移除外部媒体、发布器占位标签和导航标记。
