WebServiceConnection, classe
Représente une connexion à un service Web XML.
Hiérarchie d'héritage
System.Object
Microsoft.Office.InfoPath.DataConnection
Microsoft.Office.InfoPath.WebServiceConnection
Espace de noms : Microsoft.Office.InfoPath
Assembly : Microsoft.Office.InfoPath (dans Microsoft.Office.InfoPath.dll)
Syntaxe
'Déclaration
Public MustInherit Class WebServiceConnection _
Inherits DataConnection
'Utilisation
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.
Exemples
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()
Sécurité des threads
Tout membre static (Shared dans Visual Basic) public de ce type garantit la sécurité des threads. Il n'est pas garanti que les membres d'instance soient sécurisés au niveau des threads.