Partager via

My.WebServices, objet

Fournit des propriétés permettant de créer et d’accéder à une seule instance de chaque service web XML référencé par le projet actuel.

Remarques

L’objet My.WebServices fournit une instance de chaque service Web référencé par le projet actuel. Chaque instance est instanciée sur demande. Vous pouvez accéder à ces services Web via les propriétés de l’objet My.WebServices . Le nom de la propriété est identique au nom du service Web auquel la propriété accède. Toute classe qui hérite de SoapHttpClientProtocol est un service Web. Pour plus d’informations sur l’ajout de services Web à un projet, consultez Accès aux services web d’application.

L’objet My.WebServices expose uniquement les services Web associés au projet actuel. Il ne fournit pas l’accès aux services Web déclarés dans les DLL référencées. Pour accéder à un service Web fourni par une DLL, vous devez utiliser le nom qualifié du service Web, sous la forme DllName. WebServiceName. Pour plus d’informations, consultez Accès aux services web d’application.

L’objet et ses propriétés ne sont pas disponibles pour les applications web.

Propriétés

Chaque propriété de l’objet My.WebServices fournit l’accès à une instance d’un service Web référencé par le projet actuel. Le nom de la propriété est identique au nom du service Web auquel la propriété accède, et le type de propriété est identique au type du service Web.

Remarque

S’il existe une collision de noms, le nom de la propriété permettant d’accéder à un service web est RootNamespace_Namespace_ServiceName. Par exemple, considérez deux services Web nommés Service1. Si l’un de ces services se trouve dans l’espace de noms WindowsApplication1 racine et dans l’espace de noms Namespace1, vous accédez à ce service à l’aide My.WebServices.WindowsApplication1_Namespace1_Service1de .

Lorsque vous accédez d’abord à l’une des propriétés de l’objet My.WebServices , elle crée une instance du service Web et la stocke. Les accès suivants de cette propriété retournent cette instance du service Web.

Vous pouvez supprimer un service Web en affectant Nothing à la propriété pour ce service Web. L’élément setter de Nothing propriétés affecte à la valeur stockée. Si vous affectez une valeur autre que Nothing la propriété, le setter lève une ArgumentException exception.

Vous pouvez tester si une propriété de l’objet My.WebServices stocke une instance du service Web à l’aide de l’opérateur ou IsNot de l’opérateurIs. Vous pouvez utiliser ces opérateurs pour vérifier si la valeur de la propriété est Nothing.

Remarque

En règle générale, l’opérateur Is doit IsNot lire la valeur de la propriété pour effectuer la comparaison. Toutefois, si la propriété stocke Nothingactuellement, la propriété crée une instance du service Web, puis retourne cette instance. Toutefois, le compilateur Visual Basic traite les propriétés de l’objet My.WebServices spécialement et permet à l’opérateur ou IsNot à l’opérateur Is de vérifier l’état de la propriété sans modifier sa valeur.

Exemple :

Cet exemple appelle la FahrenheitToCelsius méthode du TemperatureConverter service Web XML et retourne le résultat.

Function ConvertFromFahrenheitToCelsius(
    ByVal dFahrenheit As Double) As Double

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

Pour que cet exemple fonctionne, votre projet doit référencer un service Web nommé Converter, et ce service web doit exposer la ConvertTemperature méthode. Pour plus d’informations, consultez Accès aux services web d’application.

Ce code ne fonctionne pas dans un projet d’application web.

Spécifications

Disponibilité par type de projet

Type de projet Disponible
Application Windows Oui
Bibliothèque de classes Oui
Application console Oui
Bibliothèque de contrôles Windows Oui
Bibliothèque de contrôles web Oui
Service Windows Oui
Site Web Non

Voir aussi

  • Last updated on