會重新整理活頁簿連線。
語法
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 支援與意見反應。