Visual Studio 中的 Web 參考

更新:2007 年 11 月

為了簡化 XML Web Service 用戶端應用程式的開發,Visual Studio 提供了 Web 參考。Web 參考和傳統參考與元件不同;Web 參考不會參考本機電腦上所安裝的元件或類別庫 (Class Library),而是使用 SOAP 或 HTTP 這類網際網路通訊協定存取可用的資源。

實際上,Web 參考是已產生的 Proxy 類別,它在本機電腦上代表 XML Web Service 的公開功能。Proxy 類別定義一些方法來代表 XML Web Service 公開的實際方法。當應用程式建立 Proxy 類別的執行個體時,就能夠呼叫 XML Web Service 方法,如同 XML Web Service 為本機中可用的元件一般。如需建立 Web 參考的指令,請參閱 HOW TO:加入和移除 Web 參考

tydxdyw9.alert_note(zh-tw,VS.100).gif注意事項:

若要讓防火牆外部的 XML Web Service 可用於 Web 瀏覽器,在 Visual Studio 中建立 Web 參考時,您必須明確指定網路 Proxy 伺服器的位址和連接埠。

產生之 Proxy 類別的程式語言會和 Proxy 類別所代表的 Web 服務程式語言相同。如果使用與 Visual Studio 無關的方式建立 Proxy 類別 (例如,使用 .NET Framework 工具),則會根據您使用的工具來決定程式語言。例如,如果使用 WSDL.exe,便是在命令列指定 C# 或 Visual Basic 做為程式語言。如果使用 SProxy.exe,程式語言會是 Visual C++。如需詳細資訊,請參閱 Web 服務描述語言工具 (Wsdl.exe)

在設計階段時,Proxy 類別可讓您在 XML Web Service 方法中使用陳述式完成。在執行階段,會處理 Proxy 物件的方法呼叫並編寫成 SOAP 要求訊息。如果 XML Web Service 不支援 SOAP,Proxy 類別就會使用 HTTP GET 和 POST。然後此訊息會傳給目標 Web 服務以進行處理。如果服務說明定義了回應訊息,則 Proxy 物件會處理此訊息並將回應傳回應用程式。

管理 Web 參考

您可以重新命名或修改 Web 參考,或者在參考的 Web 服務有所變更時進行更新。如需詳細資訊,請參閱HOW TO:重新命名專案 Web 參考HOW TO:更新專案 Web 參考

URL Behavior 屬性

專案中的每個 Web 參考都會與用於存取 Web 服務的 Proxy 類別互動。您可以使用 Web 參考 URL 屬性,指定到 XML Web Service 的 URL。在 ASP.NET 1.1 中,Web 參考可以使用靜態 URL 或動態 URL。在 ASP.NET 2.0 (含) 以後版本中,Web 參考會動態取得 URL。如需詳細資訊,請參閱找出 Web 服務

當您在 Visual Studio 中使用 [加入 Web 參考] 對話方塊建立 Web 參考時,這個屬性預設會設為選取之 XML Web Service 的 URL (這是一個靜態 URL)。如果將 URL 行為保留為預設的靜態值,當您建立 Proxy 類別的執行個體時,該類別會使用硬式編碼的 URL 設定 URL 屬性。

如果您將 Web 參考的 URL 行為設為動態,則應用程式會在執行階段時從應用程式組態檔的 appSettings 項目取得 URL。

請參閱

工作

HOW TO:加入和移除 Web 參考

HOW TO:重新命名專案 Web 參考

HOW TO:更新專案 Web 參考

逐步解說:在 Visual Web Developer 中建立和使用 ASP.NET Web 服務

概念

XML Web Service 探索

建立 XML Web Service Proxy

參考

Web 服務描述語言工具 (Wsdl.exe)