QueryTable.Refresh 方法 (Excel)

更新QueryTable物件中的外部資料範圍。

語法

運算式。重新整理 (BackgroundQuery)

表達 代表 QueryTable 物件的變數。

參數

名稱	必要/選用	資料類型	描述
BackgroundQuery	選用	Variant	只能與根據 SQL 查詢結果所建立的 QueryTables 一起使用。 如果為 True，則會在建立資料庫連接並送出查詢之後，立即將對程序的控制權交還給使用者。 QueryTable 會在背景進行更新。 如果為 False ，則只有在已將所有資料都擷取到工作表之後，才會將對程序的控制權交還給使用者。 如果未指定此引數，則 BackgroundQuery 屬性的設定會決定查詢模式。

傳回值

布林值

註解

下列備註適用於根據 SQL 查詢結果所建立的 QueryTable 物件。

Refresh 方法會使 Microsoft Excel 連接到 QueryTable 物件的資料來源、執行 SQL 查詢，並將資料傳回到以 QueryTable 物件為根據的範圍。 必須呼叫此方法之後，QueryTable 物件才能與資料來源進行通訊。

建立 OLE DB 或 ODBC 資料來源的連接時，Microsoft Excel 會使用 Connection 屬性所指定的連接字串。 如果指定的連接字串缺少必要的值，將會顯示對話方塊，提示使用者輸入必要的資訊。 如果 DisplayAlerts 屬性為 False ，則不會顯示對話方塊，而且 Refresh 方法會失敗並產生「連接資訊不足」的例外狀況。

Microsoft Excel 在成功建立連接之後，會儲存完成的連接字串，如此一來，如果在同一個編輯工作階段中後續呼叫 Refresh 方法，將不會再提示使用者輸入資訊。 您可以檢查 Connection 屬性的值，即可取得完成的連接字串。

在建立資料庫連接之後，會驗證 SQL 查詢的有效性。 如果該查詢無效，則 Refresh 方法會失敗並產生「SQL 語法錯誤」的例外狀況。

如果查詢需要參數，則必須先使用參數系結資訊初始化 Parameters 集合，才能呼叫 Refresh 方法。 如果沒有繫結足夠的參數，則 Refresh 方法會失敗並產生「參數錯誤」的例外狀況。 如果已將參數設定為提示使用者輸入參數值，則不論 DisplayAlerts 屬性的設定為何，都會顯示對話方塊。 如果使用者取消參數對話方塊，則 Refresh 方法會中斷並傳回 False 。 如果 Parameters 集合繫結了多餘的參數，則會忽略這些多餘的參數。

如果已成功地完成或啟動查詢，則 Refresh 方法會傳回 True。如果使用者取消連接或參數對話方塊，則會傳回 False。

若要查看擷取的資料列數目是否超過工作表上可用的資料列數目，請檢查 FetchedRowOverflow 屬性。 每次呼叫 Refresh 方法時，都會初始化這個屬性。

支援和意見反應

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