My.WebServices objektum
Tulajdonságokat biztosít az aktuális projekt által hivatkozott xml-webszolgáltatások egyetlen példányának létrehozásához és eléréséhez.
Megjegyzések
Az My.WebServices objektum az aktuális projekt által hivatkozott összes webszolgáltatás egy példányát biztosítja. A példányok példányosítása igény szerint történik. Ezeket a webszolgáltatásokat az objektum tulajdonságain keresztül érheti My.WebServices el. A tulajdonság neve megegyezik annak a webszolgáltatásnak a nevével, amelyhez a tulajdonság hozzáfér. Minden olyan osztály, amelytől öröklődik SoapHttpClientProtocol , egy webszolgáltatás. További információ a webszolgáltatások projekthez való hozzáadásáról: Accessing Application Web Services.
Az My.WebServices objektum csak az aktuális projekthez társított webszolgáltatásokat teszi elérhetővé. Nem biztosít hozzáférést a hivatkozott DLL-ekben deklarált webszolgáltatásokhoz. A DLL által biztosított webszolgáltatás eléréséhez a webszolgáltatás minősített nevét kell használnia DllName formátumban.WebServiceName. További információ: Accessing Application Web Services.
Az objektum és tulajdonságai nem érhetők el webalkalmazásokhoz.
Tulajdonságok
Az objektum minden tulajdonsága My.WebServices hozzáférést biztosít az aktuális projekt által hivatkozott webszolgáltatás egy példányához. A tulajdonság neve megegyezik annak a webszolgáltatásnak a nevével, amelyhez a tulajdonság hozzáfér, és a tulajdonság típusa megegyezik a webszolgáltatás típusával.
Feljegyzés
Ha névütközés történik, a webszolgáltatás elérésének tulajdonságneve a RootNamespace_Namespace_ServiceName. Vegyük például két webszolgáltatás nevét Service1. Ha ezen szolgáltatások egyike a gyökérnévtérben WindowsApplication1 és a névtérben Namespace1található, a szolgáltatáshoz a használatával My.WebServices.WindowsApplication1_Namespace1_Service1férhet hozzá.
Amikor először éri el az My.WebServices objektum egyik tulajdonságát, az létrehoz egy új webszolgáltatás-példányt, és tárolja azt. A tulajdonság későbbi elérései a webszolgáltatás adott példányát adja vissza.
A webszolgáltatást az adott webszolgáltatás tulajdonságához rendelve Nothing törölheti. A tulajdonságválasztó hozzárendeli Nothing a tárolt értéket. Ha a tulajdonságtól Nothing eltérő értéket rendel hozzá, a beállító kivételt ArgumentException jelez.
Tesztelheti, hogy az My.WebServices objektum egy tulajdonsága tárolja-e a webszolgáltatás egy példányát az operátor vagy IsNot az Is operátor használatával. Ezekkel az operátorokkal ellenőrizheti, hogy a tulajdonság értéke .Nothing
Feljegyzés
Az összehasonlítás elvégzéséhez általában az vagy IsNot az Is operátornak be kell olvasnia a tulajdonság értékét. Ha azonban a tulajdonság jelenleg tárolódik Nothing, a tulajdonság létrehoz egy új webszolgáltatás-példányt, majd visszaadja a példányt. A Visual Basic fordító azonban speciálisan kezeli az My.WebServices objektum tulajdonságait, és lehetővé teszi, hogy az IsIsNot operátor az érték módosítása nélkül ellenőrizze a tulajdonság állapotát.
Példa
Ez a példa meghívja az FahrenheitToCelsiusTemperatureConverter XML-webszolgáltatás metódusát, és visszaadja az eredményt.
Function ConvertFromFahrenheitToCelsius(
ByVal dFahrenheit As Double) As Double
Return My.WebServices.TemperatureConverter.FahrenheitToCelsius(dFahrenheit)
End Function
Ahhoz, hogy ez a példa működjön, a projektnek egy nevesített Converterwebszolgáltatásra kell hivatkoznia, és a webszolgáltatásnak közzé kell tennie a metódust ConvertTemperature . További információ: Accessing Application Web Services.
Ez a kód nem működik webalkalmazás-projektben.
Követelmények
Rendelkezésre állás projekttípus szerint
| Projekttípus | Rendelkezésre áll |
|---|---|
| Windows-alkalmazás | Igen |
| Osztálytár | Igen |
| Konzolalkalmazás | Igen |
| Windows-vezérlőtár | Igen |
| Webvezérlő-kódtár | Igen |
| Windows-szolgáltatás | Igen |
| Webhely | Nem |
