DataAdaptersCollection Schnittstelle

Referenz

Definition

Namespace:: Microsoft.Office.Interop.InfoPath

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

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

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

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

Abgeleitet: Microsoft.Office.Interop.InfoPath.DataAdaptersCollectionClass

Attribute: GuidAttribute

Implementiert: DataAdapters

Beispiele

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

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

Hinweise

Dieser Typ ist ein Wrapper für eine COM-Schnittstelle, die von verwaltetem Code für COM-Interoperabilität benötigt wird. Verwenden Sie den Typ, der die CoClass umschließt, welche diese Schnittstelle implementiert, um auf die von dieser Schnittstelle angegebenen Mitglieder zuzugreifen. Informationen zu diesem Typ, einschließlich Verwendung, Anmerkungen und Beispielen, finden Sie unterDataAdapters .

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 ADOAdapter-Objekt , das zum Abrufen von Daten für die Hauptdatenquelle verwendet wird, kann auch Daten übermitteln.

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

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: Um Eigenschaften oder Methoden eines Datenadapterobjekts zu verwenden, müssen Sie das vom DataAdaptersCollection-Objekt zurückgegebene Objekt in den spezifischen Datenadapter umwandeln, den es darstellt, bevor Sie auf diese Member zugreifen können. Weitere Informationen zum Arbeiten mit Datenadaptern finden Sie unter Vorgehensweise: Zugreifen auf externe Datenquellen.

Eigenschaften

Count	Ruft die Anzahl der Datenadapter in der DataAdaptersCollection Auflistung ab. (Geerbt von DataAdapters)
Item[Object]	Ruft anhand der Position oder des Namens einen Verweis auf das angegebene Datenadapterobjekt aus der DataAdaptersCollection Auflistung ab. (Geerbt von DataAdapters)

Methoden

GetEnumerator()

Ruft einen IEnumerator ab, der alle Einträge in der DataAdapters Auflistung durchläuft.

(Geerbt von DataAdapters)

Gilt für:

Share via