DataConnection, classe

Article
04/27/2010

Représente la classe de base dont chaque type spécifique de connexion de données est dérivé.

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

Syntaxe

Public MustInherit Class DataConnection

Dim instance As DataConnection

public abstract class DataConnection

Remarques

Chaque connexion de données permet de récupérer des données (insérées dans la source de données principale ou dans une source de données secondaire) ou de les envoyer.

Une connexion de données visant à récupérer ou à envoyer des données pour la source de données principale correspond à l'un des types d'objets connexion de données suivants :

Objets AdoQueryConnection ou AdoSubmitConnection
Objet WebServiceConnection

Une connexion de données visant à récupérer des données pour une source de données secondaire correspond à l'un des types d'objets connexion de données suivants :

ADOQueryConnection
Objet SharepointListQueryConnection
Objet WebServiceConnection
Objet FileQueryConnection

Une connexion de données qui permet uniquement d'envoyer des données correspond à l'un des types d'objets connexion de données suivants :

Objet EmailSubmitConnection
Objet FileSubmitConnection
Objet WebServiceConnection

Pour accéder à un objet DataConnection d'un type donné de connexion de données, utilisez l'objet DataConnectionCollection associé au modèle de formulaire. Pour accéder à l'objet DataConnectionCollection, utilisez la propriété DataConnections de la classe XmlForm.

Pour utiliser les propriétés ou méthodes de l'objet renvoyé par DataConnectionCollection, vous devez convertir (par une opération cast) cet objet en un type représentant le type de connexion de données que vous utilisez avant de pouvoir accéder à ces membres. Ainsi, pour manipuler un objet AdoQueryConnection (qui représente une connexion de données destinée à la récupération de données d'une base de données Access ou SQL Server), vous devez convertir l'objet renvoyé par la collection DataConnectionCollection, comme l'illustrent les exemples suivants.

   // Get the Employees connection from the 
   // DataConnections collection.
   AdoQueryConnection myAdoQueryConnection =
      (AdoQueryConnection)(this.DataConnections["Employees"]);

   ' Get the Employees connection from the 
   ' DataConnections collection.
   Dim myAdoQueryConnection As AdoQueryConnection = _
      DirectCast(Me.DataConnections("Employees"), AdoQueryConnection)

Pour plus d'informations sur l'utilisation des connexions de données, consultez Procédure d'accès à des sources de données externes

Hiérarchie d'héritage

System.Object
Microsoft.Office.InfoPath.DataConnection
Classes dérivées

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 DataConnection
Microsoft.Office.InfoPath, espace de noms

Partager via