Condividi tramite

Oggetto My.WebServices

  • Articolo

Specifica le proprietà per la creazione e l'accesso a una singola istanza di ogni servizio Web XML a cui fa riferimento il progetto corrente.

Osservazioni:

L'oggetto My.WebServices fornisce un'istanza di ogni servizio Web a cui si fa riferimento nel progetto corrente. Ogni istanza viene creata su richiesta. È possibile accedere a questi servizi Web tramite le proprietà dell'oggetto My.WebServices. Il nome della proprietà è uguale al nome del servizio Web a cui la proprietà accede. Qualsiasi classe che eredita da SoapHttpClientProtocol è un servizio Web. Per informazioni sull'aggiunta di servizi Web a un progetto, vedere Accesso ai servizi Web dell'applicazione.

L'oggetto My.WebServices espone solo i servizi Web associati al progetto corrente. Non fornisce l'accesso ai servizi Web dichiarati nelle DLL a cui si fa riferimento. Per accedere a un servizio Web fornito da una DLL, è necessario usare il nome completo del servizio Web nel formato DllName.WebServiceName. Per altre informazioni, vedere Accesso ai servizi Web delle applicazioni.

L'oggetto e le relative proprietà non sono disponibili per le applicazioni Web.

Proprietà

Ogni proprietà dell'oggetto My.WebServices fornisce l'accesso a un'istanza di un servizio Web con riferimento nel progetto corrente. Il nome della proprietà corrisponde al nome del servizio Web a cui accede la proprietà e il tipo di proprietà corrisponde al tipo del servizio Web.

Nota

Se si verifica un conflitto di nomi, il nome della proprietà per l'accesso a un servizio Web è RootNamespace_Namespace_ServiceName. Si considerino ad esempio due servizi Web denominati Service1. Se uno di questi servizi si trova nello spazio dei nomi radice WindowsApplication1 e nello spazio dei nomi Namespace1, si accede al servizio usando My.WebServices.WindowsApplication1_Namespace1_Service1.

Quando si accede per la prima volta a una delle proprietà dell'oggetto My.WebServices, crea una nuova istanza del servizio Web e la archivia. Gli accessi successivi di tale proprietà restituiscono tale istanza del servizio Web.

È possibile eliminare un servizio Web assegnando Nothing alla proprietà per tale servizio Web. Il setter della proprietà assegna Nothing al valore archiviato. Se si assegna un valore diverso dalla proprietà Nothing, il setter genera un'eccezione ArgumentException.

È possibile verificare se una proprietà dell'oggetto My.WebServices archivia un'istanza del servizio Web utilizzando l'operatore Is o IsNot. È possibile utilizzare tali operatori per verificare se il valore della proprietà è Nothing.

Nota

In genere, l'operatore Is o IsNot deve leggere il valore della proprietà per eseguire il confronto. Tuttavia, se la proprietà attualmente archivia Nothing, la proprietà crea una nuova istanza del servizio Web e quindi restituisce tale istanza. Tuttavia, il compilatore Visual Basic gestisce in modo speciale le proprietà dell'oggetto My.WebServices e consente all'operatore Is o IsNot di controllare lo stato della proprietà senza modificarne il valore.

Esempio

In questo esempio viene chiamato il metodo FahrenheitToCelsius del servizio Web XML TemperatureConverter e viene restituito il risultato.

Function ConvertFromFahrenheitToCelsius(
    ByVal dFahrenheit As Double) As Double

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

Per il funzionamento di questo esempio, il progetto deve fare riferimento a un servizio Web denominato Converter e tale servizio Web deve esporre il metodo ConvertTemperature. Per altre informazioni, vedere Accesso ai servizi Web delle applicazioni.

Questo codice non funziona in un progetto di applicazione Web.

Requisiti

Disponibilità per tipo di progetto

Tipo di progetto Disponibile
Applicazione Windows Sì
Libreria di classi Sì
Applicazione console Sì
Libreria di controlli Windows Sì
Libreria di controlli Web Sì
Servizio Windows Sì
Sito Web No

Vedi anche