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.SemiTrust
Assembly: Microsoft.Office.Interop.InfoPath.SemiTrust (in microsoft.office.interop.infopath.semitrust.dll)

Syntax

<CoClassAttribute(GetType(DataAdaptersCollectionWrapper))> _
<GuidAttribute("096cd692-0786-11d1-95fa-0080c78ee3bb")> _
<CLSCompliantAttribute(False)> _
Public Interface DataAdaptersCollection
    Inherits DataAdapters

Dim instance As DataAdaptersCollection

[CoClassAttribute(typeof(DataAdaptersCollectionWrapper))] 
[GuidAttribute("096cd692-0786-11d1-95fa-0080c78ee3bb")] 
[CLSCompliantAttribute(false)] 
public interface DataAdaptersCollection : DataAdapters

Hinweise

Dies ist ein Wrappertyp für eine Coklasse, die für den verwalteten Code der COM-Interoperabilität erforderlich ist. Verwenden Sie diesen Typ zum Zugreifen auf die Member der COM-Schnittstelle, die von der Coklasse implementiert wurden. Informationen zur COM-Schnittstelle, einschließlich eines Links zu den Memberbeschreibungen, 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 mit dem InfoPath 2003-Objektmodell.

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 mit dem InfoPath 2003-Objektmodell.

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

dataAdapters = thisXDocument.DataAdapters; 
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);
 }
}

Siehe auch

Referenz

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

Freigeben über