Refresh 方法

更新查询表。Boolean 类型。

expression   必需。该表达式返回上述对象之一。

BackgroundQuery   Variant 类型，可选。只用于基于 SQL 查询结果的查询表。如果该值为 True，则在数据库建立连接并提交查询时返回控制（查询在后台更新）。如果该值为 False，则在所有数据被取回到工作表中时将控制返回到过程。如果没有指定该参数的值，则 BackgroundQuery 属性的设置将决定查询模式。

 

更新图表和数据透视表高速缓存。

expression   必需。该表达式返回上述对象之一。对于 PivotCache 对象，该高速缓存必须至少有一个数据透视表与之相关联。

下列说明应用于基于 SQL 查询结果的 QueryTable 对象。

Refresh 方法使 Microsoft Excel 连接到查询表的数据源，执行 SQL 查询，并将数据返回至查询表目标区域。仅当调用该方法后，查询表才会与数据源进行通信。

当建立对 OLE DB 或 ODBC 数据源的连接时，Microsoft Excel 使用由 Connection 属性指定的连接字符串。如果指定的连接字符串缺少必需的值，则数据访问驱动程序管理器或该驱动程序（或两者）将显示模态对话框以提示用户输入必需的信息。如果 DisplayAlerts 属性值为False，则不显示对话框，而且 Refresh 方法将由于“连接信息不足”异常而失效。

在 Microsoft Excel 建立一个成功的连接之后，将保存完整的连接字符串，这样，在同一编辑会话中以后调用 Refresh 方法时就不会显示提示。通过检验 Connection 属性的值，可以取得完整的连接字符串。

完成数据库连接后，将检查 SQL 查询的有效性。如果该查询无效，Refresh 方法将失效并导致“SQL 语法错误”异常。

如果查询需要参数，则必须用参数绑定信息初始化 Parameters 集合。若未绑定足够参数，Refresh 方法失效并导致“参数错误”异常。如果把参数设置为提示用户指定，则无论 DisplayAlerts 如何设置，都将对话框显示给用户。如果用户取消一个参数对话框，则 Refresh 方法停止，并且该值为 False。如果向 Parameters 集合绑定了多余的参数，则忽略多余的参数。

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

检测 FetchedRowOverflow 属性以判断取得的数据行数是否超出了工作表的可用行数。每次调用 Refresh 方法之前，该属性都将初始化。