Workbook类

Workbook类

表示用于创建 Excel 电子表格的根对象。

Workbook 类型公开了以下成员：

构造器

构造器 描述
Workbook() 初始化 Workbook 类的新实例。
Workbook(file_format_type) 初始化 Workbook 类的新实例。
Workbook(file) 初始化 Workbook 类的新实例并打开一个文件。
Workbook(stream) 初始化 Workbook 类的新实例并打开流。
Workbook(file, load_options) 初始化 Workbook 类的新实例并打开一个文件。
Workbook(stream, load_options) 初始化 Workbook 类的新实例并打开流。

特性

属性 描述
settings 表示工作簿设置。
worksheets 获取电子表格中的 WorksheetCollection 集合。
is_licensed 是否设置了license。
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(file_name, save_format) 将工作簿保存到磁盘。
save(file_name) 将工作簿保存到磁盘。
save(file_name, save_options) 将工作簿保存到磁盘。
save(stream, save_format) 将工作簿保存到流中。
save(stream, save_options) 将工作簿保存到流中。
replace(place_holder, new_value) 用新字符串替换单元格的值。
replace(place_holder, new_value) 用新整数替换单元格的值。
replace(place_holder, new_value) 用新的双精度替换单元格的值。
replace(place_holder, new_values, is_vertical) 用新的字符串数组替换单元格的值。
replace(place_holder, new_values, is_vertical) 用整数数组替换单元格的值。
replace(place_holder, new_values, is_vertical) 用双精度数组替换单元格的值。
replace(bool_value, new_value) 用新数据替换单元格的值。
replace(int_value, new_value) 用新数据替换单元格的值。
replace(place_holder, new_value, options) 用新字符串替换单元格的值。
copy(source, copy_options) 从源工作簿对象复制数据。
copy(source) 从源工作簿对象复制数据。
calculate_formula() 计算公式的结果。
calculate_formula(ignore_error) 计算公式的结果。
calculate_formula(ignore_error, custom_function) 计算公式的结果。
calculate_formula(options) 计算本工作簿中的公式。
refresh_dynamic_array_formulas(calculate) 刷新动态数组公式（根据当前数据溢出到相邻单元格的新范围）
工作簿中的其他公式即使被动态数组公式使用也不会递归计算。
refresh_dynamic_array_formulas(calculate, copts) 刷新动态数组公式（根据当前数据溢出到相邻单元格的新范围）
import_xml(url, sheet_name, row, col) 将 XML 数据文件导入/更新到工作簿中。
import_xml(stream, sheet_name, row, col) 将 XML 数据文件导入/更新到工作簿中。
export_xml(map_name, path) 导出由指定 XML 映射链接的 XML 数据。
export_xml(map_name, stream) 导出 XML 数据。
parse_formulas(ignore_error) 解析所有从模板文件加载或设置到单元格时尚未解析的公式。
start_access_cache(opts) 启动使用缓存访问数据的会话。
close_access_cache(opts) 关闭使用缓存访问数据的会话。
remove_unused_styles() 删除所有未使用的样式。
create_style() 创建一个新的样式。
create_builtin_style(type) 按给定类型创建内置样式。
create_cells_color() 创建一个 CellsColor 对象。
combine(second_workbook) 合并另一个 Workbook 对象。
get_style_in_pool(index) 获取样式池中的样式。
工作簿中的所有样式都将汇集到一个池中。
单元格中只有一个简单的参考索引。
get_fonts() 获取样式池中的所有字体。
get_named_style(name) 获取样式池中的命名样式。
change_palette(color, index) 更改指定索引中电子表格的调色板。
is_color_in_palette(color) 检查颜色是否在电子表格的调色板中。
get_matching_color(raw_color) 在当前调色板中找到最匹配的颜色。
set_encryption_options(encryption_type, key_length) 设置加密选项。
protect(protection_type, password) 保护工作簿。
protect_shared_workbook(password) 保护共享工作簿。
unprotect(password) 取消保护工作簿。
unprotect_shared_workbook(password) 取消保护共享工作簿。
remove_macro() 从此电子表格中删除 VBA/宏。
remove_digital_signature() 从此电子表格中删除数字签名。
accept_all_revisions() 接受工作簿中的所有修订。
remove_external_links() 删除工作簿中的所有外部链接。
get_theme_color(type) 获取主题颜色。
set_theme_color(type, color) 设置主题颜色
custom_theme(theme_name, colors) 海关主题。
copy_theme(source) 从另一个工作簿复制主题。
has_exernal_links() 指示此工作簿是否包含指向其他数据源的外部链接。
update_linked_data_source(external_workbooks) 如果此工作簿包含指向其他数据源的外部链接，
Aspose.Cells 将尝试检索最新数据。
set_digital_signature(digital_signature_collection) 将数字签名设置为电子表格文件（Excel2007 及更高版本）。
add_digital_signature(digital_signature_collection) 向 OOXML 电子表格文件（Excel2007 及更高版本）添加数字签名。
get_digital_signature() 从文件中获取数字签名。
remove_personal_information() 删除个人信息。

评论

Workbook 类表示 Excel 电子表格。每个电子表格可以包含多个工作表。 该类的基本功能是打开和保存本机 excel 文件。 该类具有一些高级功能，如从其他工作簿复制数据、合并两个工作簿和保护 Excel 电子表格。

例子

以下示例从名为 designer.xls 的文件中加载 Workbook，并使 Workbook 的水平和垂直滚动条不可见。然后在电子表格中分别用整数值和字符串值替换两个字符串值，最后将更新后的文件发送到客户端浏览器。

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.xls")

也可以看看

WarningInfo类 WorkbookDesigner类