Workbooks.Open 方法 (Excel)
打开一个工作簿。
注意
有兴趣开发跨多个平台扩展 Office 体验的解决方案吗? 查看新的 Office 外接程序模型。 与VSTO外接程序和解决方案相比,Office外接程序占用的空间较小,您可以使用几乎任何Web编程技术(例如HTML5,JavaScript,CSS3和XML)来构建它们。
语法
表达式。打开 (FileName、 UpdateLinks、 ReadOnly、 Format、 Password、 WriteResPassword、 IgnoreReadOnlyRecommended、 Origin、 Delimiter、 Editable、 Notify、 Converter、 AddToMru、 Local、 CorruptLoad)
表达 一个代表 Workbooks 对象的变量。
参数
名称 | 必需/可选 | 数据类型 | 说明 |
---|---|---|---|
FileName | 可选 | Variant | String。 要打开的工作簿的文件名。 |
UpdateLinks | 可选 | Variant | 指定外部引用 (链接) 在文件中的更新方式,例如对以下公式 =SUM([Budget.xls]Annual!C10:C25) 中Budget.xls工作簿中的区域的引用。 如果省略此参数,则会提示用户指定链接的更新方式。 有关此参数使用的值的详细信息,请参阅“备注”部分。如果 Microsoft Excel 以 WKS、WK1 或 WK3 格式打开文件,并且 UpdateLinks 参数为 0,则不会创建图表;否则,Microsoft Excel 会从附加到该文件的图形中生成图表。 |
ReadOnly | 可选 | Variant | 如果为 True,则以只读模式打开工作簿。 |
Format | 可选 | Variant | 如果 Microsoft Excel 打开文本文件,则此参数指定分隔符字符。 如果省略此参数,则使用当前分隔符。 有关此参数使用的值的详细信息,请参阅“备注”部分。 |
Password | 可选 | Variant | 包含打开受保护工作簿所需密码的字符串。 如果省略此参数并且工作簿需要密码,则会提示用户输入密码。 |
WriteResPassword | 可选 | Variant | 包含写入写保护的工作簿所需密码的字符串。 如果省略此参数并且工作簿需要密码,则将提示用户输入密码。 |
IgnoreReadOnlyRecommended | 可选 | Variant | 如果为 True,则不让 Microsoft Excel 显示只读的建议消息(如果该工作簿以建议只读选项保存)。 |
Origin | 可选 | Variant | 如果文件是文本文件,则此参数表示其来源,这样就可正确映射代码页和回车/换行 (CR/LF)。 可以是以下 XlPlatform 常量之一: xlMacintosh、 xlWindows 或 xlMSDOS。 如果省略此参数,则使用当前操作系统。 |
Delimiter | 可选 | Variant | 如果文件是文本文件且 Format 参数为 6,则此参数是指定要用作分隔符的字符的字符串。 例如,可使用 Chr(9) 代表制表符,使用“,”代表逗号,使用“;”代表分号,或者使用自定义字符。 只使用字符串的第一个字符。 |
Editable | 可选 | Variant | 如果文件为 Microsoft Excel 4.0 外接程序,则此参数为 True 时可打开该外接程序以使其成为可见窗口。 如果此参数为 False 或被省略,则以隐藏方式打开外接程序,并且无法设为可见。 此选项不适用于在 Microsoft Excel 5.0 或更高版本中创建的加载项。 如果文件是 Excel 模板,则为 True,可打开指定的模板进行编辑。 如果为 False,则可根据指定的模板打开新工作簿。 The default value is False. |
Notify | 可选 | Variant | 当文件不能以可读写模式打开时,如果此参数为 True,则可将该文件添加到文件通知列表。 Microsoft Excel 将以只读模式打开该文件并轮询文件通知列表,并在文件可用时向用户发出通知。 如果此参数为 False 或省略,则不会请求通知,并且任何打开不可用文件的尝试都将失败。 |
Converter | 可选 | Variant | 打开文件时要尝试的第一个文件转换器的索引。 首先尝试指定的文件转换器;如果此转换器无法识别该文件,则尝试所有其他转换器。 转换器索引由 FileConverters 属性返回的转换器的行号组成。 |
AddToMru | 可选 | Variant | 如果为 True,则将该工作簿添加到最近使用的文件列表中。 默认值为 False 。 |
Local | 可选 | Variant | 如果为 True,则以 Microsoft Excel(包括控制面板设置)的语言保存文件。 如果为 False(默认值),则以 Visual Basic for Applications (VBA) 的语言保存文件,其中 Visual Basic for Applications (VBA) 通常为美国英语版本,除非从中运行 Workbooks.Open 的 VBA 项目是旧的已国际化的 XL5/95 VBA 项目。 |
CorruptLoad | 可选 | XlCorruptLoad | 可为以下常量之一:xlNormalLoad、xlRepairFile 和 xlExtractData。 如果未指定值,则默认行为为 xlNormalLoad,并且不会在通过 OM 启动时尝试恢复。 |
返回值
表示打开的工作簿的 Workbook 对象。
备注
默认情况下,以编程方式打开文件时将启用宏。 使用 AutomationSecurity 属性可设置以编程方式打开文件时使用的宏安全模式。
可以在 UpdateLinks 参数中指定以下值之一,以确定在打开工作簿时是否更新外部引用 (链接) 。
值 | 说明 |
---|---|
0 | 工作簿打开时不更新外部引用(链接)。 |
3 | 工作簿打开时更新外部引用(链接)。 |
可以在 Format 参数中指定以下值之一,以确定文件的分隔符字符。
值 | Delimiter |
---|---|
1 | 标签 |
2 | 逗号 |
3 | 空格 |
4 | 分号 |
5 | Nothing |
6 | 自定义字符(请参阅 Delimiter 参数) |
示例
以下代码示例打开 Analysis.xls 工作簿,然后运行 Auto_Open 宏。
Workbooks.Open "ANALYSIS.XLS"
ActiveWorkbook.RunAutoMacros xlAutoOpen
以下代码示例会将其他工作簿中的工作表导入当前工作簿的新工作表中。 当前工作簿中的 Sheet1 必须包含单元格 D3 中要导入的工作簿的路径名称、单元格 D4 中的文件名和单元格 D5 中的工作表名称。 在当前工作簿中将导入的工作表插入到 Sheet1 之后。
Sub ImportWorksheet()
' This macro will import a file into this workbook
Sheets("Sheet1").Select
PathName = Range("D3").Value
Filename = Range("D4").Value
TabName = Range("D5").Value
ControlFile = ActiveWorkbook.Name
Workbooks.Open Filename:=PathName & Filename
ActiveSheet.Name = TabName
Sheets(TabName).Copy After:=Workbooks(ControlFile).Sheets(1)
Windows(Filename).Activate
ActiveWorkbook.Close SaveChanges:=False
Windows(ControlFile).Activate
End Sub
支持和反馈
有关于 Office VBA 或本文档的疑问或反馈? 请参阅 Office VBA 支持和反馈,获取有关如何接收支持和提供反馈的指南。