添加对 Web 服务的引用

时间:2024-04-16 20:18:51
如何:添加对 Web 服务的引用

 

XML Web Services 也称为 ASMX 服务,是 Windows Communication Foundation (WCF) 的早期版本。 与任何其他 WCF 服务一样,您可以通过添加服务引用来访问 Web 服务。以此方式添加的任何引用都将针对最新版的 .NET Framework。

对于在 Visual Studio 的早期版本中创建的应用程序,仍可以添加针对 .NET Framework 2.0 版的 Web 引用。 若要执行此操作,请按照下一节中介绍的过程进行操作。

说明

仅在应用程序针对的是 .NET Framework 2.0 版时才应添加 Web 引用。 若要添加针对 .NET Framework 当前版本的服务引用,请参见如何:添加、更新或移除服务引用

将 Web 引用添加到项目

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

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

  2. “添加服务引用”对话框中,单击“高级”按钮。

    将出现“服务引用设置”对话框。

  3. “服务引用设置”对话框中,单击“添加 Web 引用”

    将出现“添加 Web 引用”对话框。

  4. “URL”框中输入要使用的 Web 服务的 URL。 如果不知道 URL,则请使用浏览窗格中的链接查找所需的 Web 服务。

    说明

    如果在位于防火墙后面的计算机上开发 Web 应用程序,而且应用程序将使用位于防火墙外部的 Web 服务,那么必须在 URL 中包括网络代理服务器的地址和端口。 请向您的网络管理员咨询,了解如何提供此部分的 URL 路径。 有关更多信息,请参见此计算机上的代理设置没有正确地针对 Web 发现进行配置。

  5. “位于此 URL 上的 Web 服务”框中选择要使用的 Web 服务。

  6. 验证项目是否能够使用 Web 服务以及提供的所有外部代码是否可信。

    安全说明

    在打开包含 Web 引用的项目进行编辑时,所使用的 Web 服务的本地代理文件在由可信用户(您本人)启动的 Devenv.exe 进程中运行。 在集成开发环境 (IDE) 中打开项目或组件时,就会在本地计算机上执行代码。 有关更多信息,请参见Code Access Security

  7. “Web 引用名”字段中输入一个名称,您将在代码中使用该名称以编程方式访问所选择的 Web 服务。

    说明

    默认情况下,将为 Web 引用分配一个与其服务器名称对应的命名空间。 可以更改此值,并输入自定义的命名空间名称。 对可接受的命名空间名称存在某些限制。 有关 Web 引用名中不允许使用的字符的更多信息,请参见“添加 Web 引用”对话框 基于 Web 引用名的命名空间是通过生成嵌套的文件夹层次结构创建的。 在最内层文件夹中,将创建一个引用 Web 服务的 .wsdl 文件,同时还将创建一些支持文件,如发现(.disco 和 .discomap)文件,这些文件包含有关 Web 服务所在位置的信息。

  8. 单击“添加引用”

    如果项目站点还没有一个“WebReferences”文件夹,则 Visual Studio 将创建此文件夹。 然后它用您在第 7 步中提供的名称创建代理类所需的文件。