DataConnectionCollection, classe

Article
04/27/2010

Contient un objet de connexion de données correspondant à chaque connexion de données utilisée dans un modèle de formulaire.

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

Syntaxe

<DefaultMemberAttribute("Item")> _
Public MustInherit Class DataConnectionCollection
    Implements IEnumerable

Dim instance As DataConnectionCollection

[DefaultMemberAttribute("Item")] 
public abstract class DataConnectionCollection : IEnumerable

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 à une instance de la classe DataConnectionCollection associée à un modèle de formulaire, utilisez la propriété DataConnections de la classe XmlForm.

Pour utiliser les propriétés et les méthodes de l'objet renvoyé par la collection DataConnectionCollection, vous devez envoyer cet objet avec le type qui représente le type de connexion de données avec laquelle vous travaillez avant de pouvoir accéder à ces membres. Par exemple, pour travailler avec un objet AdoQueryConnection (qui représente une connexion de données pour l'extraction de données d'une base de données Access ou SQL Server), vous devez envoyer l'objet renvoyé par la collection DataConnectionCollection comme indiqué dans 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.DataConnectionCollection

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

Partager via