DataAdaptersCollection, interface

Article
04/27/2010

Contient un objet adaptateur de données correspondant à chaque connexion de données utilisée dans un formulaire Microsoft Office InfoPath 2007.

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

Syntaxe

<CoClassAttribute(GetType(DataAdaptersCollectionWrapper))> _
<GuidAttribute("096cd692-0786-11d1-95fa-0080c78ee3bb")> _
<CLSCompliantAttribute(False)> _
Public Interface DataAdaptersCollection
    Inherits DataAdapters

Dim instance As DataAdaptersCollection

[CoClassAttribute(typeof(DataAdaptersCollectionWrapper))] 
[GuidAttribute("096cd692-0786-11d1-95fa-0080c78ee3bb")] 
[CLSCompliantAttribute(false)] 
public interface DataAdaptersCollection : DataAdapters

Remarques

Ce type est le wrapper d'une classe de composants (coclass) requise par le code managé pour l'interopérabilité COM. Ce type permet d'accéder aux membres de l'interface COM implémentés par cette classe de composants. Pour plus d'informations sur l'interface COM, et pour accéder aux descriptions de ses membres, voir DataAdapters.

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 qui permet de récupérer des données pour la source de données principale correspond à l'un des types d'objets adaptateur de données suivants :

Remarque
Un objet ADOAdapter qui permet de récupérer des données pour la source de données principale peut également envoyer des données.

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

ADOAdapterObject
SharepointListAdapterObject
WebServiceAdapterObject
XMLFileAdapterObject

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

La collection DataAdapters est accessible via la propriété DataAdapters de l'objet XDocument.

Remarque
Pour utiliser les propriétés ou les méthodes d'un objet adaptateur de données, il est nécessaire d'envoyer l'objet renvoyé à partir de l'objet DataAdaptersCollection à l'adaptateur de données spécifique qu'il représente avant de pouvoir accéder à ces membres. Pour plus d'informations sur l'utilisation des adaptateurs de données, voir Procédure d'accès à des sources de données externes en utilisant le modèle objet InfoPath 2003.

Pour utiliser les propriétés ou les méthodes d'un objet adaptateur de données, il est nécessaire d'envoyer l'objet renvoyé à partir de l'objet DataAdaptersCollection à l'adaptateur de données spécifique qu'il représente avant de pouvoir accéder à ces membres. Pour plus d'informations sur l'utilisation des adaptateurs de données, voir Procédure d'accès à des sources de données externes en utilisant le modèle objet InfoPath 2003.

Exemple

Dans l'exemple suivant, un objet ADOAdapter connecté à la table Employés de la base de données Les Comptoirs est récupéré de la collection DataAdapters :

// retrieve the Employees Adapter from the DataAdapters collection
ADOAdapter employeesDA = (ADOAdapter)thisXDocument.DataAdapters["Employees"];

Dans l'exemple suivant, le document XML appelé « form1 », disponible en tant que connexion de données à un fichier XML, est récupéré à partir de la collection DataAdapters. Différentes propriétés de la connexion s'affichent dans des boîtes de message :

DataAdapters dataAdapters;
XMLFileAdapterObject xmlFileAdapterObject;

dataAdapters = thisXDocument.DataAdapters; 
xmlFileAdapterObject = dataAdapters["form1"] as XMLFileAdapterObject;

if (xmlFileAdapterObject == null)
{
 thisXDocument.UI.Alert("The DataAdapter does not exist or is not an XMLFileAdapterObject.");
}
else
{
 thisXDocument.UI.Alert("XML file adapter" + "\n\n" + "Name: " + xmlFileAdapterObject.Name + "\n" + "QueryAllowed: " + xmlFileAdapterObject.QueryAllowed+ "\n" + "SubmitAllowed: " + xmlFileAdapterObject.SubmitAllowed+ "\n" + "FileURL: " + xmlFileAdapterObject.FileURL);

 // Perform the query.
 try
 {
  xmlFileAdapterObject.Query();
 }
 catch (Exception ex)
 {
  thisXDocument.UI.Alert("Failed to query.\n\n" + ex.Message);
 }

 // Perform the submit.
 try
 {
  xmlFileAdapterObject.Submit();
 }
 catch (Exception ex)
 {
  thisXDocument.UI.Alert("Failed to submit.\n\n" + ex.Message);
 }
}

Voir aussi

Référence

Membres DataAdaptersCollection
Microsoft.Office.Interop.InfoPath.SemiTrust, espace de noms

Partager via