_QueryTable.Refresh(Object) 方法

定义

命名空间:

Microsoft.Office.Interop.Excel

程序集:

Microsoft.Office.Interop.Excel.dll

汇报外部数据范围 (QueryTable) 。 Boolean 类型的值 。

public bool Refresh (object BackgroundQuery);

Public Function Refresh (Optional BackgroundQuery As Object) As Boolean

参数

BackgroundQuery

Object

可选 对象。 只用于基于 SQL 查询结果的 QueryTables。 如果为 True，则在数据库建立连接并提交查询之后，将控制返回给过程。 QueryTable 在后台进行更新。 如果为 False，则在所有数据被取回到工作表之后，将控制返回给过程。 如果未指定此参数，则 属性的设置 BackgroundQuery 将确定查询模式。

返回

Boolean

注解

下列说明适用于基于 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 方法之前，该属性都将被初始化。