My.WebServices – objekt

  • Článek

Poskytuje vlastnosti pro vytvoření a přístup k jedné instanci každé webové služby XML odkazované aktuálním projektem.

Poznámky

Objekt My.WebServices poskytuje instanci každé webové služby odkazované aktuálním projektem. Každá instance se vytvoří instance na vyžádání. K těmto webovým službám můžete přistupovat prostřednictvím vlastností objektu My.WebServices . Název vlastnosti je stejný jako název webové služby, ke které vlastnost přistupuje. Každá třída, ze které dědí SoapHttpClientProtocol , je webová služba. Informace o přidávání webových služeb do projektu naleznete v tématu Přístup k webovým službám aplikace.

Objekt My.WebServices zveřejňuje pouze webové služby přidružené k aktuálnímu projektu. Neposkytuje přístup k webovým službám deklarovaným v odkazovaných knihovnách DLL. Chcete-li získat přístup k webové službě, kterou poskytuje knihovna DLL, je nutné použít kvalifikovaný název webové služby ve formuláři DllName.WebServiceName. Další informace naleznete v tématu Přístup k aplikačním webovým službám.

Objekt a jeho vlastnosti nejsou k dispozici pro webové aplikace.

Vlastnosti

Každá vlastnost objektu My.WebServices poskytuje přístup k instanci webové služby odkazované aktuálním projektem. Název vlastnosti je stejný jako název webové služby, ke které vlastnost přistupuje, a typ vlastnosti je stejný jako typ webové služby.

Poznámka:

Pokud dojde ke kolizi názvu, název vlastnosti pro přístup k webové službě je RootNamespace_Namespace_ServiceName. Představte si například dvě webové služby s názvem Service1. Pokud je jedna z těchto služeb v kořenovém oboru názvů WindowsApplication1 a v oboru názvů Namespace1, budete k této službě přistupovat pomocí .My.WebServices.WindowsApplication1_Namespace1_Service1

Když poprvé přistupujete k jedné z vlastností objektu My.WebServices , vytvoří novou instanci webové služby a uloží ji. Následný přístup k této vlastnosti vrátí danou instanci webové služby.

Webovou službu můžete odstranit přiřazením Nothing vlastnosti této webové služby. Vlastnost setter přiřadí Nothing uložené hodnotě. Pokud přiřadíte jinou hodnotu než Nothing vlastnost, vyvolá setter ArgumentException výjimku.

Pomocí operátoru IsNot nebo operátoru můžete otestovat, zda vlastnost objektu My.WebServices ukládá instanci webové službyIs. Tyto operátory můžete použít ke kontrole, zda je Nothinghodnota vlastnosti .

Poznámka:

Obvykle Is musí operátor IsNot číst hodnotu vlastnosti k provedení porovnání. Pokud však vlastnost aktuálně ukládá Nothing, vlastnost vytvoří novou instanci webové služby a pak vrátí tuto instanci. Kompilátor jazyka Visual Basic však zpracovává vlastnosti My.WebServices objektu speciálně a umožňuje Is nebo IsNot operátor kontrolovat stav vlastnosti beze změny jeho hodnoty.

Příklad

Tento příklad volá metodu FahrenheitToCelsiusTemperatureConverter webové služby XML a vrátí výsledek.

Function ConvertFromFahrenheitToCelsius(
    ByVal dFahrenheit As Double) As Double

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

Aby tento příklad fungoval, musí váš projekt odkazovat na webovou službu s názvem Convertera tato webová služba musí vystavit metodu ConvertTemperature . Další informace naleznete v tématu Přístup k aplikačním webovým službám.

Tento kód nefunguje v projektu webové aplikace.

Požadavky

Dostupnost podle typu projektu

Typ projektu dostupný
Aplikace pro systém Windows Ano
Knihovna tříd Ano
Konzolová aplikace Ano
Knihovna ovládacích prvků systému Windows Ano
Knihovna webových ovládacích prvků Ano
Služba systému Windows Ano
Web No

Viz také