Workbook类
Workbook类
表示创建 Excel 电子表格的根对象。
Workbook 类型公开以下成员：
构造函数
| 构造函数 | 描述 |
|---|---|
| init | 初始化 Workbook 类的新实例。 |
| init | 初始化 Workbook 类的新实例。 |
| init | 初始化 Workbook 类的新实例并打开文件。 |
| init | 初始化 Workbook 类的新实例并打开一个流。 |
| init | 初始化 Workbook 类的新实例并打开文件。 |
| init | 初始化 Workbook 类的新实例并打开流。 |
特性
| 属性 | 描述 |
|---|---|
| settings | 代表工作簿设置。 |
| worksheets | 获取电子表格中的 WorksheetCollection 集合。 |
| is_licensed | 指示是否设置了许可证。 |
| colors | 返回电子表格调色板中的颜色。 |
| count_of_styles_in_pool | 获取样式池中的样式数量。 |
| default_style | 获取或设置工作簿的默认 Style 对象。 |
| is_digitally_signed | 指示此电子表格是否经过数字签名。 |
| is_workbook_protected_with_password | 指示结构或窗口是否受密码保护。 |
| vba_project | 获取电子表格中的 Workbook.vba_project。 |
| has_macro | 指示此电子表格是否包含宏/VBA。 |
| has_revisions | 获取工作簿是否有任何跟踪的更改 |
| file_name | 获取和设置当前文件名。 |
| cells_data_table_factory | 获取用于从自定义对象构建 ICellsDataTable 的工厂 |
| data_sorter | 获取 DataSorter 对象以对数据进行排序。 |
| theme | 获取主题名称。 |
| built_in_document_properties | 返回 DocumentProperty 集合，该集合表示电子表格的所有内置文档属性。 |
| custom_document_properties | 返回 DocumentProperty 集合，该集合表示电子表格的所有自定义文档属性。 |
| file_format | 获取和设置文件格式。 |
| interrupt_monitor | 获取和设置中断监视器。 |
| content_type_properties | 获取工作簿中 ContentTypeProperty 对象的列表。 |
| custom_xml_parts | 表示自定义 XML 数据存储部件（包内的自定义 XML 数据）。 |
| data_mashup | 获取混搭数据。 |
| ribbon_xml | 获取和设置定义功能区 UI 的 XML 文件。 |
| absolute_path | 获取和设置文件的绝对路径。 |
| data_connections | 获取 ExternalConnection 集合。 |
方法
| 方法 | 描述 |
|---|---|
| save | 将工作簿保存到磁盘。 |
| save | 将工作簿保存到磁盘。 |
| save | 将工作簿保存到磁盘。 |
| save | 将工作簿保存到流中。 |
| save | 将工作簿保存到流中。 |
| replace | 用新字符串替换单元格的值。 |
| replace | 将单元格的值替换为新整数。 |
| replace | 将单元格的值替换为新的双精度值。 |
| replace | 用新的字符串数组替换单元格的值。 |
| replace | 用整数数组替换单元格的值。 |
| replace | 用双精度数组替换单元格的值。 |
| replace | 用新数据替换单元格的值。 |
| replace | 用新数据替换单元格的值。 |
| replace | 用新字符串替换单元格的值。 |
| copy | 复制另一个 Workbook 对象。 |
| copy | 从源 Workbook 对象复制数据。 |
| calculate_formula | 计算公式的结果。 |
| calculate_formula | 计算公式的结果。 |
| calculate_formula | 计算本工作簿中的公式。 |
| refresh_dynamic_array_formulas | 刷新动态数组公式（根据当前数据溢出到新的相邻单元格范围） 工作簿中的其他公式即使被动态数组公式使用，也不会进行递归计算。 |
| refresh_dynamic_array_formulas | 刷新动态数组公式（根据当前数据溢出到新的相邻单元格范围） |
| import_xml | 将 XML 数据文件导入/更新到工作簿中。 |
| import_xml | 将 XML 数据文件导入/更新到工作簿中。 |
| export_xml | 导出由指定 XML 映射链接的 XML 数据。 |
| export_xml | 导出 XML 数据。 |
| parse_formulas | 解析从模板文件加载或设置到单元格时尚未解析的所有公式。 |
| start_access_cache | 启动使用缓存访问数据的会话。 |
| close_access_cache | 关闭使用缓存访问数据的会话。 |
| remove_unused_styles | 删除所有未使用的样式。 |
| create_style | 创造了新的风格。 |
| create_builtin_style | 按给定类型创建内置样式。 |
| create_cells_color | 创建一个 CellsColor 对象。 |
| combine | 组合另一个 Workbook 对象。 |
| get_style_in_pool | 获取样式池中的样式。 工作簿中的所有样式都将收集到一个池中。 单元格中只有一个简单的参考索引。 |
| get_fonts | 获取样式池中的所有字体。 |
| get_named_style | 获取样式池中指定的样式。 |
| change_palette | 更改指定索引中电子表格的调色板。 |
| is_color_in_palette | 检查某种颜色是否在电子表格的调色板中。 |
| get_matching_color | 在当前调色板中查找最匹配的颜色。 |
| set_encryption_options | 设置加密选项。 |
| protect | 保护工作簿。 |
| protect_shared_workbook | 保护共享工作簿。 |
| unprotect | 取消对工作簿的保护。 |
| unprotect_shared_workbook | 取消对共享工作簿的保护。 |
| remove_macro | 从此电子表格中删除 VBA/宏。 |
| remove_digital_signature | 从此电子表格中删除数字签名。 |
| accept_all_revisions | 接受工作簿中所有跟踪的更改。 |
| remove_external_links | 删除工作簿中的所有外部链接。 |
| get_theme_color | 获取主题颜色。 |
| set_theme_color | 设置主题颜色 |
| custom_theme | 海关主题。 |
| copy_theme | 从另一个工作簿复制主题。 |
| has_exernal_links | 指示此工作簿是否包含指向其他数据源的外部链接。 |
| update_custom_function_definition | 更新自定义函数的定义。 |
| update_linked_data_source | 如果此工作簿包含其他数据源的外部链接， Aspose.Cells 将尝试从给定来源检索最新数据。 |
| set_digital_signature | 为电子表格文件（Excel2007 及更高版本）设置数字签名。 |
| add_digital_signature | 将数字签名添加到 OOXML 电子表格文件（Excel2007 及更高版本）。 |
| get_digital_signature | 从文件中获取数字签名。 |
| remove_personal_information | 删除个人信息。 |
评论
Workbook 类表示 Excel 电子表格。每个电子表格可以包含多个工作表。 该类的基本功能是打开和保存本机 Excel 文件。 该类具有一些高级功能，例如从其他工作簿复制数据、合并两个工作簿、将 Excel 转换为 PDF、将 Excel 渲染为图像以及保护 Excel 电子表格。
例子
以下示例从名为 Designer.xls 的 Excel 文件加载 Workbook 并使水平和垂直滚动条不可见。 然后，它在电子表格中分别用整数值和字符串值替换两个字符串值，最后将工作簿保存为 Excel xlsx 文件。
from aspose.cells import Workbook
# Open a designer file
designerFile = "designer.xls"
workbook = Workbook(designerFile)
# Set scroll bars
workbook.settings.is_h_scroll_bar_visible = False
workbook.settings.is_v_scroll_bar_visible = False
# Replace the placeholder string with new values
newInt = 100
workbook.replace("OldInt", newInt)
newString = "Hello!"
workbook.replace("OldString", newString)
workbook.save("result.xlsx")
