Freigeben über


DataAdaptersCollection Schnittstelle

Definition

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

public interface class DataAdaptersCollection : Microsoft::Office::Interop::InfoPath::SemiTrust::DataAdapters
[System.Runtime.InteropServices.Guid("096cd692-0786-11d1-95fa-0080c78ee3bb")]
public interface DataAdaptersCollection : Microsoft.Office.Interop.InfoPath.SemiTrust.DataAdapters
type DataAdaptersCollection = interface
    interface DataAdapters
Public Interface DataAdaptersCollection
Implements DataAdapters
Attribute
Implementiert

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;
XMLFileAdapterObject xmlFileAdapterObject;

dataAdapters = thisXDocument.<span class="label">DataAdapters</span>; 
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);
 }
}

Hinweise

Dieser Typ ist ein Wrapper für eine CoClass, die von verwaltetem Code für COM-Interoperabilität benötigt wird. Verwenden Sie diesen Typ, um auf die Mitglieder der COM-Schnittstelle zuzugreifen, die von dieser CoClass implementiert wird. Informationen zur COM-Schnittstelle, einschließlich eines Links zu Beschreibungen ihrer Member, 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 Standard Datenquelle 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, muss das vom DataAdaptersCollection-Objekt zurückgegebene Objekt in den spezifischen Datenadapter umgewandelt werden, den es darstellt, bevor Sie auf diese Member zugreifen können. Weitere Informationen zum Verwenden von Datenadaptern finden Sie unter Vorgehensweise: Zugreifen auf externe Datenquellen mit dem InfoPath 2003-Objektmodell.

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 im DataAdaptersEnumerator -Objekt durchläuft.

(Geerbt von DataAdapters)

Gilt für: