Objekt my.WebServices

Článek
03/04/2013

Obsahuje vlastnosti pro vytvoření a přístup k jedné instanci každé webové služby XML odkazuje aktuální projekt.

Poznámky

Objekt My.WebServices poskytuje instanci ke každé webové službě, na kterou je odkazováno z aktuálního projektu.Každá instance je vytvořena na požádání.K webovým službám můžete přistupovat prostřednictvím vlastnosti objektu My.WebServices. Název vlastnosti je stejný jako název webová služba, ke které vlastnost přistupuje.Jakákoliv třída, která dědí z SoapHttpClientProtocol je webová služba. Informace o přidání webové služby k projektu Přístup k aplikaci webové služby (Visual Basic).

My.WebServices Objekt poskytuje pouze webové služby spojené s aktuální projekt.Neposkytuje přístup k webové služby, které jsou deklarovány v odkazované knihovny DLL.Chcete-li získat přístup k webové službě, která obsahuje knihovnu DLL, musíte použít kvalifikovaný název webové služby ve formě NázevSouboru. WebServiceName.Další informace naleznete v tématu Přístup k aplikaci webové služby (Visual Basic).

A jeho vlastnosti objektu nejsou k dispozici pro webové aplikace.

Vlastnosti

Jednotlivé vlastnosti My.WebServices objektu poskytuje přístup k instanci webové služby, která odkazuje na aktuální projekt.Název vlastnosti je stejný jako název webové služby, který má přístup k vlastnosti a typ vlastnosti je stejný jako typ webové služby.

[!POZNÁMKA]

Pokud existuje konflikt názvů, je název vlastnosti pro přístup k webové službě RootNamespace_oboru názvů_Název_služby.Zvažte například dvě webové služby s názvem Service1.Pokud je jeden z těchto služeb v oboru názvů root WindowsApplication1 a v oboru názvů Namespace1, že by přístup pomocí My.WebServices.WindowsApplication1_Namespace1_Service1.

Když poprvé otevřete jednu z My.WebServices vlastnosti objektu vytvoří novou instanci webové služby a ukládá.Další přístupy vlastnosti vrátí instanci webové služby.

Webové služby mohou disponovat přiřazením Nothing vlastnosti této webové služby.Přiřazuje vlastnost setter Nothing k uložené hodnotě.Pokud přiřadíte libovolnou hodnotu než Nothing na vlastnost setter vyvolá ArgumentException výjimku.

Můžete otestovat, zda vlastnost My.WebServices objekt uloží instanci webové služby pomocí Is nebo IsNot operátor.Tyto operátory můžete zkontrolovat, zda je hodnota vlastnosti Nothing.

[!POZNÁMKA]

Obvykle Is nebo IsNot operátor má načíst hodnotu vlastnosti provést porovnání.Ale pokud aktuálně uloženy vlastnosti Nothing, vlastnost vytvoří novou instanci webové služby a vrátí instanci.Však kompilátoru Visual Basic pracuje s vlastností My.WebServices speciálně objektu a umožní Is nebo IsNot operátor zkontrolovat stav vlastnosti bez změny jeho hodnotu.

Příklad

V tomto příkladu volá FahrenheitToCelsius metodu TemperatureConverter webovou službu XML a vrátí výsledek.

Function ConvertFromFahrenheitToCelsius( 
    ByVal dFahrenheit As Double) As Double

    Return My.WebServices.TemperatureConverter.FahrenheitToCelsius(dFahrenheit)
End Function

Například práce projektu musí odkazovat na webové služby s názvem Converter, a že webové služby, musí vystavit ConvertTemperature metoda.Další informace naleznete v tématu Přístup k aplikaci webové služby (Visual Basic).

Tento kód nefunguje v projektu webové aplikace.

Požadavky

Dostupnost podle typu projektu

Typ projektu	K dispozici
Aplikace pro systém Windows	Ano
Knihovna tříd	Ano
Konzolová aplikace	Ano
Knihovny ovládacích prvků Windows	Ano
Knihovny webových ovládacích prvků	Ano
Služby systému Windows	Ano
Sady webových souborů	Ne