Excel) (WorkbookConnection.Refresh 方法

刷新工作簿连接。

语法

expression.Refresh

表达式 表示 WorkbookConnection 对象的变量。

备注

如果 DisplayAlerts 属性为 False,则不会显示对话框,并且 Refresh 方法将失败,并出现“连接信息不足”异常。

一个连接的刷新失败不会对其他连接的刷新操作产生任何影响。

如果连接将使用 Power Query 创建的查询加载到工作表表中,则会关闭该连接的后台刷新, (其 OLEDBConnection 对象的 BackgroundQuery 属性为 False) ,并且整个查询无法计算 (,例如,由于步骤中的表达error式,或类似Number.FromText的函数在计算步骤值(而不是在单个单元格) 内)失败, Refresh 方法会引发运行时错误 1004,并提供一般描述 (“应用程序定义或对象定义的错误”) 。 不包括查询生成的错误消息。 若要获取查询的错误消息,请使用其 QueryTable 对象的 Refresh 方法刷新表,并禁用后台刷新。 该方法引发相同的错误号,并且其描述包括查询的错误,例如 [Expression.Error] ...。

如果启用后台刷新,则 刷新方法在 刷新完成之前返回,并且刷新期间发生的错误不会返回到调用代码。

查询结果的各个单元格中的错误不会导致刷新失败。 刷新成功,这些单元格留空。

示例

此示例刷新活动工作表上的每个查询表,并将每次失败刷新的错误消息写入“即时”窗口。 改为对 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 支持和反馈,获取有关如何接收支持和提供反馈的指南。