Oggetto My.WebServices
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 |