DataAdaptersCollection-Schnittstelle

Artikel
04/27/2010

Enthält ein Datenadapterobjekt, das jeder Datenverbindung entspricht, die in einem Microsoft Office InfoPath 2007-Formular verwendet wird.

Namespace: Microsoft.Office.Interop.InfoPath
Assembly: Microsoft.Office.Interop.InfoPath (in microsoft.office.interop.infopath.dll)

Syntax

<GuidAttribute("096CD692-0786-11D1-95FA-0080C78EE3BB")> _
<CoClassAttribute(GetType(DataAdaptersCollectionClass))> _
Public Interface DataAdaptersCollection
    Inherits DataAdapters

Dim instance As DataAdaptersCollection

[GuidAttribute("096CD692-0786-11D1-95FA-0080C78EE3BB")] 
[CoClassAttribute(typeof(DataAdaptersCollectionClass))] 
public interface DataAdaptersCollection : DataAdapters

Hinweise

Dies ist ein Wrapper für eine COM-Schnittstelle, die durch eine Coklasse implementiert wurde, die für den verwalteten Code der COM-Interoperabilität erforderlich ist. Verwenden Sie den Coklasse umschließenden Typen, der von der Schnittstelle implementiert wird, um auf die in der Schnittstelle angegebenen Member zuzugreifen. Informationen zu dem Typ, einschließlich Verwendung, Hinweise und Beispiele, finden Sie unter DataAdapters.

Jede Datenverbindung wird zum Abrufen von Daten (eingefügt in die Hauptdatenquelle oder eine sekundäre Datenquelle) oder zum Senden von Daten verwendet.

Eine zum Abrufen von Daten für die Hauptdatenquelle verwendete Datenverbindung entspricht einem der folgenden Datenadapter-Objekttypen:

Hinweis:
Ein zum Abrufen von Daten für die Hauptdatenquelle verwendetes ADOAdapter-Objekt kann auch Daten senden.

Eine zum Abrufen von Daten für eine sekundäre Datenquelle verwendete Datenverbindung entspricht einem der folgenden Datenadapter-Objekttypen:

ADOAdapterObject
SharepointListAdapterObject
WebServiceAdapterObject
XMLFileAdapterObject

Eine nur zum Senden von Daten verwendete Datenverbindung entspricht einem der folgenden Datenadapter-Objekttypen:

Auf die DataAdapters-Auflistung kann mithilfe der DataAdapters-Eigenschaft des XDocument-Objekts zugegriffen werden.

Hinweis:
Damit die Eigenschaften und Methoden eines Datenadapterobjekts verwendet werden können, muss das vom DataAdaptersCollection-Objekt zurückgegebene Objekt dem spezifischen Datenadapter, den es darstellt, zugeordnet werden, bevor Sie auf dessen Member zugreifen können. Weitere Informationen zum Verwenden von Datenadaptern finden Sie unter Vorgehensweise: Zugreifen auf externe Datenquellen.

Beispiel

Im folgenden Beispiel wird ein mit der Employees-Tabelle der Northwind-Datenbank verbundenes ADOAdapter-Objekt aus der DataAdapters-Auflistung abgerufen:

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

Im folgenden Beispiel wird das XML-Dokument "form1", das als Datenverbindung der XML-Datei verfügbar ist, aus der DataAdapters-Auflistung abgerufen. Verschiedene Eigenschaften der Verbindung werden in Meldungsfeldern angezeigt:

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);
}

Siehe auch

Referenz

DataAdaptersCollection-Member
Microsoft.Office.Interop.InfoPath-Namespace

Share via