DataConnectionCollection - Classe
Contient un objet de connexion de données correspondant à chaque connexion de données utilisée dans un modèle de formulaire.
Hiérarchie d’héritage
System.Object
Microsoft.Office.InfoPath.DataConnectionCollection
Espace de noms : Microsoft.Office.InfoPath
Assembly : Microsoft.Office.InfoPath (dans Microsoft.Office.InfoPath.dll)
Syntaxe
'Déclaration
Public MustInherit Class DataConnectionCollection _
Implements IEnumerable
'Utilisation
Dim instance As DataConnectionCollection
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 :
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 :
SharePointListRWQueryConnection
Notes
L'objet SharepointListQueryConnection utilisé dans les versions précédentes d'InfoPath est obsolète.
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 :
Pour accéder à un objet DataConnection d'un type donné de connexion de données particulier, 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 : Accéder à des sources de données externes
Cohérence de thread
Tous les membres statique (Partagé dans Visual Basic)s publics de ce type sont thread-safe. Cela n’est pas garanti pour les membres d’instance.