DataRecordset.Refresh 方法 (Visio)

執行與已連線 (非 XML 型) DataRecordset 相關聯的查詢字串，並使用查詢所傳回資料來源的新資料來更新連結的圖形。

語法

expression.Refresh

運算式 傳回 DataRecordset 物件的運算式。

傳回值

無

註解

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

如果您在不與 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 支援與意見反應。