DataConnectionCollection-Klasse

Artikel
04/27/2010

Enthält ein Datenverbindungsobjekt, das jeder Datenverbindung entspricht, die in einer Formularvorlage verwendet wird.

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

Syntax

'Declaration
<DefaultMemberAttribute("Item")> _
Public MustInherit Class DataConnectionCollection
    Implements IEnumerable
'Usage
Dim instance As DataConnectionCollection

[DefaultMemberAttribute("Item")] 
public abstract class DataConnectionCollection : IEnumerable

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

Verwenden Sie zum Zugreifen auf eine Instanz der DataConnectionCollection-Klasse, die einer Formularvorlage zugeordnet ist, die DataConnections-Eigenschaft der XmlForm-Klasse.

Um die Eigenschaften oder Methoden des aus DataConnectionCollection zurückgegebenen Objekts zu verwenden, müssen Sie dieses Objekt in den Typ umwandeln, der die Art von Datenverbindung darstellt, mit der Sie arbeiten, bevor Sie auf diese Member zugreifen können. Um beispielsweise mit einem AdoQueryConnection-Objekt zu arbeiten (das eine Datenverbindung zum Abrufen von Daten aus einer Access- oder SQL Server-Datenbank darstellt), müssen Sie das aus DataConnectionCollection zurückgegebene Objekt umwandeln, wie in den folgenden Beispielen gezeigt:

   // 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.DataConnectionCollection

Threadsicherheit

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

Siehe auch

Referenz

DataConnectionCollection-Member
Microsoft.Office.InfoPath-Namespace

Freigeben über