Condividi tramite

Oggetto My.WebServices

Fornisce 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 fa riferimento il 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à corrisponde al nome del servizio Web a cui accede la proprietà. 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 dell'applicazione.

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

Proprietà

Ogni proprietà dell'oggetto fornisce l'accesso a un'istanza My.WebServices di un servizio Web a cui fa riferimento il 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.

Annotazioni

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 e nello spazio WindowsApplication1 dei nomi Namespace1, si accede al servizio usando My.WebServices.WindowsApplication1_Namespace1_Service1.

Quando si accede per la prima volta a una delle My.WebServices proprietà dell'oggetto, 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 Nothing dalla proprietà , il setter genera un'eccezione ArgumentException .

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

Annotazioni

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 FahrenheitToCelsius metodo del TemperatureConverter servizio Web XML 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 Convertere tale servizio Web deve esporre il ConvertTemperature metodo . Per altre informazioni, vedere Accesso ai servizi Web dell'applicazione.

Questo codice non funziona in un progetto di applicazione Web.

Requisiti

Disponibilità per tipo di progetto

Tipo progetto Disponibile
Applicazione Windows Sì
Biblioteca di classi Sì
Applicazione console Sì
Libreria di controlli Windows Sì
Libreria di controlli Web Sì
Servizio Windows Sì
Sito web NO

Vedere anche

  • Last updated on