通过

“添加 Web 引用”对话框

  • 项目

更新：2007 年 11 月

使用“添加 Web 引用”对话框可以浏览 Web 服务并向网站中添加 Web 引用。Web 引用使您可以在代码中使用 Web 服务提供的对象和方法。您可以在本地计算机或公司局域网的服务器上搜索 Web 服务，也可以在 Internet 上搜索商业 Web 服务。

打开“添加 Web 引用”对话框

  • 在解决方案资源管理器中，右击网站的名称，然后单击“添加 Web 引用”。

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

将 Web 引用添加到当前项目后，可以在应用程序中使用该 Web 服务提供的任何元素或功能。有关更多信息，请参见 XML Web services 概述。

安全说明：

在打开包括 Web 引用的项目进行编辑时，用于 Web 服务的本地代理文件在由可信用户（您本人）启动的 Devenv.exe 进程的实例中运行。在集成开发环境 (IDE) 中打开项目或组件时，可能会允许在本地计算机上执行代码。有关更多信息，请参见代码访问安全性。

用户界面元素

  • 后退
    “添加 Web 引用”中的“后退”按钮

    返回到显示的上一页。

  • 前进
    “添加 Web 引用”中的“前进”符号

    返回到在先前单击“后退”按钮时看到的那一页。

  • 停止
    WebApplicationStopURLsymbol 屏幕快照

    停止加载网页。

  • 刷新
    AddWebReferenceRefreshButton 屏幕快照

    刷新左浏览器窗格中活动页的内容。

  • 主页
    “添加 Web 资源”对话框中的“主页”符号

    在左浏览器窗格中显示“开始浏览 Web 服务”页。

  • 前往
    “添加 Web 引用”中的“开始”

    激活在 URL 字段中输入的地址上搜索 Web 服务。

  • URL
    显示希望应用程序使用的 Web 服务的 URL。使用下拉列表选择一个以前用过的服务，或输入一个以 http:// 或 ftp:// 开头的新路径。一个完整的 Web 引用 URL 包括域名、Web 服务名及其 .asmx、.wsdl、.disco 或 .xsd 发现文件的名称。例如，您可以输入以下样式：

    http://DomainName/WebServiceName/DiscoveryFile.asmx

    “开始浏览 Web 服务”窗格在此路径中搜索 Web 服务，并给找到的任何服务显示说明。

    说明：

    .NET Framework 不自动检测代理服务器。如果在位于防火墙后面的计算机上开发 Web 应用程序，而且应用程序将使用位于防火墙外部的 Web 服务，那么必须在 URL 中包括网络代理服务器的地址和端口。请向您的网络管理员咨询，了解如何提供此部分的 URL 路径。此外，您还可以设置 Machine.config 或 Web.config 文件的 <defaultProxy> 元素（网络设置）元素。任何不包含设置为特定值的 Proxy 属性的 HttpWebRequest 都使用默认代理。有关更多信息，请参见配置 Internet 应用程序。

  • 开始浏览 Web 服务
    提供链接指向可用 Web 服务的列表。单击其中一个链接后，可以选择列出的任何可用 Web 服务的名称，以便从该服务的 Web 服务描述语言 (WSDL) 文件中检索其支持方法的描述。有关更多信息，请参见找到 Web 服务 和 ASP.NET Web 服务的 WSDL 文件生成。

    此窗格中包括以下链接：

    • 此解决方案中的 Web 服务   列出当前解决方案中可用的 Web 服务。

    • 本地计算机上的 Web 服务   列出本地计算机上的可用 Web 服务和发现文档。

      为使此链接返回信息，Web 服务器（如 Internet 信息服务 (IIS)）必须在本地计算机上运行。有关 IIS 的更多信息，请参见 IIS 技术库。

    • 在本地网络上浏览 UDDI 服务器   列出局域网中可用的服务器，它们使用“通用描述、发现和集成”(UDDI) 协议提供 Web 服务和发现文档。

      标准 UDDI 协议支持以编程方式快速发现公司的可用 Web 服务。有关更多信息，请参见 Microsoft UDDI 网站。

  • 位于此 URL 上的 Web 服务
    列出在指定 URL 上找到的 Web 服务的名称。创建 Web 引用时，它将引用整个列表。若要分离出单个的 Web 服务，请将鼠标指针停留在此列表中的所需项上。工具提示将显示所需服务的 URL。输入该服务的 URL 并按“前往”按钮。该列表随后将只显示所需的 Web 服务。然后您可以添加只引用该服务的引用。

  • Web 引用名
    指定一个唯一的名称，该名称将用于在代码中以编程方式访问所选的 Web 服务。如果输入的名称与某个现有的 Web 服务的引用名相同，则会自动追加一个编号以使新引用唯一。

    默认情况下，将为 Web 引用分配一个与其服务器名称对应的命名空间。Visual Web Developer 根据您在 App_WebReferences 文件夹中输入的“Web 引用名”创建 Web 引用。在 App_WebReferences 文件夹中创建了一个引用 Web 服务的 .wsdl 文件以及包含有关 Web 服务所在位置的信息的支持文件，例如发现（.disco 和 .discomap）文件。

    Web 引用名不能：

    • 包含以下字符中的任意一个：/ ?: \ * " < > 或 |

    • 包含 Unicode 控制字符。

    • 保留的名称。其中包括“CON”、“AUX”、“PRN”、“COM1”和“LPT2”。

  • 添加引用
    在应用程序中创建新的 Web 引用。当“位于此 URL 上的 Web 服务”字段中列出了一个或多个在“URL”字段输入的地址上可用的 Web 服务时，此按钮被启用。具有“Web 引用名”字段中给定名称的新 Web 引用将出现在解决方案资源管理器中当前项目的“Web 引用”节点下。此新 Web 引用将使列出的所有 Web 服务对应用程序都可用。

    说明：

    若要使用 .wsdl 说明文件的最新副本重新生成 Web 服务的代理类，请右击解决方案资源管理器中的 Web 引用，然后单击“更新 Web 引用”。
Topic Location
如何：定位 Web 服务的 WSDL 文件 Visual Studio Enterprise - Application Designer
如何：定位 Web 服务的 WSDL 文件 Visual Studio 企业版 - 应用程序设计器

请参见

任务

如何：添加和移除 Web 引用

概念

在 Internet 信息服务 (IIS) 中承载远程对象

远程处理示例：在 Internet 信息服务 (IIS) 中承载

配置 Internet 应用程序

参考

此计算机上的代理设置没有正确地针对 Web 发现进行配置。

其他资源

在托管代码中访问 Web 服务

用户界面元素 -> 项目

Internet 信息服务 SDK

Internet 信息服务 5.0 文档

万维网联合会

WSDL 规范

UDDI.org

Microsoft UDDI 网站