添加、更新或删除 WCF 数据服务引用

对于 .NET Framework 项目,服务引用使项目能够访问一个或多个 WCF Data Services。 使用“添加服务引用”对话框通过本地、局域网或 Internet 在当前解决方案中搜索 WCF Data Services。

对于 .NET Core 项目,可使用解决方案资源管理器中的连接服务节点访问 Microsoft WCF Web Service Reference 提供程序,该程序可管理 Windows Communication Foundation (WCF) 数据服务引用 。

注意

本文中的某些 Visual Studio 用户界面元素在计算机上出现的名称或位置可能会不同。 你可能正在使用其他版本的 Visual Studio 或其他环境设置。 有关详细信息,请参阅个性化设置 IDE

先决条件

如果 WCF 工具未随 .NET 工作负载一起安装,请使用 Visual Studio 安装程序修改安装。 在安装程序中,选择“单个组件”下的 Windows Communication Foundation。 请参阅修改 Visual Studio

添加 WCF 服务引用

若要添加对外部服务的引用(.NET Framework 项目)

  1. 解决方案资源管理器中,右键单击要向其添加服务的项目的名称,然后选择添加服务引用

    此时将出现“添加服务引用”对话框

  2. 地址框中,输入服务的 URL,然后选择转到以搜索服务。 如果服务实施用户名和密码安全性,将提示你输入用户名和密码。 还可以在自己的解决方案中选择服务。 选择“发现”按钮,然后选择“解决方案中的服务”。

    注意

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

    还可以从“地址”列表中选择 URL,该列表存储先前 15 个指向有效服务元数据的 URL。

    执行搜索时会显示进度条。 可以随时单击“停止”来停止搜索。

  3. 在“服务”列表中,展开你要使用的服务的节点,然后选择实体集。

  4. 在“命名空间”框中,输入要用于参考的命名空间

  5. 单击“确定”将参考添加到项目中

    然后会生成服务客户端(代理),描述服务的元数据也会添加到 app.config 文件中。

若要添加对外部服务的引用(.NET Core 项目,包括 .NET 5 及更高版本)

  1. 在解决方案资源管理器中,双击或点击连接服务节点 。

    此时会打开“配置服务”选项卡。

  2. 选择“Microsoft WCF Web 服务引用提供程序”。

    此时会显示“配置 WCF Web 服务引用”对话框。

    WCF Web 服务提供程序对话框的屏幕截图

  3. URI 框中,输入服务的 URL,然后选择转到以搜索服务。 如果服务实施用户名和密码安全性,将提示你输入用户名和密码。

    注意

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

    还可以从“URL”列表中选择 URL,该列表存储先前 15 个指向有效服务元数据的 URL。

    执行搜索时会显示进度条。 可以随时单击“停止”来停止搜索。

  4. 在“服务”列表中,展开你要使用的服务的节点,然后选择实体集。

  5. 在“命名空间”框中,输入要用于参考的命名空间

  6. 单击“完成”将参考添加到项目中。

    然后会生成服务客户端(代理),描述服务的元数据也会添加到 app.config 文件中。

若要在当前解决方案中添加对服务的引用(.NET Framework 项目)

  1. 解决方案资源管理器中,右键单击要向其添加服务的项目的名称,然后选择添加服务引用

    此时将出现“添加服务引用”对话框

  2. 单击“发现”。

    当前解决方案中的所有服务(WCF Data Services 和 WCF 服务)都添加到“服务”列表中。

  3. 在“服务”列表中,展开你要使用的服务的节点,然后选择实体集。

  4. 在“命名空间”框中,输入要用于参考的命名空间

  5. 单击“确定”将参考添加到项目中

    然后会生成服务客户端(代理),描述服务的元数据也会添加到 app.config 文件中。

若要在当前解决方案中添加对服务的引用(.NET Core 项目)

  1. 在解决方案资源管理器中,双击或点击连接服务节点 。

    此时会打开“配置服务”选项卡。

  2. 选择“Microsoft WCF Web 服务引用提供程序”。

    此时会显示“配置 WCF Web 服务引用”对话框。

  3. 单击“发现”。

    当前解决方案中的所有服务(WCF Data Services 和 WCF 服务)都添加到“服务”列表中。

  4. 在“服务”列表中,展开你要使用的服务的节点,然后选择实体集。

  5. 在“命名空间”框中,输入要用于参考的命名空间

  6. 单击“完成”将参考添加到项目中。

    然后会生成服务客户端(代理),描述服务的元数据也会添加到 app.config 文件中。

更新服务引用

WCF Data Services 的实体数据模型有时会发生变化。 发生这种情况时,必须更新服务引用。

更新服务引用

  • 解决方案资源管理器中,右键单击服务引用,然后选择更新服务引用

    从引用的初始位置对其进行更新时会显示一个进度对话框,并且会重新生成服务客户端以显示元数据中的所有更改。

对于 .NET Core 项目,请使用 dotnet-svcutil 工具。 有关安装和说明,请参阅 dotnet-svcutil

对于 .NET Framework 项目:

  • 解决方案资源管理器中,展开连接的服务节点,右键单击服务引用,然后选择更新服务引用

    从引用的初始位置对其进行更新时会显示一个进度对话框,并且会重新生成服务客户端以显示元数据中的所有更改。

删除服务引用

如果不再使用服务引用,可以将其从解决方案中删除。

删除服务引用

  • 解决方案资源管理器中,右键单击服务引用,然后选择删除

    服务客户端将从解决方案中删除,描述服务的元数据将从 app.config 文件中删除。

    注意

    必须手动删除所有引用服务引用的代码。