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 Указывает, установлена ли лицензия.
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 Получает и задает 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) Копирует данные из исходного объекта Workbook.
copy(source) Копирует данные из исходного объекта Workbook.
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.

Пример

Следующий пример загружает Workbook из файла с именем Designer.xls и делает горизонтальную и вертикальную полосы прокрутки невидимыми для 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 класс