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 參考。
注意事項: |
---|
若要讓防火牆外部的 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。
請參閱
工作
逐步解說:在 Visual Web Developer 中建立和使用 ASP.NET Web 服務