Структура документа SpreadsheetML

Структура SpreadsheetML документа состоит из <workbook/> элемента, содержащего <sheets/> элементы и <sheet/> ссылающиеся на листы в книге. Для каждого листа создается отдельный XML-файл. Это минимальные обязательные элементы для допустимого документа электронной таблицы. Кроме того, документ электронной таблицы может содержать <table/>, <chartsheet/>, <pivotTableDefinition/>или другие элементы, связанные с электронной таблицей.

Примечание.

Хотите создавать решения, которые расширяют возможности Office на разнообразных платформах? Ознакомьтесь с новой моделью надстроек Office. Надстройки Office занимают меньше места по сравнению с надстройками и решениями VSTO, и вы можете создавать их, используя практически любую технологию веб-программирования, например HTML5, JavaScript, CSS3 и XML.

---

Важные части электронных таблиц

С помощью пакета SDK Open XML для Office можно создать структуру документа и содержимое, в котором используются строго типизированные классы, соответствующие SpreadsheetML элементам. Эти классы можно найти в DocumentFormat.OpenXML.Spreadsheet пространстве имен. В следующей таблице перечислены имена классов, соответствующие некоторым важным элементам электронной таблицы.

Часть пакета	Элемент SpreadsheetML верхнего уровня	Класс пакета SDK Open XML	Описание
Книга	<workbook/>	Workbook	Корневой элемент основной части документа.
Лист	<worksheet/>	Worksheet	Тип листа, представляющий таблицу ячеек, которая содержит текст, числа, даты и формулы. Дополнительные сведения см. в разделе Работа с листами.
Лист диаграммы	<chartsheet/>	Chartsheet	Лист, представляющий диаграмму, которая хранится в отдельном листе. Дополнительные сведения см. в разделе Работа с листами.
Таблица	<table/>	Table	Логическая конструкция, которая определяет диапазон данных, принадлежащий одному набору данных. Дополнительные сведения см. в статье Работа с таблицами SpreadsheetML.
Сводная таблица	<pivotTableDefinition/>	PivotTableDefinition	Логическая конструкция, отображающая объединенное представление данных в понятном формате. Дополнительные сведения см. в статье Working with PivotTables.
Сводный кэш	<pivotCacheDefinition/>	PivotCacheDefinition	Конструкция, определяющая источник данных в сводной таблице. Дополнительные сведения см. в статье Working with PivotTables.
Записи сводного кэша	<pivotCacheRecords/>	PivotCacheRecords	Кэш исходных данных сводной таблицы. Дополнительные сведения см. в разделе Working with PivotTables.
Цепочка вычислений	<calcChain/>	CalculationChain	Конструкция, указывающая порядок вычислений ячеек в книге в последний раз. Дополнительные сведения см. в разделе Работа с цепочкой вычислений.
Общая строковая таблица	<sst/>	SharedStringTable	Конструкция, которая содержит один экземпляр каждой уникальной строки во всех листах книги. Дополнительные сведения см. в разделе Работа с общей таблицей строк.
Условное форматирование	<conditionalFormatting/>	ConditionalFormatting	Конструкция, определяющая формат, который применяется к ячейке или последовательности ячеек. Дополнительные сведения см. в статье Работа с условным форматированием.
Формулы	<f/>	CellFormula	Конструкция, определяющая текст формулы для ячейки с формулой. Дополнительные сведения см. в разделе Работа с формулами.

---

Простейший случай книги

В приведенном ниже тексте из стандарта ECMA-376 представлен простейший случай книги.

Самая маленькая (пустая) книга должна содержать следующие элементы:

один лист;

идентификатор листа;

идентификатор связи, указывающий на расположение определения листа.

© Ecma International: декабрь 2006 г.

Пример кода Open XML SDK

В этом примере кода классы в пакете SDK Open XML используются для создания минимальной пустой книги.

C#

static void CreateSpreadsheetWorkbook(string filepath)
{
    // Create a spreadsheet document by supplying the filepath.
    // By default, AutoSave = true, Editable = true, and Type = xlsx.
    using (SpreadsheetDocument spreadsheetDocument = SpreadsheetDocument.Create(filepath, SpreadsheetDocumentType.Workbook))
    {
        // Add a WorkbookPart to the document.
        WorkbookPart workbookPart = spreadsheetDocument.AddWorkbookPart();
        workbookPart.Workbook = new Workbook();

        // Add a WorksheetPart to the WorkbookPart.
        WorksheetPart worksheetPart = workbookPart.AddNewPart<WorksheetPart>();
        worksheetPart.Worksheet = new Worksheet(new SheetData());

        // Add Sheets to the Workbook.
        Sheets sheets = workbookPart.Workbook.AppendChild(new Sheets());

        // Append a new worksheet and associate it with the workbook.
        Sheet sheet = new Sheet() { Id = workbookPart.GetIdOfPart(worksheetPart), SheetId = 1, Name = "mySheet" };
        sheets.Append(sheet);
    }
}

Visual Basic

Sub CreateSpreadsheetWorkbook(filepath As String)
    ' Create a spreadsheet document by supplying the filepath.
    ' By default, AutoSave = true, Editable = true, and Type = xlsx.
    Using spreadsheetDocument As SpreadsheetDocument = SpreadsheetDocument.Create(filepath, SpreadsheetDocumentType.Workbook)
        ' Add a WorkbookPart to the document.
        Dim workbookPart As WorkbookPart = spreadsheetDocument.AddWorkbookPart()
        workbookPart.Workbook = New Workbook()

        ' Add a WorksheetPart to the WorkbookPart.
        Dim worksheetPart As WorksheetPart = workbookPart.AddNewPart(Of WorksheetPart)()
        worksheetPart.Worksheet = New Worksheet(New SheetData())

        ' Add Sheets to the Workbook.
        Dim sheets As Sheets = workbookPart.Workbook.AppendChild(Of Sheets)(New Sheets())

        ' Append a new worksheet and associate it with the workbook.
        Dim sheet As Sheet = New Sheet() With {
            .Id = workbookPart.GetIdOfPart(worksheetPart),
            .SheetId = 1,
            .Name = "mySheet"
        }
        sheets.Append(sheet)
    End Using
End Sub

Созданный документ SpreadsheetML

После запуска кода пакета SDK Open XML для создания минимальной книги можно просмотреть содержимое пакета .zip, чтобы просмотреть XML-код SpreadsheetML. Для этого переименуйте расширение электронной таблицы минимальной структурой с .xlsx на .zip. ZIP-пакет содержит несколько частей, из которых состоит книга с минимальной структурой.

На приведенном ниже рисунке показана структура папки xl из ZIP-пакета простейшей книги.

Рис. 1. структура папок .zip

Файл workbook.xml содержит <sheet/> элементы, ссылающиеся на листы в книге. Каждый лист связан с книгой с помощью идентификатора листа и идентификатора отношения. — sheetID это идентификатор, используемый в пакете для идентификации листа и должен быть уникальным в книге. — id это идентификатор связи, определяющий определение части листа, связанное с листом.

Следующий XML-код — код документа SpreadsheetML, представляющий часть книги в электронной таблице. Этот код создается при запуске кода пакета SDK Open XML для создания минимальной книги.

    <?xml version="1.0" encoding="utf-8"?>
    <x:workbook xmlns:x="http://schemas.openxmlformats.org/spreadsheetml/2006/main">
        <x:sheets>
            <x:sheet name="mySheet" sheetId="1" r:id="Rddc7711f116045e5" xmlns:r="http://schemas.openxmlformats.org/officeDocument/2006/relationships" />
        </x:sheets>
    </x:workbook>

Файл workbook.xml.rels содержит <Relationship/> элементы, определяющие связи между книгой и содержащимися в ней листами.

Следующий XML-код — код документа SpreadsheetML, представляющий часть связей в электронной таблице. Этот код создается при запуске пакета SDK Open XML для создания минимальной книги.

    <?xml version="1.0" encoding="utf-8"?>
    <Relationships xmlns="http://schemas.openxmlformats.org/package/2006/relationships">
        <Relationship Type="https://schemas.openxmlformats.org/officeDocument/2006/relationships/worksheet" Target="/xl/worksheets/sheet.xml" Id="Rddc7711f116045e5" />
    </Relationships>

Файл sheet.xml содержит <sheetData/> элемент, представляющий таблицу ячеек. В этом примере книга пуста, поэтому <sheetData/> элемент пуст. Дополнительные сведения о листах см. в разделе Работа с листами.

Следующий XML-код — код документа SpreadsheetML, представляющий часть книги в электронной таблице. Этот код создается при запуске пакета SDK Open XML для создания минимальной книги.

    <?xml version="1.0" encoding="utf-8"?>
    <x:worksheet xmlns:x="http://schemas.openxmlformats.org/spreadsheetml/2006/main">
        <x:sheetData />
    </x:worksheet>

Типичный случай книги

Типичная книга отличается от пустой книги с минимальной структурой. Она может содержать числа, текст, диаграммы, таблицы и сводные таблицы. Каждая из дополнительных частей размещена в ZIP-пакете электронной таблицы.

На следующем рисунке показаны основные элементы типичной электронной таблицы.

Рис. 2. Типичные элементы электронной таблицы