DataRecordsets.AddFromConnectionFile-Methode (Visio)

Artikel
04/07/2023

Fügt der DataRecordsets-Auflistung mithilfe der Verbindungs- und Abfrageinformationen in einer ODC-Datei (Office Data Connection) ein DataRecordset-Objekt hinzu, um eine Verbindung mit einer OLEDB- oder ODBC-Datenquelle herzustellen und Daten daraus abzurufen.

Hinweis

Dieses Visio-Objekt oder dieses Visio-Mitglied ist nur für lizenzierte Benutzer von Visio Professional 2013 verfügbar.

Syntax

Ausdruck. AddFromConnectionFile (FileName, AddOptions, Name)

Ausdruck Ein Ausdruck, der ein DataRecordsets-Objekt zurückgibt.

Parameter

Name	Erforderlich/Optional	Datentyp	Beschreibung
FileName	Erforderlich	String	Der Name der zu verwendenden ODC-Verbindungsdatei.
AddOptions	Erforderlich	Long	Optionen, die die Eigenschaften des hinzuzufügenden Datenrecordsets bestimmen. Eine Kombination aus einem oder mehreren aufgezählten Werten aus VisDataRecordsetAddOptions. Weitere Informationen hierzu finden Sie unter „Hinweise“.
Name	Optional	String	Weist dem hinzuzufügenden DataRecordset-Objekt einen Anzeigenamen zu.

Rückgabewert

DataRecordset

HinwBemerkungeneise

Übergeben Sie für den FileName-Parameter den Namen und den vollständigen Pfad einer ODC-Datei, die eine Verbindungszeichenfolge enthält, die angibt, wie eine Verbindung zu einer OLEDB- oder ODBC-Datenquelle hergestellt wird, und die eine Abfragezeichenfolge enthält, die angibt, wie die gewünschten Daten aus der Datenquelle extrahiert werden.

Eine ODC-Datei speichert Verbindungs- und Abfrageinformationen unter Verwendung von HTML und XML. Sie können den Inhalt der Datei in jedem Texteditor anzeigen und bearbeiten. ODC-Dateien haben die Dateinamenerweiterung ODC. Verwenden Sie den Datenverbindungs-Assistenten in Microsoft Access oder Microsoft Excel, um eine ODC-Datei zu erstellen, die eine Verbindung mit den gewünschten Daten herstellt und diese abruft.

Der AddOptions-Parameter kann eine Kombination aus den folgenden Werten aus der VisDataRecordsetAddOptions-Aufzählung sein, die in der Visio-Typbibliothek deklariert ist. Die Standardeinstellung ist Null (0), wodurch angegeben wird, dass keine der Optionen festgelegt wird.

Konstante	Wert	Beschreibung
visDataRecordsetNoExternalDataUI	1	Verhindert, dass Daten im neuen Datenrecordset im Fenster Externe Daten angezeigt werden.
visDataRecordsetNoRefreshUI	2	Verhindert, dass das Datenrecordset in den Aktualisierungsvorgang einbezogen und im Dialogfeld Daten aktualisieren angezeigt wird.
visDataRecordsetNoAdvConfig	4	Verhindert, dass das Datenrecordset im Dialogfeld Aktualisierung konfigurieren angezeigt wird.
visDataRecordsetDelayQuery	8	Fügt ein Datenrecordset hinzu, führt jedoch die CommandString-Abfrage erst aus, wenn Sie das nächste Mal die Refresh-Methode aufrufen.
visDataRecordsetDontCopyLinks	16	Fügt ein Datenrecordset hinzu, aber Shape-Daten-Verknüpfungen werden nicht ausgeschnitten oder kopiert.

Wenn Sie diese Werte zugewiesen haben, können sie während der Lebensdauer des DataRecordset-Objekts nicht mehr geändert werden.

Das Argument Name ist eine optionale Zeichenfolge, mit der Sie dem Datenrecordset einen Anzeigenamen zuweisen können. Wenn Sie angeben, dass das Fenster Externe Daten in der Benutzeroberfläche von Visio angezeigt werden soll, wird der für dieses Argument übergebene Name im Fenster Externe Daten auf der Registerkarte angezeigt, die dem hinzugefügten Datenrecordset entspricht.

Wenn die AddFromConnectionFile-Methode erfolgreich ist, führt sie die folgenden Aktionen aus:

Es wird ein DataRecordset-Objekt erstellt, dem der Name zugewiesen wird, der im Name-Parameter angegeben ist. Wenn Sie keinen Namen angeben, weist Visio dem Datenrecordset den Namen der Datenbanktabelle zu, die die Quelle der Daten ist.
Ein neues oder vorhandenes DataConnection-Objekt wird mit dem DataRecordset-Objekt verknüpft.
Führt die in der Befehlszeichenfolge in der ODC-Datei angegebene Abfragezeichenfolge aus und ruft die resultierenden Daten ab.
Die Datentypen der Spalten in der Datenquelle werden den entsprechenden Datentypen in Visio zugewiesen. Gleichzeitig werden durch das Filtern der Ergebnisse Datenquellenspalten entfernt, die nicht mit Visio-Shapes verknüpft werden können, da sie keinen entsprechenden Visio-Datentyp aufweisen.
Jeder Zeile im Datenrecordset wird eine Zeilen-ID zugewiesen. Weitere Informationen zu Zeilen-IDs finden Sie im Thema zur DataRecordset.GetDataRowIDs-Eigenschaft .

Hinweis

Die AddFromConnectionFile-Methode schlägt fehl und gibt eine Ausnahme zurück, wenn Fehler in Bezug auf Netzwerkverbindungen, Netzwerktimeouts oder Datenbankberechtigungen auftreten.

Beispiel

Das folgende VBA-Makro (Microsoft Visual Basic for Applications) zeigt, wie Sie die AddFromConnectionString-Methode verwenden können, um eine Visio-Zeichnung zu verbinden, um eine Verbindung mit Daten in der Tabelle Products der Mit Microsoft Access bereitgestellten Northwind-Datenbank herzustellen. Verwenden Sie vor dem Ausführen dieses Beispielcodes den Datenverbindungs-Assistenten, um eine ODC-Datei zu erstellen, und ersetzen Sie den Wert der Variablen strFile durch den vollständigen Pfad zu und den Dateinamen der odc-Datei, die Sie erstellt haben. Geben Sie optional einen anderen Wert für die variable strName an.

Public Sub AddFromConnectionFile_Example() 
 
    Dim strFile As String 
    Dim strName As String 
    Dim vsoDataRecordset As Visio.DataRecordset 
 
    strFile = "C:\Users\username \Documents\My Data Sources\Northwind.mdb Products.odc" 
 
    strName = "Data from ODC" 
 
    Set vsoDataRecordset = ThisDocument.DataRecordsets.AddFromConnectionFile(strFile, 0, strName) 
 
End Sub

Support und Feedback

Haben Sie Fragen oder Feedback zu Office VBA oder zu dieser Dokumentation? Unter Office VBA-Support und Feedback finden Sie Hilfestellung zu den Möglichkeiten, wie Sie Support erhalten und Feedback abgeben können.