Estrutura de um documento SpreadsheetML

A estrutura do documento de um documento SpreadsheetML consiste no < elemento da pasta> de trabalho que contém <planilhas> e < elementos de planilha> que fazem referência às planilhas na pasta de trabalho. Um arquivo XML separado é criado para cada planilha. Esses elementos são os elementos mínimos necessários para um documento de planilha válido. Além disso, um documento de planilha pode conter <tabela>, <planilha>, <tabela dinâmicaTableDefinition> ou outros elementos relacionados à planilha.

Observação

Interessado em desenvolver soluções que ampliem a experiência do Office em várias plataformas? Confira o novo modelo de Suplementos do Office. Os suplementos do Office ocupam um pequeno espaço em comparação com os suplementos e as soluções do VSTO, e você pode criá-los usando quase qualquer tecnologia de programação da Web, como o HTML5, JavaScript, CSS3 e XML.

---

Partes importantes da planilha

Usando o SDK do Open XML para Office, você pode criar estrutura de documentos e conteúdo que usa classes fortemente tipdas que correspondem a elementos De planilha . Você pode encontrar essas classes no namespace DocumentFormat.OpenXML.Spreadsheet. A tabela a seguir lista os nomes de classe das classes que correspondem a alguns dos elementos importantes da planilha.

Parte do pacote	Elemento SpreadsheetML de nível superior	Classe SDK Open XML	Descrição
Pasta de Trabalho	pasta de trabalho	Pasta de trabalho	O elemento raiz para a parte do documento principal.
Worksheet	planilha	Planilha	Um tipo de planilha que representa uma grade de células que contém texto, números, datas ou fórmulas. Para obter mais informações, consulte Trabalhar com planilhas.
Planilha de Gráficos	Chartsheet	Chartsheet	Uma planilha que representa um gráfico armazenado como sua própria planilha. Para obter mais informações, consulte Trabalhar com planilhas.
Table	table	Table	Um constructo lógico que especifica que um intervalo de dados pertence a um único conjunto de dados. Para obter mais informações, consulte Trabalhando com tabelas de PlanilhaML.
Tabela Dinâmica	pivotTableDefinition	PivotTableDefinition	Um constructo lógico que exibe a exibição agregada de dados em um layout compreensível. Para obter mais informações, consulte Trabalhando com Tabelas Dinâmicas.
Cache Dinâmico	pivotCacheDefinition	PivotCacheDefinition	Um build que define a origem dos dados na Tabela Dinâmica. Para obter mais informações, consulte Trabalhando com Tabelas Dinâmicas.
Registros de cache dinâmico	pivotCacheRecords	PivotCacheRecords	Um cache dos dados de origem da Tabela Dinâmica. Para obter mais informações, consulte Trabalhando com Tabelas Dinâmicas.
Cadeia de Cálculo	calcChain	CalculationChain	Um constructo que especifica a ordem em que as células na pasta de trabalho foram calculadas pela última vez. Para obter mais informações, consulte Trabalhar com a cadeia de cálculo.
Tabela de cadeia de caracteres compartilhada	sst	SharedStringTable	Um build que contém uma ocorrência de cada cadeia de caracteres exclusiva que ocorre em todas as planilhas de uma pasta de trabalho. Para obter mais informações, consulte Trabalhar com a tabela de cadeia de caracteres compartilhada.
Formatação condicional	condicionalFormatting	CondicionalFormatting	Um build que define um formato aplicado a uma célula ou série de células. Para obter mais informações, consulte Trabalhar com formatação condicional.
Fórmulas	f	CellFormula	Um build que define o texto da fórmula para uma célula que contém uma fórmula. Para obter mais informações, consulte Trabalhar com fórmulas.

---

Cenário mínimo de pasta de trabalho

O texto a seguir do Standard ECMA-376 apresenta o cenário mínimo da pasta de trabalho.

A menor pasta de trabalho possível (em branco) deve conter o seguinte:

Uma única planilha

Uma ID de planilha

Uma ID de relacionamento que aponta para o local da definição da planilha

© Ecma International: December 2006.

Abrir o exemplo de código do SDK XML

Este exemplo de código usa as classes no SDK Open XML para criar uma pasta de trabalho mínima em branco.

C#

using DocumentFormat.OpenXml;
using DocumentFormat.OpenXml.Packaging;
using DocumentFormat.OpenXml.Spreadsheet;

CreateSpreadsheetWorkbook(args[0]);

static void CreateSpreadsheetWorkbook(string filepath)
{
    // Create a spreadsheet document by supplying the filepath.
    // By default, AutoSave = true, Editable = true, and Type = xlsx.
    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);

    workbookPart.Workbook.Save();

    // Dispose the document.
    spreadsheetDocument.Dispose();
}

Visual Basic

Imports DocumentFormat.OpenXml
Imports DocumentFormat.OpenXml.Packaging
Imports DocumentFormat.OpenXml.Spreadsheet

Module MyModule

    Sub Main(args As String())
    End Sub

    Public Sub CreateSpreadsheetWorkbook(ByVal filepath As String)
        ' Create a spreadsheet document by supplying the filepath.
        ' By default, AutoSave = true, Editable = true, and Type = xlsx.
        Dim 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 = spreadsheetDocument.WorkbookPart.Workbook.AppendChild(Of Sheets)(New Sheets())

        ' Append a new worksheet and associate it with the workbook.
        Dim sheet As Sheet = New Sheet
        sheet.Id = spreadsheetDocument.WorkbookPart.GetIdOfPart(worksheetPart)
        sheet.SheetId = 1
        sheet.Name = "mySheet"

        sheets.Append(sheet)

        workbookpart.Workbook.Save()

        ' Dispose the document.
        spreadsheetDocument.Dispose()
    End Sub
End Module

Planilha geradaML

Depois de executar o código SDK Open XML para gerar uma pasta de trabalho mínima, você pode explorar o conteúdo do pacote .zip para exibir o código XML de Planilha. Para exibir o pacote .zip, renomeie a extensão na planilha mínima de .xlsx para .zip. Dentro do pacote .zip, há várias partes que compõem a pasta de trabalho mínima.

A figura a seguir mostra a estrutura na pasta xl do pacote .zip para uma pasta de trabalho mínima.

Figura 1. .zip estrutura de pastas

O arquivo workbook.xml contém < elementos de planilha> que fazem referência às planilhas na pasta de trabalho. Cada planilha está associada à pasta de trabalho por meio de uma ID da Planilha e uma ID de relacionamento. O sheetID é a ID usada no pacote para identificar uma planilha e deve ser exclusiva dentro da pasta de trabalho. A id é a ID de relação que identifica a definição da parte da planilha associada a uma planilha.

O código XML a seguir é a planilhaML que representa a parte da pasta de trabalho do documento da planilha. Esse código é gerado quando você executa o código SDK Open XML para criar uma pasta de trabalho mínima.

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

O arquivo workbook.xml.rels contém os < elementos Relationship> que definem as relações entre a pasta de trabalho e as planilhas que ela contém.

O código XML a seguir é a planilhaML que representa a parte de relação do documento da planilha. Esse código é gerado quando você executa o SDK Open XML para criar uma pasta de trabalho mínima.

    <?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>

O arquivosheet.xml contém o < elemento sheetData> que representa a tabela de células. Neste exemplo, a pasta de trabalho está em branco, portanto, o < elemento sheetData> está vazio. Para obter mais informações sobre planilhas, consulte Trabalhar com planilhas**.

O código XML a seguir é a planilhaML que representa a parte da planilha do documento da planilha. Esse código é gerado quando você executa o SDK Open XML para criar uma pasta de trabalho mínima.

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

Cenário típico da pasta de trabalho

Uma pasta de trabalho típica não será uma pasta de trabalho mínima e em branco. Uma pasta de trabalho típica pode conter números, texto, gráficos, tabelas e tabelas dinâmicas. Cada uma dessas partes adicionais está contida no pacote .zip do documento de planilha.

A figura a seguir mostra a maioria dos elementos que você encontraria em uma planilha típica.

Figura 2. Elementos típicos da planilha