DataSource-Klasse
Stellt eine Datenquelle in einer Formularvorlage dar.
Vererbungshierarchie
System.Object
Microsoft.Office.InfoPath.DataSource
Namespace: Microsoft.Office.InfoPath
Assembly: Microsoft.Office.InfoPath (in Microsoft.Office.InfoPath.dll)
Syntax
'Declaration
Public MustInherit Class DataSource
'Usage
Dim instance As DataSource
public abstract class DataSource
Hinweise
Ein DataSource-Objekt entspricht einer der Quellen gespeicherter Daten, die einer InfoPath-Formularvorlage zugeordnet sind. Ein DataSource-Objekt kann die primäre Datenquelle (Hauptdatenquelle) der Formularvorlage oder eine sekundäre Datenquelle darstellen, die mithilfe einer zugeordneten Datenverbindung (in der ersten Version von Microsoft InfoPath als Datenadapter bezeichnet) aus einer externen Datenquelle abgerufen wird. 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 gespeicherten Daten und für den Zugriff auf die zugeordnete Datenverbindung für sekundäre Datenquellen verwendet werden können. Der Zugriff auf ein DataSource-Objekt ist mithilfe der DataSources-Eigenschaft der XmlForm-Klasse möglich.
Für sekundäre Datenquellen dient das DataSource-Objekt als Mittler zwischen dem Formular und der Datenverbindung, die zum Abrufen von Daten aus einer externen Datenquelle verwendet wird, wie beispielsweise 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 Datenverbindungsobjekte aller Typen verwendet werden können, und jedes dieser Datenverbindungsobjekte stellt einen eigenen Satz von Eigenschaften und Methoden bereit.
In Microsoft InfoPath werden die folgenden Arten von Datenverbindungen unterstützt:
Eine Verbindungsabfrage oder ein Sendevorgang mithilfe von ActiveX Data Objects (ADO), dargestellt durch die Objekte AdoQueryConnection und AdoSubmitConnection.
Eine Verbindung zum Abfragen oder Senden an eine externe Datenquelle, die in Business Data Connectivity Service (BDC) auf einem Server mit SharePoint Foundation 2010 oder SharePoint Server 2010 registriert ist und durch das Objekt BdcQueryConnection oder BdcSubmitConnection dargestellt wird.
Eine Verbindung zum Abfragen einer SharePoint-Liste, die durch das Objekt SharepointListRWQueryConnection oder SharepointListRWSubmitConnection dargestellt wird.
Eine Verbindung mit einem Webdienst, dargestellt durch das WebServiceConnection-Objekt.
Eine Verbindung zum Abfragen einer XML-Datei oder zum Senden an eine XML-Datei, dargestellt durch die Objekte FileQueryConnection und FileSubmitConnection.
Eine Verbindung zum Senden per E-Mail, dargestellt durch das EmailSubmitConnection-Objekt.
Die DataSource-Klasse entspricht der DataObject-Schnittstelle im Microsoft InfoPath 2003-Objektmodell.
Threadsicherheit
Alle öffentlichen static (Shared in Visual Basic) Member dieses Typs sind threadsicher. Die Threadsicherheit von Instanzmembern ist nicht gewährleistet.