My.WebServices, objet

Mise à jour : novembre 2007

Fournit des propriétés permettant de créer et d'accéder à une instance unique de chaque service Web XML référencé par le projet en cours.

Notes

L'objet My.WebServices fournit une instance de chaque service Web référencé par le projet actuel. Chaque instance est instanciée à la demande. Vous pouvez accéder à ces services Web via les propriétés de l'objet My.WebServices. La propriété porte le même nom que celui 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 Comment : accéder à un service Web en code managé.

L'objet My.WebServices n'expose que les services Web associés au projet actuel. Il ne fournit pas un 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 en code managé.

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. La propriété porte le même que celui du service Web auquel accède la propriété et le type de propriété porte le même nom que le type de service Web.

Remarque :

Si une collision de noms se produit, le nom de la propriété pour accéder à un service Web est RootNamespace_Namespace_FormName. Par exemple, considérez deux services Web nommés Service1. Si l'un de ces services se trouve dans l'espace de noms racine WindowsApplication1 et dans l'espace de noms Namespace1, vous accédez à ce service en utilisant My.WebServices.WindowsApplication1_Namespace1_Service1.

Lorsque vous accédez en premier lieu à l'une des propriétés de l'objet My.WebServices, il crée une instance du service Web et le stocke. Les accès ultérieurs de cette propriété retournent cette instance du service Web.

Vous pouvez supprimer un service Web en assignant Nothing à la propriété de ce service Web. L'accesseur Set de la propriété assigne Nothing à la valeur stockée. Si vous assignez une valeur autre que Nothing à la propriété, l'accesseur Set lève une exception ArgumentException.

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

Remarque :

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

Tâches

Le tableau suivant répertorie un exemple de tâche impliquant l'objet My.Forms.

Exemple

Cet exemple appelle la méthode FahrenheitToCelsius du service Web XML TemperatureConverter 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 appelé Converter et ce dernier exposer la méthode ConvertTemperature. Pour plus d'informations, consultez Comment : accéder à un service Web en code managé.

Ce code ne fonctionne pas dans un projet d'application Web.

Configuration requise

Disponibilité par type de projet

Voir aussi

Tâches

Comment : accéder à un service Web en code managé

Concepts

Accès aux services Web d'une application

Référence

SoapHttpClientProtocol

ArgumentException

Autres ressources

Accès aux services Web en code managé