DataConnection-Klasse

Artikel
04/27/2010

Stellt die Basisklasse dar, vom dem jeder spezifische Datenverbindungstyp abgeleitet wird.

Namespace: Microsoft.Office.InfoPath
Assembly: Microsoft.Office.InfoPath (in microsoft.office.infopath.dll)

Syntax

'Declaration
Public MustInherit Class DataConnection
'Usage
Dim instance As DataConnection

public abstract class DataConnection

Hinweise

Jede Datenverbindung wird zum Abrufen von Daten (eingefügt in die Hauptdatenquelle oder eine sekundäre Datenquelle) oder zum Senden von Daten verwendet.

Eine für die Hauptdatenquelle zum Abrufen oder Senden von Daten verwendete Datenverbindung entspricht einem der folgenden Datenverbindungs-Objekttypen:

AdoQueryConnection- oder AdoSubmitConnection-Objekte
WebServiceConnection-Objekt

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

ADOQueryConnection
SharepointListQueryConnection-Objekt
WebServiceConnection-Objekt
FileQueryConnection-Objekt

Eine nur zum Senden von Daten verwendete Datenverbindung entspricht einem der folgenden Datenverbindungs-Objekttypen:

EmailSubmitConnection-Objekt
FileSubmitConnection-Objekt
WebServiceConnection-Objekt

Für den Zugriff auf ein DataConnection-Objekt für eine bestimmte Datenverbindungsart wird das der Formularvorlage zugeordnete DataConnectionCollection-Objekt verwendet, für den Zugriff auf das DataConnectionCollection-Objekt die DataConnections-Eigenschaft der XmlForm-Klasse.

Um die Eigenschaften oder Methoden des von DataConnectionCollection zugegebenen Objekts zu verwenden, müssen Sie dieses Objekt in den Typ umwandeln, der die Datenverbindungsart darstellt, mit der Sie arbeiten, bevor Sie auf diese Member zugreifen können. Beispielsweise Müssen Sie zum Verwenden eines AdoQueryConnection-Objekts (das eine Datenverbindung für den Abruf von Daten von der Access- oder SQL Server-Datenbank darstellt) das von DataConnectionCollection zurückgegebene Objekt umwandeln, wie in den folgenden Beispielen dargestellt.

   // Get the Employees connection from the 
   // DataConnections collection.
   AdoQueryConnection myAdoQueryConnection =
      (AdoQueryConnection)(this.DataConnections["Employees"]);

   ' Get the Employees connection from the 
   ' DataConnections collection.
   Dim myAdoQueryConnection As AdoQueryConnection = _
      DirectCast(Me.DataConnections("Employees"), AdoQueryConnection)

Weitere Informationen zum Verwenden von Datenverbindungen finden Sie unter Vorgehensweise: Zugreifen auf externe Datenquellen.

Vererbungshierarchie

System.Object
Microsoft.Office.InfoPath.DataConnection
Abgeleitete Klassen

Threadsicherheit

Alle öffentlichen statischen (Shared in Visual Basic) Member dieses Typs sind threadsicher. Bei Instanzmembern ist die Threadsicherheit nicht gewährleistet.

Siehe auch

Referenz

DataConnection-Member
Microsoft.Office.InfoPath-Namespace

Freigeben über