Работа со стилями

Статья
01/21/2025

В этом разделе рассматриваются классы open XML SDK Worksheet, Chartsheetи , а DialogSheet также их связь со схемой SpreadsheetML формата файла Open XML. Дополнительные сведения об общей структуре частей и элементов, составляющих документ SpreadsheetML, см. в разделе Структура документа SpreadsheetML.

Листы в документе SpreadsheetML

В следующей информации из спецификации ISO/IEC 29500 представлен элемент листа (<sheet/>).

Лист это главная структура в рабочей книге, и именно здесь пользователь выполняет большую часть работы с электронной таблицей. Наиболее распространены обычные листы, которые представляют собой сетку из ячеек. Они могут содержать текст, числа, даты и формулы. Ячейки также можно форматировать. Рабочие книги обычно содержат несколько листов. Чтобы упростить анализ данных и обеспечить более взвешенное принятие решений, в приложениях для работы с электронными таблицами часто имеются различные функции и объекты, помогающие вычислять, сортировать, фильтровать, организовывать и графически отображать данные. Поскольку такие функции часто очень тесно связаны с сеткой электронной таблицы, они также включаются в определение листа на диске.

К другим типам листов относятся листы диаграмм и диалоговых окон.

Класс листа open XML SDK

Класс Open XML SDK Worksheet представляет элемент (<worksheet/>), определенный worksheet в схеме формата файла Open XML для документов SpreadsheetML. Используйте класс для Worksheet управления отдельными <worksheet/> элементами в документе SpreadsheetML.

В следующей информации из спецификации ISO/IEC 29500 представлен worksheet элемент (<worksheet/>).

Экземпляр части такого типа содержит все данные, формулы и характеристики, связанные с данным листом.

Пакет содержит в точности одну часть листа для каждого листа.

В частности, атрибут id элемента sheet должен указывать на нужную часть листа.

Корневым элементом для части данного типа содержимого должен быть worksheet.

В следующей выдержке из стандарта ISO/IEC 29500 представляется базовый сценарий использования листа.

Наименьшим возможным листом (пустым) является следующий:

<worksheet>
    <sheetData/>
</worksheet>

Пустая коллекция sheetData представляет собой пустую сетку; этот элемент является обязательным. Как определяется в схеме, некоторые дополнительные коллекции свойств листа могут располагаться до коллекции sheetData, а некоторые после нее. Чтобы упростить вставку новой коллекции sheetData в существующий (но пустой) лист, коллекция sheetData является обязательной, даже когда она пуста.

В обычной электронной таблице имеется по крайней мере один лист. Лист содержит табличную структуру для определения данных, представленную элементом sheetData . Лист, содержащий данные, worksheet использует элемент в качестве корневого элемента для определения листов. Внутри листа данные делятся на три раздела. Первый раздел содержит необязательные свойства листа. Во втором разделе содержатся данные с использованием необходимого sheetData элемента. В третьем разделе находятся необязательные вспомогательные свойства, такие как сведения о защите листа и фильтрации. Чтобы определить пустой лист, достаточно использовать worksheet только элементы и sheetData . Элемент sheetData может быть пустым.

Чтобы создать новые значения для листа, необходимо определить строки внутри sheetData элемента . Эти строки содержат ячейки со значениями. Элемент row определяет новую строку. Обычно первая строка в является sheetData первой строкой на видимом листе. Внутри строки, создаваемой cells с помощью <c/> элемента . Значения для ячеек можно предоставить путем <v/> хранения элемента внутри ячейки. <v/> Обычно элемент содержит текущее значение ячейки листа. Если значение является числовым, оно хранится непосредственно в элементе <v/> в XML-файле. Если значение является строковым, оно хранится в общей таблице строк. Дополнительные сведения об использовании общей таблицы строк для хранения строковых значений см. в разделе Работа с общей строковой таблицей.

В следующей таблице перечислены распространенные классы open XML SDK, используемые при работе с классом Worksheet .

Элемент SpreadsheetML	Класс пакета SDK Open XML
`<sheetData/>`	SheetData
`<row/>`	Row
`<c/>`	Cell
`<v/>`	CellValue

Дополнительные сведения о необязательных элементах электронной таблицы, таких как свойства листа и вспомогательные свойства листа, см. в описании стандарта ISO/IEC 29500.

Класс SheetData

В следующей информации из спецификации ISO/IEC 29500 представлен элемент данных листа (<sheetData/>).

Таблица ячеек является основной структурой листа. Она содержит весь текст, все числа и формулы в сетке.

Класс Row

В следующей информации из спецификации ISO/IEC 29500 представлен элемент row (<row/>).

Ячейки в таблице ячеек организованы по строкам. Каждая строка имеет индекс (атрибут r), поэтому пустые строки не нужно записывать. Каждая строка указывает количество ячеек, определенное для нее, а также их относительное положение на листе. В данном примере первой строкой данных является строка 2.

Класс Cell

В следующей информации из спецификации ISO/IEC 29500 представлен элемент cell (<c/>).

Сама ячейка выражается коллекцией c. Каждая ячейка указывает свое расположение в сетке с помощью эталонной нотации в стиле A1. Ячейка также может указывать идентификатор стиля (атрибуты) и тип данных (атрибут t). К типам ячеек относятся string, number и boolean. Для оптимизации операций загрузки и сохранения значения данных по умолчанию не записываются.

Класс CellValue

В следующей информации из спецификации ISO/IEC 29500 представлен элемент значения ячейки (<v/>).

Ячейки содержат значения, как непосредственно введенные пользователем (например, в ячейке A2 в данном примере содержится значение "External Link:"), так и представляющие собой результат вычисления (например, в ячейке B3 в данном примере содержится формула "B2+1").

Строковые значения ячеек не хранятся в таблице ячеек за исключением случае, когда они являются результатом вычисления. Таким образом, вместо внешнего канала в качестве содержимого v-узла ячейки вы увидите отсчитываемый от нуля индекс в общей строковой таблице, где эта строка хранится уникально. Это делается для оптимизации операций загрузки и сохранения и снижения степени дублирования данных. Чтобы определить, является ли "0" в элементе v числом или индексом для строки, нужно проверить тип данных ячейки. Если ячейка является строковой, то это индекс, а не числовое значение.

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

В следующем примере кода создается документ электронной таблицы с указанным именем файла и создается Worksheet экземпляр класса, а затем добавляется строка и ячейка в таблицу ячеек в позиции A1. Затем ячейке A1 присваивается числовое значение 100.

C#
Visual Basic

static void CreateSpreadsheetWorkbook(string filepath)
{
    // Use 'using' block to ensure proper disposal of the document
    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);

        // Get the sheetData cell table.
        SheetData sheetData = worksheetPart.Worksheet.GetFirstChild<SheetData>() ?? worksheetPart.Worksheet.AppendChild(new SheetData());

        // Add a row to the cell table.
        Row row = new Row() { RowIndex = 1 };
        sheetData.Append(row);

        // In the new row, find the column location to insert a cell in A1.  
        Cell? refCell = null;

        foreach (Cell cell in row.Elements<Cell>())
        {
            if (string.Compare(cell.CellReference?.Value, "A1", true) > 0)
            {
                refCell = cell;
                break;
            }
        }

        // Add the cell to the cell table at A1.
        Cell newCell = new Cell() { CellReference = "A1" };
        row.InsertBefore(newCell, refCell);

        // Set the cell value to be a numeric value of 100.
        newCell.CellValue = new CellValue("100");
        newCell.DataType = new EnumValue<CellValues>(CellValues.Number);
    }
}

Sub CreateSpreadsheetWorkbook(filepath As String)
    ' Use 'Using' block to ensure proper disposal of the document
    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)

        ' Get the sheetData cell table.
        Dim sheetData As SheetData = If(worksheetPart.Worksheet.GetFirstChild(Of SheetData)(), worksheetPart.Worksheet.AppendChild(Of SheetData)(New SheetData()))

        ' Add a row to the cell table.
        Dim row As Row = New Row() With {
            .RowIndex = 1
        }
        sheetData.Append(row)

        ' In the new row, find the column location to insert a cell in A1.  
        Dim refCell As Cell = Nothing

        For Each cell As Cell In row.Elements(Of Cell)()
            If String.Compare(cell.CellReference?.Value, "A1", True) > 0 Then
                refCell = cell
                Exit For
            End If
        Next

        ' Add the cell to the cell table at A1.
        Dim newCell As Cell = New Cell() With {
            .CellReference = "A1"
        }
        row.InsertBefore(newCell, refCell)

        ' Set the cell value to be a numeric value of 100.
        newCell.CellValue = New CellValue("100")
        newCell.DataType = New EnumValue(Of CellValues)(CellValues.Number)
    End Using
End Sub

Созданный код SpreadsheetML

При выполнении кода Open XML SDK в документ SpreadsheetML, указанный в коде, записывается следующий XML-код. Для его просмотра откройте файл "sheet.xml" в папке "worksheets" ZIP-файла.

    <?xml version="1.0" encoding="utf-8"?>
    <x:worksheet xmlns:x="http://schemas.openxmlformats.org/spreadsheetml/2006/main">
        <x:sheetData>
            <x:row r="1">
                <x:c r="A1" t="n">
                    <x:v>100</x:v>
                </x:c>
            </x:row>
        </x:sheetData>
    </x:worksheet>

Класс Chartsheet в пакете Open XML SDK

В следующей информации из спецификации ISO/IEC 29500 представлен элемент chartsheet (<chartsheet/>).

Экземпляр части этого типа представляет собой диаграмму, которая хранится на отдельном листе.

В пакете может быть любое количество частей Chartsheet или они могут отсутствовать.

Пример: sheet1.xml ссылается на рисунок, который является объектом отношения в элементе части Chartsheet:

<chartsheet xmlns:r="…" …>
    <sheetViews>
        <sheetView scale="64"/>
    </sheetViews\>
    <drawing r:id="rId1">
</chartsheet>

В следующей таблице перечислены распространенные классы open XML SDK, используемые при работе с классом Chartsheet .

Элемент SpreadsheetML	Класс пакета SDK Open XML
`<drawing/>`	Drawing

Класс Drawing

В следующей информации из спецификации ISO/IEC 29500 представлен элемент drawings (<wsDr/>).

Экземпляр части данного типа содержит представление и данные о расположении для одного или нескольких элементов drawing, находящихся на этом листе.

В пакете может быть любое количество частей Drawings или они могут отсутствовать, при этом каждая такая часть должна быть целевым объектом явного отношения между частью Worksheet (§12.3.24) или частью Chartsheet (§12.3.2). Для каждого простого листа или листа диаграмм может быть только одна часть Drawings.

Класс dialogsheet Open XML SDK

В следующей информации из спецификации ISO/IEC 29500 представлен элемент dialogsheet (<dialogsheet/>).

Экземпляр части этого типа содержит сведения из устаревшего настраиваемого диалогового окна для пользовательской формы.

В пакете может быть любое количество частей Dialogsheet или они могут отсутствовать

Корневым элементом для части этого типа контента будет dialogsheet.

Пример: sheet1.xml содержит следующий код:

<dialogsheet xmlns:r="…" …>
    <sheetPr>
        <pageSetUpPr/>
    </sheetPr>
    <sheetViews>
        …
    </sheetViews>
    …
    <legacyDrawing r:id="rId1"/>
</dialogsheet>

Поделиться через