使用 WCF Web Service Reference Provider 工具Use the WCF Web Service Reference Provider Tool

本文内容

多年来，许多 Visual Studio 开发者在其. NET Framework 项目需要访问 Web 服务时，都享受到了添加服务引用工具所带来的工作效率 。WCF Web 服务引用工具是 Visual Studio 连接服务的扩展，提供了类似于 .NET Core 和 ASP.NET Core 项目的“添加服务引用”功能的体验 。此工具可从网络位置的当前解决方案的 web 服务中或从 WSDL 文件中检索元数据，并生成包含可用于访问 web 服务的 Windows Communication Foundation (WCF) 客户端代理代码的可兼容 .NET Core 的源文件。

重要

应仅从受信任源引用服务。从不受信任的源添加引用可能会危及安全性。

系统必备Prerequisites

如何使用扩展How to use the extension

备注

“WCF Web 服务引用”选项适用于使用以下项目模板创建的项目 ：

  • Visual C# > .NET Core
  • Visual C# > .NET Standard
  • Visual C# > Web > ASP.NET Core Web 应用程序

以“ASP.NET Core Web 应用程序”项目模板为例，本文将介绍如何向该项目中添加 WCF 服务引用 ：

  • 在解决方案资源管理器中，双击项目的“连接的服务”节点（对于 .NET Core 或 .NET Standard 项目，当在解决方案资源管理器中右键单击项目的“依赖项”节点时，该选项可用） 。

随即显示“连接的服务”页，如下图所示 ：

.NET Core 的“Visual Studio 连接的服务”选项卡

  • 在“连接的服务”页上，单击“Microsoft WCF Web Service Reference Provider” 。此操作将显示“配置 WCF Web 服务引用”向导 ：

.NET Core 的“Visual Studio 服务终结点”选项卡

  • 选择服务。

3a.“配置 WCF Web 服务引用”向导中提供了多个服务搜索选项 ：

  • 要搜索当前解决方案中定义的服务，请单击“发现”按钮 。
  • 要搜索在指定地址托管的服务，请在“地址”框中输入服务 URL，然后单击“转到”按钮 。
  • 要选择包含 Web 服务元数据信息的 WSDL 文件，请单击“浏览”按钮 。3b.从“服务”框内的搜索结果列表中选择服务 。如果需要，请在相应的“名称空间”文本框中为生成的代码输入命名空间 。

3c.单击“下一步”按钮，打开“数据类型选项”页和“客户端选项”页 。或者，单击“完成”按钮，使用默认选项 。

  • “数据类型选项”窗体可用于优化生成的服务引用配置设置 ：

.NET Core 的“Visual Studio 数据类型选项”选项卡

备注

如果在项目的引用程序集中定义了服务引用代码生成所需的数据类型，则“重新使用引用程序集中的类型”复选框选项将非常有用 。重新使用这些现有数据类型，从而避免编译时类型冲突或运行时问题，这是非常重要的。

加载类型信息时可能会有延迟，具体取决于项目依赖项和其他系统性能因素的数量。加载过程中，“完成”按钮被禁用，除非未选中“重新使用引用程序集中的类型”复选框 。

  • 完成后，单击“完成” 。

在显示进度的同时，工具：

  • 从 WCF 服务下载元数据。
  • 在名为“reference.cs”的文件中生成服务引用代码，并将其添加到“连接的服务”节点下的项目 。
  • 使用在目标平台上编译和运行所需的 NuGet 包引用更新项目文件 (.csproj)。Visual Studio 进度窗口

进度完成后，可创建生成的 WCF 客户端类型的实例并调用服务操作。

后续步骤Next steps

反馈和问题Feedback & questions

如果有任何问题或反馈，请在 GitHub 上提问。也可以在 GitHub 上的 WCF 存储库中查看任何现有问题。

发行说明Release notes

  • 请参阅发行说明，了解更新的版本信息（包括已知问题）。