WebServiceConnection, classe

Représente une connexion à un service Web XML.

Espace de noms : Microsoft.Office.InfoPath
Assembly : Microsoft.Office.InfoPath (dans microsoft.office.infopath.dll)

Syntaxe

Public MustInherit Class WebServiceConnection
    Inherits DataConnection

Dim instance As WebServiceConnection

public abstract class WebServiceConnection : DataConnection

Remarques

La classe WebServiceConnection représente une connexion de données créée dans InfoPath à l'aide de l'Assistant de connexion de données et qui spécifie toutes les informations nécessaires à l'extraction et à l'envoi de données de et vers une source de données via un service Web.

L'objet WebServiceConnection fournit des propriétés qui peuvent être utilisées pour obtenir et définir des informations sur les chaînes d'entrée et d'opération d'une connexion de données. Il fournit également une propriété permettant d'obtenir l'URL (Uniform Resource Locator) du fichier WSDL (Web Services Description Language) du service Web XML.

L'objet WebServiceConnection associé à la connexion de données est accessible à l'aide de la propriété DataConnections de la classe XmlForm pour renvoyer la connexion depuis la collection DataConnectionCollection du modèle de formulaire.

Outre la méthode Execute par défaut héritée de la classe de base DataConnection et qui effectue une opération de requête ou d'envoi à l'aide des valeurs qui ont été définies par déclaration en mode Création de modèle de formulaire dans InfoPath, la classe WebServiceConnection fournit également la méthode WebServiceConnection.Execute, qui permet de spécifier une source de données différente à envoyer, un emplacement différent pour insérer les données renvoyées et une procédure pour récupérer les erreurs renvoyées par la connexion.

La classe WebServiceConnection correspond à l'interface WebServiceAdapterObject du modèle objet Microsoft Office InfoPath 2003.

Exemple

Dans l'exemple suivant, une référence à l'objet WebServiceConnection qui représente la connexion appelée « Main query » est définie en transmettant le nom à la propriété Item de la classe DataConnectionCollection, puis en attribuant le type WebServiceConnection à l'objet renvoyé.[C#]

WebServiceConnection wsConnection = (WebServiceConnection)this.DataConnections["Main query"];

Dim wsConnection As WebServiceConnection = _
   DirectCast(Me.DataConnections("Main query"), WebServiceConnection)

Après avoir défini la référence, vous pouvez utiliser les propriétés de l'objet WebServiceConnection, comme illustré dans l'exemple suivant, qui définit une variable de chaîne avec la valeur renvoyée par la propriété ServiceUrl.

string wsServiceURL = wsConnection.ServiceUrl.ToString();

Dim wsServiceURL As String = _
   string wsServiceURL = wsConnection.ServiceUrl.ToString()

Hiérarchie d'héritage

System.Object
   Microsoft.Office.InfoPath.DataConnection
    Microsoft.Office.InfoPath.WebServiceConnection

Sécurité des threads

Les membres statiques publics de ce type (Shared en Visual Basic) sont sécurisés au niveau des threads. Il n'est pas garanti que les membres d'instance soient sécurisés au niveau des threads.

Voir aussi

Référence

Membres WebServiceConnection
Microsoft.Office.InfoPath, espace de noms