My.WebServices – objekt

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.

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 .

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

Viz také

• SoapHttpClientProtocol
• ArgumentException
• Přístup k aplikačním webovým službám