共用方式為

加入 Web 參考對話方塊

  • 發行項

更新：2007 年 11 月

[加入 Web 參考] 對話方塊可讓您瀏覽 Web 服務，並在網站中加入 Web 參考。Web 參考可讓您在程式碼中使用 Web 服務所提供的物件和方法。您可以在本機電腦或公司區域網路內的伺服器上搜尋 Web 服務，也可以在網際網路上搜尋商業 Web 服務。

若要開啟加入 Web 參考對話方塊

  • 在 [方案總管] 中，以滑鼠右鍵按一下網站的名稱，然後按一下 [加入 Web 參考]。

    [加入 Web 參考] 對話方塊隨即出現。

將 Web 參考加入至目前的專案之後，即可使用應用程式中該 Web 服務所提供的任何項目和功能。若需更多資訊，請參閱 XML Web Service 概觀。

安全性注意事項：

當您開啟來編輯的專案中包含 Web 參考時，Web 服務的本機 Proxy 檔便會在由受信任使用者 (也就是您自己) 所啟動的 Devenv.exe 執行個體中執行。在整合式開發環境 (IDE) 中開啟專案或元件，程式碼可能可在本機電腦上執行。如需詳細資訊，請參閱程式碼存取安全性。

UI 項目

  • 上一頁
    加入 Web 參考的上一步按鈕

    回到上一個顯示頁。

  • 下一頁
    加入 Web 參考向前符號

    回到您先前按 [上一步] 按鈕時可見的那一頁。

  • 停止
    WebApplicationStopURLsymbol 螢幕擷取畫面

    停止載入網頁。

  • 重新整理
    AddWebReferenceRefreshButton 螢幕擷取畫面

    在左邊的瀏覽器窗格內重新整理使用中網頁的內容。

  • 首頁
    加入 Web 資源對話方塊首頁符號

    會在左方瀏覽器窗格內，顯示 [開始瀏覽 Web 服務] 頁面。

  • 移至
    加入 Web 參考移至

    會從 [URL] 欄位所輸入的位址啟動搜尋 Web 服務。

  • URL
    會顯示您希望應用程式使用之 Web 服務的 URL。使用下拉式清單選取先前使用的服務，或輸入新的路徑，而開頭必須為 http:// 或 ftp://。完整的 Web 參考 URL 包含網域名稱、Web 服務名稱和其 .asmx、.wsdl、.disco 或 .xsd 探索檔 (Discovery File) 的名稱。例如，您可能會輸入：

    http://DomainName/WebServiceName/DiscoveryFile.asmx

    [開始瀏覽 Web 服務] 窗格會在這個路徑中尋找 Web 服務，並顯示所有找到之服務的說明。

    注意事項：

    .NET Framework 不會自動偵測 Proxy 伺服器。如果您用來開發 Web 應用程式的電腦位於防火牆後面，而應用程式會用到防火牆外部的 Web 服務，則 URL 中必須包含網路上 Proxy 伺服器的位址和連接埠。請洽詢您的網路系統管理員，提供這個部分的 URL 路徑。此外，您可以設定 Machine.config 或 Web.config 檔案的 <defaultProxy> 項目 (網路設定) 項目。未將 Proxy 屬性設定為特定值的 HttpWebRequest 將使用預設的 Proxy。如需詳細資訊，請參閱設定網際網路應用程式。

  • 開始瀏覽 Web 服務
    會提供可用之 Web 服務清單的連結。按一下其中一個連結之後，您便可以從所列的可用 Web 服務中選取一個名稱，以便從該服務的 Web 服務描述語言 (WSDL) 檔案中，擷取其支援方法的說明。如需詳細資訊，請參閱找出 Web 服務 和 ASP.NET Web 服務的 WSDL 檔案產生。

    這個窗格包含了下列連結：

    • 這個方案中的 Web 服務：列出目前方案中可用的 Web 服務。

    • 本機電腦上的 Web 服務；會列出本機電腦上可用的 Web 服務和探索文件。

      若要讓這個連結傳回資訊，您必須在本機電腦上執行 Web 伺服器 (例如網際網路資訊服務，IIS)。如需 IIS 的詳細資訊，請參閱 IIS Technical Library。

    • 瀏覽區域網路上的 UDDI 伺服器：列出您區域網路內可用的伺服器，該伺服器會使用通用描述、探索與整合 (Universal Description, Discovery, and Integration，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 參考名稱不能：

    • 包含下列任何字元：/ ?: \ * " < > or |

    • 包含 Unicode 控制字元。

    • 是保留的名稱。如 "CON"、"AUX"、"PRN"、"COM1" 及 "LPT2"。

  • 加入參考
    會在應用程式中建立新的 Web 參考。當 [URL] 欄位中輸入的網址有一或數個 Web 服務列於 [這個 URL 中的 Web 服務] 欄位中時，此按鈕便會啟用。[Web 參考名稱] 欄位中所指定名稱的新 Web 參考，將出現於 [方案總管] 中目前專案的 [Web 參考] 節點之下。這個新的 Web 參考將使您的應用程式得以使用所有列出的 Web 服務。

    注意事項：

    若要使用最新版的 .wsdl 描述檔為 Web 服務重新產生 Proxy 類別，請以滑鼠右鍵按一下 [方案總管] 的 [Web 參考]，再按一下 [更新 Web 參考]。

請參閱

工作

HOW TO：加入和移除 Web 參考

概念

在網際網路資訊服務 (IIS) 中裝載遠端物件

遠端處理範例：在網際網路資訊服務 (IIS) 中裝載

設定網際網路應用程式

參考

尚未正確設定這部電腦的 Proxy 設定以進行 Web 探索。

其他資源

以 Managed 程式碼存取 Web 服務

專案、使用者介面項目

網際網路資訊服務 SDK

網際網路資訊服務 (IIS) 5.0 文件

全球資訊網協會

WSDL 規格

UDDI.org

Microsoft UDDI 網站