Delen via

My.WebServices-object

  • Artikel

Biedt eigenschappen voor het maken en openen van één exemplaar van elke XML-webservice waarnaar wordt verwezen door het huidige project.

Opmerkingen

Het My.WebServices object biedt een exemplaar van elke webservice waarnaar wordt verwezen door het huidige project. Elk exemplaar wordt op aanvraag geïnstantieerd. U kunt deze webservices openen via de eigenschappen van het My.WebServices object. De naam van de eigenschap is hetzelfde als de naam van de webservice waartoe de eigenschap toegang heeft. Elke klasse waaruit wordt SoapHttpClientProtocol overgenomen, is een webservice. Zie Accessing Application Web Services voor informatie over het toevoegen van webservices aan een project.

Het My.WebServices object toont alleen de webservices die aan het huidige project zijn gekoppeld. Het biedt geen toegang tot webservices die zijn gedeclareerd in dll's waarnaar wordt verwezen. Als u toegang wilt krijgen tot een webservice die een DLL biedt, moet u de gekwalificeerde naam van de webservice gebruiken in de form DllName.WebServiceName. Zie Accessing Application Web Services voor meer informatie.

Het object en de bijbehorende eigenschappen zijn niet beschikbaar voor webtoepassingen.

Eigenschappen

Elke eigenschap van het My.WebServices object biedt toegang tot een exemplaar van een webservice waarnaar wordt verwezen door het huidige project. De naam van de eigenschap is hetzelfde als de naam van de webservice waartoe de eigenschap toegang heeft en het eigenschapstype is hetzelfde als het type van de webservice.

Notitie

Als er een naamconflict is, is de eigenschapsnaam voor toegang tot een webservice RootNamespace_Namespace_ServiceName. Denk bijvoorbeeld aan twee webservices met de naam Service1. Als een van deze services zich in de hoofdnaamruimte WindowsApplication1 en in de naamruimte Namespace1bevindt, krijgt u toegang tot die service met behulp van My.WebServices.WindowsApplication1_Namespace1_Service1.

Wanneer u voor het eerst een van de eigenschappen van het My.WebServices object opent, wordt er een nieuw exemplaar van de webservice gemaakt en opgeslagen. Volgende toegangen van die eigenschap retourneren dat exemplaar van de webservice.

U kunt een webservice verwijderen door deze toe te wijzen aan Nothing de eigenschap voor die webservice. De eigenschapssetter wijst toe aan Nothing de opgeslagen waarde. Als u een andere waarde dan Nothing aan de eigenschap toewijst, genereert de setter een ArgumentException uitzondering.

U kunt testen of een eigenschap van het My.WebServices object een exemplaar van de webservice opslaat met behulp van de Is of IsNot operator. U kunt deze operators gebruiken om te controleren of de waarde van de eigenschap is Nothing.

Notitie

Normaal gesproken moet de Is of IsNot operator de waarde van de eigenschap lezen om de vergelijking uit te voeren. Als de eigenschap momenteel echter wordt opgeslagen Nothing, maakt de eigenschap een nieuw exemplaar van de webservice en retourneert deze instantie. De Visual Basic-compiler behandelt echter de eigenschappen van het My.WebServices object speciaal en staat de Is of IsNot operator toe om de status van de eigenschap te controleren zonder de waarde ervan te wijzigen.

Opmerking

In dit voorbeeld wordt de FahrenheitToCelsius methode van de TemperatureConverter XML-webservice aangeroepen en wordt het resultaat geretourneerd.

Function ConvertFromFahrenheitToCelsius(
    ByVal dFahrenheit As Double) As Double

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

Dit voorbeeld werkt alleen als uw project verwijst naar een webservice met de naam Converteren die webservice moet de ConvertTemperature methode beschikbaar maken. Zie Accessing Application Web Services voor meer informatie.

Deze code werkt niet in een webtoepassingsproject.

Vereisten

Beschikbaarheid per projecttype

Projecttype Beschikbaar
Windows-toepassing Ja
Klassebibliotheek Ja
Console Application Ja
Windows Control Library Ja
Webbesturingsbibliotheek Ja
Windows-service Ja
Website Nee

Zie ook