Share via

DataRecordset-Objekt (Visio)

  • Artikel

Speichert, formatiert und aktualisiert Daten, die aus einer Datenbank in Microsoft Visio abgefragt wurden, und zeigt diese Daten an.

Hinweis

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

HinwBemerkungeneise

Microsoft Visio kann eine Verbindung zu einer Reihe von Quellen, wie den Folgenden, herstellen:

  • Excel-Arbeitsblätter
  • Access-Datenbanken
  • SQL Server-Datenbanken
  • SharePoint-Listen
  • Andere OLEDB/ODBC-Datenquellen, z. B. Oracle-Datenbanken
  • XML-Dateien, die dem klassischen ADO-XML-Schema entsprechen

Jedes Visio Document-Objekt verfügt über eine DataRecordsets-Auflistung , die leer ist, bis eine Verbindung mit einer Datenquelle hergestellt wird. Wenn Sie ein Visio-Dokument mit einer Datenquelle verbinden möchten, fügen Sie der DataRecordsets-Auflistung des Dokuments ein DataRecordset-Objekt hinzu.

Um der DataRecordsets-Auflistung ein DataRecordset-Objekt hinzuzufügen, können Sie eine der folgenden drei Methoden verwenden, je nach Dem Typ der Datenquelle, mit der Sie eine Verbindung herstellen möchten (OLEDB/ODBC oder XML), und davon, wie Verbindungszeichenfolgen und Abfragebefehlszeichenfolgen an Visio übergeben werden sollen. Mit dem:

  • DataRecordsets.Add-Methode : Sie können eine Verbindung mit einer OLEDB- oder ODBC-Datenquelle herstellen und Informationen zur Verbindungs- und Abfragebefehlszeichenfolge direkt als Methodenparameter an Visio übergeben.

  • DataRecordsets.AddFromConnectionFile-Methode : Sie können eine Verbindung mit einer OLEBD- oder ODBC-Datenquelle herstellen, indem Sie der Methode eine ODC-Datei (Office Data Connection) übergeben, die die Verbindungs- und Abfragebefehlszeichenfolgeninformationen enthält, die Sie an Visio bereitstellen möchten.

  • DataRecordsets.AddFromXML-Methode übergeben Sie der Methode eine klassische ADO-XML-Zeichenfolge, die alle Daten enthält, die Sie in das Datenrecordset einschließen möchten.

Nachdem Sie ein Datenrecordset erstellt haben, werden die Verbindungszeichenfolge und die Abfragebefehlszeichenfolge, die dem Datenrecordset zugeordnet sind, durch die Eigenschaften DataConnection.ConnectionString bzw . CommandString dargestellt.

Wenn das Datenrecordset einem DataConnection-Objekt zugeordnet ist, d. h. wenn Sie es der DataRecordsets-Auflistung mithilfe der Add - oder AddFromConnectionFile-Methode hinzugefügt haben, können Sie die DataConnection-Eigenschaft verwenden, um das zugeordnete DataConnection-Objekt abzurufen.

Die Standardeigenschaft eines DataRecordset-Objekts ist ID. Der Wert der ID-Eigenschaft gibt das DataRecordset-Objekt in der DataRecordsets-Auflistung an und ist innerhalb der Auflistung für jedes Dokument eindeutig.

Verwenden Sie die Name-Eigenschaft , um dem Datenrecordset einen Anzeigenamen zuzuordnen.

Verwenden Sie die GetDataRowIDs-Methode , um ein Array der IDs aller Zeilen in einem Datenrecordset abzurufen, wobei jede Zeile einen einzelnen Datensatz darstellt. Nachdem Sie die Datenzeilen-IDs auf diese Weise abgerufen haben, können Sie die GetRowData-Methode verwenden, um alle in jeder Spalte in der Datenzeile gespeicherten Daten abzurufen.

Verwenden Sie die DataColumns-Eigenschaft , um das DataColumn-Objekt abzurufen, das dem Datenrecordset zugeordnet ist. Das DataColumn-Objekt macht Methoden und Eigenschaften zugänglich, mit denen Sie die Zuordnung von Datenspalten zu Zellen im Shape-Datenabschnitt der Visio ShapeSheet-Kalkulationstabelle für mit Daten verknüpfte Shapes individuell anpassen können.

Das Festlegen einer Primärschlüsselspalte für ein Datenrecordset kann helfen, beschädigte Verknüpfungen zwischen Shapes und Daten beim Aktualisieren von Daten zu verhindern. Sie können die Primärschlüsselspalte jeweils mit den Methoden GetPrimaryKey und SetPrimaryKey abrufen und festlegen.

Wenn sich Daten in der Datenquelle ändern, können Sie die Daten in einem verbundenen Datenrecordset (nicht XML) aktualisieren, um diese Änderungen widerzuspiegeln. Sie können angeben, dass Visio Daten automatisch in einem angegebenen Intervall aktualisiert, indem Sie die RefreshInterval-Eigenschaft festlegen, oder Sie können Daten programmgesteuert aktualisieren, indem Sie die Refresh-Methode aufrufen.

Konflikte können auftreten, wenn Sie Daten aus einer Datenquelle aktualisieren, die nach der letzten Datenaktualisierung geändert wurde. Konflikte können auftreten, wenn ein einzelnes Shape mit mehr als einer Zeile in derselben Datenquelle verknüpft ist oder wenn ein Shape mit einer Zeile in der Datenquelle verknüpft ist, die gelöscht wurde. Sie können die Konflikte, die beim Aktualisieren von Daten entstehen, mithilfe der Methoden GetAllRefreshConflicts, GetMatchingRowsForRefreshConflict und RemoveRefreshConflict ermitteln und beheben.

Hinweis

Wenn Sie ein Visio-Dokument speichern, das mindestens ein Datenrecordset enthält, werden alle Daten im Recordset in der Visio-Datei gespeichert. Bei Recordsets mit großen Datenmengen kann dies zu großen Visio-Dateien führen, wodurch die Leistung beeinträchtigt werden kann. Daher sollten Sie nach Möglichkeit umfangreiche Datenquellen filtern, bevor Sie sie in Visio importieren.

Veranstaltungen

Methoden

Eigenschaften

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.