DataAdaptersCollection Interface

Référence

Définition

Espace de noms:: Microsoft.Office.Interop.InfoPath

Assembly:: Microsoft.Office.Interop.InfoPath.dll

Important

Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.

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

public interface class DataAdaptersCollection : Microsoft::Office::Interop::InfoPath::DataAdapters

[System.Runtime.InteropServices.Guid("096CD692-0786-11D1-95FA-0080C78EE3BB")]
public interface DataAdaptersCollection : Microsoft.Office.Interop.InfoPath.DataAdapters

type DataAdaptersCollection = interface
    interface DataAdapters

Public Interface DataAdaptersCollection
Implements DataAdapters

Dérivé: Microsoft.Office.Interop.InfoPath.DataAdaptersCollectionClass

Attributs: GuidAttribute

Implémente: DataAdapters

Exemples

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.<span class="label">DataAdapters</span>["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 :

<span class="label">DataAdapters</span> dataAdapters;
dataAdapters = thisXDocument.<span class="label">DataAdapters</span>; 
XMLFileAdapterObject queryXMLFile = (XMLFileAdapterObject)dataAdapters["form1"];
thisXDocument.UI.Alert("Query - XML file adapter"); 
thisXDocument.UI.Alert("Name: " + queryXMLFile.Name);
thisXDocument.UI.Alert("QueryAllowed: " + queryXMLFile.QueryAllowed);
thisXDocument.UI.Alert("SubmitAllowed: " + queryXMLFile.SubmitAllowed);
thisXDocument.UI.Alert("FileURL: " + queryXMLFile.FileURL);
// Perform the query.
try
 {
  queryXMLFile.Query();
 }
catch (Exception ex)
 {
  thisXDocument.UI.Alert("Failed to query.\n\n" + ex.Message);
 }
// Perform the submit.
try
 {
  queryXMLFile.Submit();
 }
catch (Exception ex)
 {
  thisXDocument.UI.Alert("Failed to submit.\n\n" + ex.Message);
}

Remarques

Ce type est le wrapper d’une interface COM implémentée par une coclasse qui est requise par le code managé pour l’interopérabilité COM. Pour accéder aux membres indiqués par cette interface, utilisez le type qui encapsule la coclasse qui implémente cette interface. Pour plus d’informations sur ce type, notamment sur l’utilisation, les remarques et les exemples, consultezDataAdapters .

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 utilisé pour 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 :

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 à l’aide de la DataAdapters propriété de l’objet XDocument .

Remarque : Pour utiliser des propriétés ou des méthodes d’un objet adaptateur de données, il est nécessaire de convertir l’objet retourné de l’objet DataAdaptersCollection vers 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, consultez Guide pratique pour accéder à des sources de données externes

Propriétés

Count	Obtient le nombre d’adaptateurs de données dans la DataAdaptersCollection collection. (Hérité de DataAdapters)
Item[Object]	Obtient une référence à l’objet adaptateur de données spécifié à partir de la collection, en fonction de la DataAdaptersCollection position ou du nom. (Hérité de DataAdapters)

Méthodes

GetEnumerator()

Obtient un IEnumerator qui itère sur toutes les entrées de la DataAdapters collection.

(Hérité de DataAdapters)

S’applique à

Partager via