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 语法错误”异常。

如果查询需要参数，则必须在调用 Refresh 方法之前使用参数绑定信息初始化 Parameters 集合。 如果未绑定足够的参数，Refresh 方法将失败并导致“参数错误”异常。 如果参数设置为提示输入其值，则无论 DisplayAlerts 属性的设置如何，都会向用户显示对话框。 如果用户取消参数对话框，Refresh 将停止并返回 False。 如果额外参数与 Parameters 集合绑定，则忽略这些额外参数。

如果成功地完成或启动查询，则 Refresh 方法返回 True；如果用户取消连接或参数对话框，该方法返回 False。

若要查看提取的行数是否超过了工作表上的可用行数，请检查 FetchedRowOverflow 属性。 每次调用 Refresh 方法之前，该属性都将被初始化。

支持和反馈

有关于 Office VBA 或本文档的疑问或反馈？ 请参阅 Office VBA 支持和反馈，获取有关如何接收支持和提供反馈的指南。