Excel) (WorkbookConnection.Refresh 方法

會重新整理活頁簿連線。

語法

expression.Refresh

運算式 代表 WorkbookConnection 物件的變數。

註解

如果 DisplayAlerts 屬性為 False,則不會顯示對話方塊,並且 Refresh 方法會失敗,並出現「連線資訊不足」例外狀況。

一個連線的重新整理失敗不會影響其他連線的重新整理作業。

如果連線將使用 Power Query 建立的查詢載入工作表資料表,則連線的背景重新整理會關閉, (其 OLEDBConnection 物件的 BackgroundQuery 屬性為 False) ,並且整個查詢無法評估 (,例如,因為error步驟中的運算式,或在計算步驟值而不是在單一儲存格內計算時失敗的函數 Number.FromText) , Refresh 方法會引發執行階段錯誤 1004,並包含一般描述 (「應用程式定義或物件定義的錯誤 ) 。 不包括查詢產生的錯誤訊息。 若要取得查詢的錯誤訊息,請使用其 QueryTable 物件的 Refresh 方法來重新整理資料表,並改為關閉背景重新整理。 該方法會引發相同的錯誤編號,且其描述包含查詢的錯誤,例如 [Expression.Error] ...。

如果開啟背景重新整理, Refresh 方法會在重新整理完成之前傳回,而且重新整理期間發生的錯誤不會傳回呼叫代碼。

查詢結果的個別儲存格錯誤不會導致重新整理失敗。 重新整理成功,而那些儲存格會保留空白。

範例

此範例會重新整理使用中工作表上的每個查詢資料表,並將每次重新整理失敗的錯誤訊息寫入 [立即] 視窗。 相反地,在 WorkbookConnection 物件上呼叫 Refresh 只會回報一般描述。

Sub RefreshQueryTables()
    Dim lo As ListObject
    For Each lo In ActiveSheet.ListObjects
        If lo.SourceType = xlSrcQuery Then
            On Error Resume Next
            ' lo.QueryTable.WorkbookConnection.Refresh would report only a generic description.
            lo.QueryTable.Refresh BackgroundQuery:=False
            If Err.Number <> 0 Then Debug.Print lo.Name & ": " & Err.Description
            On Error GoTo 0
        End If
    Next lo
End Sub

支援和意見反應

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