提供屬性,以建立及存取目前專案所參考之每個 XML Web 服務的單一實例。
備註
物件 My.WebServices 會提供目前項目所參考之每個 Web 服務的實例。 每個實例都會依需求具現化。 您可以透過物件的屬性 My.WebServices 存取這些 Web 服務。 屬性的名稱與屬性存取的 Web 服務名稱相同。 繼承自 SoapHttpClientProtocol 的任何類別都是 Web 服務。 如需將 Web 服務新增至專案的詳細資訊,請參閱 存取應用程式 Web 服務。
物件 My.WebServices 只會公開與目前專案相關聯的 Web 服務。 它不提供對參考 DLL 中所宣告之 Web 服務的存取權。 若要存取 DLL 提供的 Web 服務,您必須使用 DllName 格式的 Web 服務限定名稱。WebServiceName。 如需詳細資訊,請參閱 存取應用程式 Web 服務。
物件及其屬性不適用於 Web 應用程式。
屬性
物件的每個屬性 My.WebServices 都提供目前專案所參考之 Web 服務的實例存取權。 屬性的名稱與屬性所存取的 Web 服務名稱相同,而屬性類型與 Web 服務的型別相同。
備註
如果發生名稱衝突,存取 Web 服務的屬性名稱是 RootNamespace_Namespace_ServiceName。 例如,請考慮兩個名為 Service1的 Web 服務。 如果其中一項服務位於根命名空間和 命名空間WindowsApplication1Namespace1中,您可以使用 來存取該服務My.WebServices.WindowsApplication1_Namespace1_Service1。
當您第一次存取其中 My.WebServices 一個對象的屬性時,它會建立 Web 服務的新實例並儲存它。 該屬性的後續存取會傳回該 Web 服務的實例。
您可以指派 Nothing 給該 Web 服務的 屬性,以處置 Web 服務。 屬性 setter 會 Nothing 指派給預存值。 如果您將以外的任何值 Nothing 指派給 屬性,setter 會 ArgumentException 擲回例外狀況。
您可以使用 或 IsNot 運算子來測試 物件的 屬性My.WebServices是否儲存 Web 服務的Is實例。 您可以使用這些運算子來檢查 屬性的值是否為 Nothing。
備註
一般而言, Is 或 IsNot 運算符必須讀取 屬性的值,才能執行比較。 不過,如果屬性目前儲存 Nothing,則 屬性會建立 Web 服務的新實例,然後傳回該實例。 不過,Visual Basic 編譯程式會特別處理對象的屬性 My.WebServices ,並允許 Is 或 IsNot 運算元檢查屬性的狀態,而不改變其值。
範例
這個範例會呼叫 FahrenheitToCelsius XML Web 服務的方法 TemperatureConverter ,並傳回結果。
Function ConvertFromFahrenheitToCelsius(
ByVal dFahrenheit As Double) As Double
Return My.WebServices.TemperatureConverter.FahrenheitToCelsius(dFahrenheit)
End Function
若要讓此範例能夠運作,您的專案必須參考名為 Converter的 Web 服務,且該 Web 服務必須公開 ConvertTemperature 方法。 如需詳細資訊,請參閱 存取應用程式 Web 服務。
此程式代碼無法在 Web 應用程式項目中運作。
需求
依專案類型提供可用性
| 專案類型 | 有現貨 |
|---|---|
| Windows 應用程式 | 是的 |
| 類別庫 | 是的 |
| 主控台應用程式 | 是的 |
| Windows 控件庫 | 是的 |
| Web 控制庫 | 是的 |
| Windows 服務 | 是的 |
| 網站 | 否 |