DataAdaptersCollection - Interface
Contient un objet adaptateur de données correspondant à chaque connexion de données utilisée dans un formulaire Microsoft InfoPath.
Espace de noms : Microsoft.Office.Interop.InfoPath
Assembly : Microsoft.Office.Interop.InfoPath (dans Microsoft.Office.Interop.InfoPath.dll)
Syntaxe
'Déclaration
<GuidAttribute("096CD692-0786-11D1-95FA-0080C78EE3BB")> _
Public Interface DataAdaptersCollection _
Inherits DataAdapters
'Utilisation
Dim instance As DataAdaptersCollection
[GuidAttribute("096CD692-0786-11D1-95FA-0080C78EE3BB")]
public interface DataAdaptersCollection : DataAdapters
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 des remarques sur son utilisation et des exemples, voirDataAdapters.
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 :
Notes
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 :
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 accessibles à l'aide de la propriété DataAdapters de l'objet XDocument .
Notes
Pour utiliser les propriétés ou méthodes d'un objet adaptateur de données, il est nécessaire d'effectuer un cast de l'objet renvoyé à partir de l'objet DataAdaptersCollection à l'adaptateur de données spécifiques qu'il représente avant que vous pouvez accéder à ces membres. Pour plus d'informations sur l'utilisation d'adaptateurs de données, voir How to: Access External Data Sources
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.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;
dataAdapters = thisXDocument.DataAdapters;
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);
}