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Получает и задает 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.

Пример

В следующем примере загружается Workbook из файла Excel с именем Designer.xls и делается невидимыми горизонтальная и вертикальная полосы прокрутки. Затем он заменяет два строковых значения целочисленным значением и строковым значением соответственно в электронной таблице и, наконец, сохраняет книгу как файл 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")

Смотрите также