Freigeben über


DataRecordset.Refresh-Methode (Visio)

Führt die Abfragezeichenfolge aus, die dem verbundenen (nicht XML-basierten) DataRecordset zugeordnet ist, und aktualisiert verknüpfte Shapes mit neuen Daten aus der Datenquelle, die von der Abfrage zurückgegeben werden.

Hinweis

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

Syntax

expression.Refresh

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

Rückgabewert

Nichts

Bemerkungen

Das Aufrufen der Refresh-Methode für ein bestimmtes DataRecordset-Objekt führt dazu, dass alle anderen DataRecordset-Objekte aktualisiert werden, die demselben DataConnection-Objekt zugeordnet sind (d. a. mit demselben Wert für ihre DataConnection-Eigenschaft ). DataRecordset-Objekte , die denselben DataConnection-Eigenschaftswert verwenden, werden als Transaktionsdatenrecordsets bezeichnet. Die Refresh-Methode muss für ein Datenrecordset aufgerufen werden, das einem DataConnection-Objekt zugeordnet ist.

Wenn Sie die Refresh-Methode für ein Datenrecordset aufrufen, das keinem DataConnection-Objekt zugeordnet ist (das also mit der DataRecordsets.AddFromXML-Methode erstellt wurde), gibt die Refresh-Methode einen Fehler zurück.

Wenn das Aufrufen von Refresh zu Konflikten führt, wird auf der Benutzeroberfläche von Visio der Aufgabenbereich Aktualisierungskonflikte angezeigt. Dies geschieht jedoch nicht, wenn Sie die DataRecordset.RefreshSettings-Eigenschaft so festlegen, dass der Aufzählungswert visRefreshNoReconciliationUI enthalten ist.

Wenn Sie vor dem Aktualisieren verknüpfter Daten die Abfragezeichenfolge ändern möchten, die Visio zum Abrufen der Daten verwendet, um eine andere Tabelle in derselben Datenbank abzufragen, legen Sie die DataRecordset.CommandString-Eigenschaft auf einen neuen Wert fest. Um eine Verbindung mit einer völlig neuen Datenquelle herzustellen, legen Sie die Eigenschaftswerte DataRecordset.CommandString und DataConnection.ConnectionString fest.

Wenn Sie Daten aktualisieren und ein Konflikt auftritt, können Sie die Methoden DataRecordset.GetAllRefreshConflicts und DataRecordset.GetMatchingRowsForRefreshConflict verwenden, um zu bestimmen, warum der Konflikt aufgetreten ist.

Beispiel

Dieses VBA-Makro (Microsoft Visual Basic für Applikationen) veranschaulicht, wie Sie mithilfe der Refresh-Methode die Daten in einem DataRecordset-Objekt aus der DataRecordsets-Auflistung des aktuellen Dokuments aktualisieren. Die Anzahl aller mit dem aktuellen Dokument verknüpften Datenrecordsets wird abgerufen, und das zuletzt hinzugefügte wird aktualisiert. Außerdem werden alle anderen Datenrecordsets aktualisiert, die dem aktuellen Dokument zugeordnet sind und eine identische Datenverbindung wie das derzeit aktualisierte Datenrecordset aufweisen.

Stellen Sie vor dem Ausführen dieses Makros sicher, dass das aktuelle Dokument mindestens ein Datenrecordset enthält und dass für das zuletzt hinzugefügte Datenrecordset eine (nicht auf XML basierende) Verbindung besteht.

Public Sub Refresh_Example() 
 
    Dim vsoDataRecordset As Visio.DataRecordset 
    Dim intCount As Integer 
 
    intCount = ThisDocument.DataRecordsets.Count 
    Set vsoDataRecordset = ThisDocument.DataRecordsets(intCount) 
    vsoDataRecordset.Refresh 
 
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.