DataConnectionCollection-Klasse
Enthält ein Datenverbindungsobjekt, das jeder Datenverbindung entspricht, die in einer Formularvorlage verwendet wird.
Vererbungshierarchie
System.Object
Microsoft.Office.InfoPath.DataConnectionCollection
Namespace: Microsoft.Office.InfoPath
Assembly: Microsoft.Office.InfoPath (in Microsoft.Office.InfoPath.dll)
Syntax
'Declaration
Public MustInherit Class DataConnectionCollection _
Implements IEnumerable
'Usage
Dim instance As DataConnectionCollection
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:
Eine für eine sekundäre Datenquelle zum Abrufen von Daten verwendete Datenverbindung entspricht einem der folgenden Datenverbindungs-Objekttypen:
SharePointListRWQueryConnection
Hinweis
Das in früheren Versionen von InfoPath verwendete SharepointListQueryConnection-Objekt ist veraltet.
Eine nur zum Senden von Daten verwendete Datenverbindung entspricht einem der folgenden Datenverbindungs-Objekttypen:
Zum Zugreifen auf ein DataConnection-Objekt für eine bestimmte Art von Datenverbindung verwenden Sie das der Formularvorlage zugeordnete DataConnectionCollection-Objekt. Zum Zugreifen auf das DataConnectionCollection-Objekt verwenden Sie die DataConnections-Eigenschaft der XmlForm-Klasse.
Wenn Sie die Eigenschaften oder Methoden des Objekts verwenden möchten, das von der DataConnectionCollection-Auflistung zurückgegeben wird, müssen Sie dieses Objekt in den Typ umwandeln, der die von Ihnen verwendete Datenverbindungsart darstellt, bevor Sie auf diese Member zugreifen können. Wenn Sie beispielsweise mit einem AdoQueryConnection-Objekt arbeiten möchten (das eine Datenverbindung zum Abrufen von Daten aus einer Access- oder SQL Server-Datenbank darstellt), müssen Sie das von der DataConnectionCollection-Auflistung zurückgegebene Objekt umwandeln, wie in den folgenden Beispielen veranschaulicht.
// 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.
Threadsicherheit
Alle öffentlichen static (Shared in Visual Basic) Member dieses Typs sind threadsicher. Bei Instanzmembern ist die Threadsicherheit nicht gewährleistet.