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屬性) 具有相同的值。 共用相同DataConnection屬性值的DataRecordset物件稱為交易資料記錄集。 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 支援與意見反應。