共用方式為

DataRecordset.Refresh 方法 (Visio)

執行與已連接 (非 XML 基礎 ) DataRecordset 相關的查詢字串，並以查詢回傳的資料來源更新連結形狀。

注意事項

This Visio object or member is available only to licensed users of Visio Professional 2013.

語法

expression.Refresh

詞 一個回傳 DataRecordset 物件的表達式。

傳回值

無

註解

呼叫特定 DataRecordset 物件的 Refresh 方法會重新整理所有與同一 DataConnection 物件相關的其他 DataRecordset 物件， (也就是說，它們的 DataConnection 屬性值) 相同。 DataRecordset 物件與 DataConnection 屬性相同，稱為 交易資料 記錄集。 Refresh 方法必須在與 DataConnection 物件相關聯的資料記錄集上呼叫。

如果您在不與 DataConnection 物件關聯的資料記錄集 (使用 DataRecordsets.AddFromXML 方法建立的) 上呼叫 Refresh，Refresh 方法會傳回錯誤。

如果因呼叫 Refresh 而造成衝突，除非您將 DataRecordset.RefreshSettings 屬性設為包含 visRefreshNoReconciliationUI 列舉值，否則 Visio 會在使用者介面中顯示 [重新整理衝突] 工作窗格。

在重新整理連結資料之前，如果你想更改 Visio 用來擷取資料的查詢字串，以查詢同一資料庫中不同的資料表，請將 DataRecordset.CommandString 屬性設定為新的值。 若要連接到全新的資料來源，請同時設定 DataRecordset.CommandString 和 DataConnection.ConnectionString 屬性值。

當你重新整理資料且發生衝突時，你可以使用 DataRecordset.GetAllRefreshConflicts 和 DataRecordset.GetMatchingRowsForRefreshConflict 方法來判斷衝突發生的原因。

範例

這個 Microsoft Visual Basic for Applications (VBA) 巨集會示範如何使用 Refresh 方法，來重新整理目前文件之 DataRecordsets 集合中 DataRecordset 物件的資料。 它會取得與目前文件關聯的所有資料記錄集總數，並且會重新整理最近新增的資料記錄集。 它也會重新整理與目前文件關聯，並與重新整理之資料記錄集共用一般資料連線的任何其他資料記錄集。

在執行這個巨集之前，請確定目前文件至少包含一個資料記錄集，並且已連接最近新增的資料記錄集 (不是以 XML 為基礎的)。

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

支援和意見反應

有關於 Office VBA 或這份文件的問題或意見反應嗎？ 如需取得支援服務並提供意見反應的相關指導，請參閱 Office VBA 支援與意見反應。

  • Last updated on