Freigeben über

DataSource Klasse

  • Referenz

Definition

Namespace:
Microsoft.Office.InfoPath
Assembly:
Microsoft.Office.InfoPath.dll

Stellt eine Datenquelle in einer Formularvorlage dar.

public ref class DataSource abstract
public abstract class DataSource
type DataSource = class
Public MustInherit Class DataSource
Vererbung
Object
DataSource

Hinweise

Ein DataSource -Objekt entspricht einer der Quellen der gespeicherten Daten, die einer InfoPath-Formularvorlage zugeordnet sind. Ein DataSource -Objekt kann entweder die primäre Datenquelle (Standard) der Formularvorlage oder eine sekundäre Datenquelle darstellen, die aus einer externen Datenquelle mithilfe einer zugeordneten Datenverbindung (in der ersten Version von Microsoft InfoPath als Datenadapter bezeichnet) abgerufen wurde. Das Arbeiten mit der Hauptdatenquelle eines Formulars ermöglicht den Zugriff auf das dem Formular zugrunde liegende XML-Dokument, während das Arbeiten mit einer sekundären Datenquelle den Zugriff auf aus einer externen Datenquelle, beispielsweise einer Webdienstabfrage, abgerufene Daten ermöglicht.

Das DataSource -Objekt stellt Eigenschaften und Methoden bereit, die für die programmgesteuerte Interaktion mit den gespeicherten Daten sowie für den Zugriff auf die zugeordnete Datenverbindung für sekundäre Datenquellen verwendet werden können. Auf ein DataSource -Objekt kann mithilfe der DataSources -Eigenschaft der XmlForm -Klasse zugegriffen werden.

Bei sekundären Datenquellen fungiert ein DataSource -Objekt als Vermittler zwischen dem Formular und der Datenverbindung, die zum Abrufen von Daten aus einer externen Datenquelle verwendet wird, z. B. einer Verbindung mit einer Microsoft Access- oder Microsoft SQL Server-Datenbank, einer .xml-Datei oder einem XML-Webdienst. Der Typ der Datenverbindung hängt vom Typ der externen Datenverbindung ab, die verwendet wird, um die Daten zu erhalten. Das DataSource -Objekt stellt einen gemeinsamen Satz von Eigenschaften und Methoden bereit, die für alle Typen von Datenverbindungsobjekten verwendet werden können, und jedes der Datenverbindungsobjekte stellt einen eigenen Satz von Eigenschaften und Methoden bereit.

Microsoft InfoPath unterstützt die folgenden Arten von Datenverbindungen:

  • Eine Verbindungsabfrage oder -übermittlung mithilfe von ActiveX-Datenobjekten (ADO), die durch die AdoQueryConnection -Objekte und AdoSubmitConnection dargestellt werden.
  • Eine Verbindung zum Abfragen oder Übermitteln an eine externe Datenquelle, die im Business Data Connectivity-Dienst (BDC) auf einem Server registriert ist, auf dem SharePoint Foundation 2010 oder SharePoint Server 2010 durch das - oder BdcSubmitConnection -BdcQueryConnectionObjekt dargestellt wird.
  • Eine Verbindung zum Abfragen oder Übermitteln an eine SharePoint-Liste, die durch das - oder Microsoft.Office.InfoPath.SharepointListRWSubmitConnection -Microsoft.Office.InfoPath.SharepointListRWQueryConnectionObjekt dargestellt wird.
  • Eine Verbindung mit einem Webdienst, der durch das WebServiceConnection -Objekt dargestellt wird.
  • Eine Verbindung zum Abfragen oder Übermitteln an eine XML-Datei, die durch die FileQueryConnection -Objekte und FileSubmitConnection dargestellt wird.
  • Eine Durch das -Objekt dargestellte Verbindung, die EmailSubmitConnection per E-Mail übermittelt werden soll.

Die DataSource -Klasse entspricht der DataObject-Schnittstelle im Microsoft InfoPath 2003-Objektmodell.

Konstruktoren

DataSource()

Stellt eine Datenquelle in einer Formularvorlage dar.

Eigenschaften

Name

Ruft den Namen des zugeordneten DataSource -Objekts ab.
QueryConnection

Ruft einen Verweis auf das -Objekt ab, das DataConnection der Datenquelle zugeordnet ist.
ReadOnly

Ruft einen Wert ab, der angibt, ob sich die Datenquelle im Schreibschutzmodus befindet.

Methoden

CreateNavigator()

Gibt einen XPathNavigator zurück.
GetNamedNodeProperty(XPathNavigator, String)

Ruft den Wert einer benannten Eigenschaft für den angegebenen XML-Knoten ab, bei dem es sich um einen nonattribute (nicht attributierten) Knoten in der Hauptdatenquelle handeln muss.
SetNamedNodeProperty(XPathNavigator, String, String)

Legt den Wert einer benannten Eigenschaft für den angegebenen XML-Knoten fest, bei dem es sich um einen nonattribute-Knoten in der Hauptdatenquelle handeln muss.

Gilt für: