Excel) (Application.Run 方法

运行一个宏或者调用一个函数。 该方法可用于运行用 Visual Basic 或 Microsoft Excel 宏语言编写的宏,或者运行 DLL 或 XLL 中的函数。

语法

表达式。运行 (宏, arg1, arg2, arg3, arg4, arg5, arg6, arg7, arg8, arg9, arg10, arg11, arg12, arg13, arg14, arg15, arg16, arg17, arg18, arg19, arg20, arg21, arg22, arg23, arg24, arg25, arg26, arg27, arg28, arg29, arg30)

expression:表示 Application 对象的变量。

参数

名称 必需/可选 数据类型 说明
宏 可选 Variant 要运行的宏。

这可以是包含宏名称的字符串、指示函数所在位置的 Range 对象,或已注册 DLL (XLL) 函数的寄存器 ID。

如果使用字符串,将在当前工作表的上下文中对该字符串求值。
arg1–arg30 可选 Variant 应传递给函数的参数。

返回值

Variant

备注

不能对此方法使用命名参数。 参数必须按位置传递。

Run 方法返回被调用的宏返回的任何值。

错误处理

如果调用的宏引发了它无法处理 (运行时错误,例如 Err.Raise 方法引发的错误或除以零的) ,则该错误不会传递到调用 Run 的过程。 Excel 会显示运行时错误对话框,即使调用过程已启用错误处理程序设置为“ 发生错误时转到”。 即使 Excel 不可见,也会显示该对话框,因此无人参与的代码会停止,直到有人响应它。 如果用户选择 “结束”,所有正在运行的宏都会停止,包括调用过程。 通过自动化调用 Run 时,客户端将收到一般错误,而不是原始错误编号和描述。

Run 方法本身引发的错误(例如,找不到指定宏时发生的错误)将传递到调用过程,并可由其错误处理程序进行处理。

与普通过程调用一样,被调用宏中的 End 语句将停止所有正在运行的宏,包括调用过程,因此不会执行 Run 后的语句。 模块级变量将重置,包括包含被调用宏的工作簿和调用过程的工作簿中的变量。

被调用的宏对 ByRef 参数所做的更改不会返回到调用过程。 若要向调用方报告失败,请处理被调用的宏中的错误并返回指示成功或失败的值,如以下示例所示。

示例

在此示例中,Tools.xlsm 工作簿中的 ImportData 函数会处理自己的错误,如果失败,则返回 False 。 调用过程在另一个工作簿中检查返回值,而不是依赖于其自己的错误处理程序。 调用 Run 时,Tools.xlsm 必须打开。

' In Tools.xlsm. Called through Application.Run
Public Function ImportData(ByVal filePath As String) As Boolean
    On Error GoTo ErrorHandler
    Workbooks.Open filePath
    ' ... process the data ...
    ImportData = True
    Exit Function
ErrorHandler:
    Debug.Print "ImportData failed: " & Err.Number & " " & Err.Description
    ImportData = False
End Function

' In the calling workbook
Sub CallImportData()
    If Not Application.Run("'Tools.xlsm'!ImportData", "C:\Data\input.xlsx") Then
        MsgBox "The import failed."
    End If
End Sub

支持和反馈

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