Exporter (0) Imprimer
Développer tout
Cet article a fait l'objet d'une traduction automatique. Déplacez votre pointeur sur les phrases de l'article pour voir la version originale de ce texte.
Traduction
Source

Procédure d'accès à des sources de données externes

Dernière modification : mardi 28 juin 2011

S’applique à : InfoPath 2013 | InfoPath Forms Services | Office 2013 | SharePoint Server 2013

Dans cet article
Présentation de la classe DataSourceCollection
Présentation de la classe DataSource
Présentation des classes de connexion de données
Utilisation des classes DataSourceCollection et DataSource
Utilisation des classes DataConnectionCollection et DataConnection

Lorsque vous travaillez avec un modèle de formulaire InfoPath, vous pouvez écrire du code pour accéder aux sources de données secondaires du formulaire et manipuler les données qu'elles contiennent.

Chaque source de données secondaire est représentée par un objet instancié à l'aide de la classe DataSource et correspond à des données stockées, obtenues à partir d'une source de données externe, par exemple une base de données ou une requête d'un service Web. Ces sources de données sont désignées comme sources secondaires car lorsque l'utilisateur enregistre un formulaire InfoPath, il enregistre uniquement les données de la source de données principale et non les données des sources de données secondaires. La connexion à une source de données est représentée par un objet instancié à l'aide d'une des classes de « connexion de données » telles que la classe WebServiceConnection, qui représente une connexion de données à un service Web XML.

L'objet instancié DataSource représente le stockage de données XML renvoyées par une connexion de données (à partir d'une requête de base de données ou de service Web), et la classe de « connexion de données » représente la connexion de données elle-même (telle que définie et nommée au moyen de la commande Connexions de données dans l'onglet Données).

Le modèle objet d'InfoPath prend en charge l'accès aux sources de données secondaires d'un formulaire grâce à l'utilisation de la classe DataSource en association avec la classe DataSourceCollection.

Le modèle objet d'InfoPath fournit également un ensemble de classes de connexion de données contenant des informations relatives aux connexions de données utilisées par le formulaire.

Remarque Remarque

Dans Microsoft InfoPath 2003, une connexion de données est appelée adaptateur de données.

Il existe deux types de connexions de données : les connexions de requête permettent de récupérer les données qui sont ensuite stockées dans une source de données secondaire. Les connexions d'envoi sont utilisées pour envoyer des données, par exemple à une base de données ou à un site Web. Les données envoyées sont copiées depuis la source de données principale ou la source de données secondaire.

La classe DataSourceCollection fournit aux développeurs les méthodes et propriétés suivantes pour gérer les instances d'objets DataSourceCollection que contient le formulaire.

Nom

Description

Propriété Count

Renvoie le nombre d'instances d'objets DataSource que contient la collection.

Méthode GetEnumerator

Renvoie un IEnumerator qui peut être utilisé pour lancer une répétition dans la collection.

Propriété Item[Int32]

Renvoie une référence à l'objet DataSource spécifié par valeur d'index.

Propriété Item[String]

Renvoie une référence à l'objet DataSource spécifié par nom d'index.

La classe DataSourceCollection offre aux développeurs de formulaires les méthodes et les propriétés ci-dessous pour interagir avec une source de données secondaire InfoPath.

Nom

Description

Méthode CreateNavigator

Renvoie un objet XPathNavigator pour accéder à la source de données et la modifier

Propriété QueryConnection

Obtient une référence à l'objet de connexion de données associé.

Pour exécuter la requête sur la connexion de données et insérer les données renvoyées sous forme de code XML dans le nœud XML associé à l'objet DataSource, utilisez la méthode Execute de l'objet de connexion de données associé.

Propriété Name

Obtient le nom de l'objet DataSource.

Propriété ReadOnly

Obtient une valeur qui indique si la source de données est en lecture seule.

Méthode GetNamedNodeProperty

Obtient la valeur d'une propriété nommée pour le nœud XML spécifié, lequel doit être un nœud nonattribute dans la source de données principale.

Méthode SetNamedNodeProperty

Définit la valeur d'une propriété nommée pour le nœud XML spécifié, lequel doit être un nœud nonattribute dans la source de données principale.

Les classes conçues pour accéder aux connexions de données fournissent plusieurs propriétés et méthodes permettant d'échanger des données via des connexions avec des sources de données externes. La connexion de données associée à un objet DataSource dépend du type de connexion de données externe. InfoPath implémente les classes suivantes pour accéder aux connexions de données :

Nom

Description

Classe AdoQueryConnection

Interroge une source de données ADO/OLEDB ; limité à Microsoft Access et Microsoft SQL Server.

Classe AdoSubmitConnection

Envoie à une source de données ADO/OLEDB ; limité à Microsoft Access et Microsoft SQL Server.

Classe SharePointListRWQueryConnection

Interroge une liste ou une bibliothèque de documents SharePoint.

SharePointListRWSubmitConnection

Envoie à une liste ou une bibliothèque de documents SharePoint.

Classe WebServiceConnection

Établit une connexion à un service Web XML.

Classe FileQueryConnection

Interroge un fichier XML.

Classe FileSubmitConnection

Envoie à un fichier XML.

Classe EmailSubmitConnection

Envoie un formulaire sous forme de pièce jointe dans un courrier électronique.

Classe BdcQueryConnection

Interroge une liste externe sur un serveur exécutant SharePoint Foundation 2010 ou SharePoint Server 2010.

Classe BdcSubmitConnection

Envoie à une liste externe sur un serveur exécutant SharePoint Foundation 2010 ou SharePoint Server 2010.

L'objet DataSourceCollection qui représente la collection de sources de données associées à un modèle de formulaire est accessible par le biais de la propriété DataSources de la classe XmlForm. Si, par exemple, vous créez une source de données secondaire nommée Employés qui extrait des données de la table Employees dans la base de données Les comptoirs, vous pouvez utiliser l'objet DataSourceCollection pour définir une référence à un objet DataSource qui représente les données extraites.

Dans l'exemple de code suivant, le nom de la source de données secondaires est transmis à la propriété d'accès de la classe DataSourceCollection, qui renvoie une référence à l'objet DataSource qui représente les données extraites de la table Employés. Le nœud XML qui stocke les données extraites à partir de la source de données secondaire s'affiche dans une zone de message au moyen de la méthode CreateNavigator de la classe DataSource pour accéder à la propriété InnerXml de la classe XPathNavigator.

// Instantiate a variable to access the specified data source
// from the DataSourceCollection of the form.
DataSource myDataSource = 
   this.DataSources["Employees"];

// Display the XML data from the secondary data source.
MessageBox.Show("Data source data: " +
   myDataSource.CreateNavigator().InnerXml.ToString());

Pour manipuler les données figurant dans une source de données secondaire, utilisez la méthode CreateNavigator de la classe DataSource pour renvoyer une référence à un objet XPathNavigator positionné au niveau du nœud où sont stockées les données secondaires. Vous pouvez utiliser les propriétés et méthodes de la classe XPathNavigator pour manipuler les données. Pour plus d'informations, voir Utilisation des classes XPathNavigator et XPathNodeIterator.

L'objet DataConnectionCollection qui représente la collection de connexions de données associées à un modèle de formulaire est accessible par le biais de la propriété DataConnections de la classe XmlForm. Si, par exemple, vous créez une source de données secondaire nommée Employés qui extrait les données de la table Employés dans la base de données Les comptoirs, vous pouvez utiliser l'objet DataConnectionCollection associé au modèle de formulaire pour définir une référence à DataConnection qui représente la connexion à la base de données.

Dans l'exemple de code qui suit, le nom de la source de données secondaire est transmis à la propriété d'accès de la classe DataConnectionCollection, qui, dans ce cas, renvoie une référence à l'objet ADOQueryConnection qui représente la connexion à la base de données Les comptoirs. Pour que cet exemple fonctionne correctement, vous devez forcer la conversion de façon explicite de l'objet renvoyé au type ADOQueryConnection. La propriété Connection de l'interface ADOAdapterObject permet d'afficher la chaîne de connexion ADO dans une boîte de message.

// Instantiate a variable to access the specified data connection
// from the DataConnectionCollection of the form. 
// You must cast to the specific data connection type
// (ADOQueryConnection) before you can access the data connection.
ADOQueryConnection myADOConnection = 
   (ADOQueryConnection)this.DataConnections["Employees"];

// Display the connection information for the data connection.
MessageBox.Show("Connection string: " + myADOConnection.Connection);
Afficher:
© 2014 Microsoft