Structura unui document SpreadsheetML (Open XML SDK)

• 11/01/2017
• 5 minute de citit

In acest articol

Structura documentului unui document SpreadsheetML consta din elementul < workbook > care contine elemente < sheet > si < sheet > care fac referire la foile de lucru din registrul de lucru. Pentru fiecare foaie de lucru este creat un fisier XML separat. Aceste elemente sunt elementele minime necesare pentru un document de foaie de calcul valid. In plus, un document de calcul tabelar pot contine < table >, < chartsheet >, < pivotTableDefinition elemente> sau alte riscuri legate de foi de calcul.

Piese importante ale foii de calcul

Folosind Open XML SDK 2.5 pentru Office, puteti crea structura documentului si continutul care utilizeaza clase puternic tastate care corespund elementelor SpreadsheetML . Puteti gasi aceste clase in spatiul de nume DocumentFormat.OpenXML.Spreadsheet . Urmatorul tabel listeaza numele claselor claselor care corespund unor elemente importante ale foii de calcul.

Partea pachet Foaie de calcul Nivel superior Element ML Deschidere XML SDK 2.5 Clasa Descriere Caiet de lucru Caiet de lucru Caiet de lucru Elementul radacina pentru partea principala a documentului. Foaie de lucru Foaie de lucru Foaie de lucru Un tip de foaie care reprezinta o grila de celule care contine text, numere, date sau formule. Pentru mai multe informatii, consultati Lucrul cu foi (Open XML SDK). Foaie de diagrame Foaie de diagrame Foaie de diagrame O foaie care reprezinta o diagrama stocata ca foaie proprie. Pentru mai multe informatii, consultati Lucrul cu foi (Open XML SDK). Table table Table O constructie logica care specifica faptul ca o gama de date apartine unui singur set de date. Pentru mai multe informatii, consultati Lucrul cu tabele SpreadsheetML (Open XML SDK). PivotTable pivotTableDefinition PivotTableDefinition O constructie logica care afiseaza vizualizarea agregata a datelor intr-un aspect usor de inteles. Pentru mai multe informatii, consultati Lucrul cu tabelele pivot (Open XML SDK). Pivot Cache pivotCacheDefinition PivotCacheDefinition O constructie care defineste sursa datelor din tabelul pivot. Pentru mai multe informatii, consultati Lucrul cu tabele pivot (Open XML SDK). Pivot Cache Inregistreaza pivotCacheRecords PivotCacheRecords O memorie cache a datelor sursa ale PivotTable. Pentru mai multe informatii, consultati Lucrul cu tabele pivot (Open XML SDK). Calcul Chain calcChain CalculationChain O constructie care specifica ordinea in care celulele din registrul de lucru au fost calculate ultima data. Pentru mai multe informatii, consultati Lucrul cu lantul de calcul (Open XML SDK). Shared String Table sst SharedStringTable O constructie care contine o aparitie din fiecare sir unic care apare pe toate foile de lucru dintr-un registru de lucru. Pentru mai multe informatii, consultati Lucrul cu tabelul de siruri partajate (Open XML SDK). Formatare conditionala conditionalFormatting ConditionalFormatting O constructie care defineste un format aplicat unei celule sau unei serii de celule. Pentru mai multe informatii, consultati Lucrul cu formatarea conditionala (Open XML SDK). Formule f CellFormula O constructie care defineste textul formula pentru o celula care contine o formula. Pentru mai multe informatii, consultati Lucrul cu formule (Open XML SDK).

Scenariul minim al cartii de lucru

Urmatorul text din standardul ECMA-376 introduce scenariul minim al registrului de lucru.

Cel mai mic registru de lucru (gol) posibil trebuie sa contina urmatoarele:

O singura foaie

Un ID de foaie

Un ID de relatie care indica locatia definitiei foii

© Ecma International: decembrie 2006.

Deschideti Exemplu de cod XML SDK

Acest exemplu de cod utilizeaza clasele din Open XML SDK 2.5 pentru a crea un registru de lucru minim, gol.

public static void CreateSpreadsheetWorkbook (sir de fisiere) {// Creati un document de foaie de calcul furnizand fisierul. // In mod implicit, AutoSave = true, Editable = true si Type = xlsx. SpreadsheetDocument spreadsheetDocument = SpreadsheetDocument.Create (filepath, SpreadsheetDocumentType.Workbook); // Adaugati un registru de lucru la document. WorkbookPart workbookpart = spreadsheetDocument.AddWorkbookPart (); workbookpart.Workbook = new Workbook (); // Adaugati un WorksheetPart la WorkbookPart. WorksheetPart worksheetPart = workbookpart.AddNewPart <WorksheetPart> (); worksheetPart.Worksheet = new Foaie de lucru (nou SheetData ()); // Adaugati foi in registrul de lucru. Foi de foi = spreadsheetDocument.WorkbookPart.Workbook.AppendChild <Sheets> (Foi noi ()); // Adaugati o noua foaie de lucru si asociati-o cu registrul de lucru. Foaie de foaie = Foaie noua () {Id = Foaie de calculDocument.WorkbookPart.GetIdOfPart (worksheetPart), SheetId = 1, Name = “mySheet”}; foi. Adaugati (foaie); workbookpart.Workbook.Save (); // Inchideti documentul. spreadsheetDocument.Close (); } Public Sub CreateSpreadsheetWorkbook (ByVal filepath As String) ‘Creati un document foaie de calcul prin furnizarea de filepath. „In mod implicit, AutoSave = true, Editable = true si Type = xlsx. Dim spreadsheetDocument As SpreadsheetDocument = spreadsheetDocument.Create (filepath, SpreadsheetDocumentType.Workbook) ‘Adaugati un document de lucru in document. Dim workbookpart As WorkbookPart = spreadsheetDocument.AddWorkbookPart workbookpart.Workbook = New Workbook ‘Add a WorksheetPart to WorkbookPart. Dim worksheetPart As WorksheetPart = workbookpart.AddNewPart (Of WorksheetPart) () worksheetPart. Foaie de lucru = Foaie de lucru noua (Foaie de date noua ()) ‘Adaugati foi in registrul de lucru. Dim coli ca foi = spreadsheetDocument.WorkbookPart.Workbook.AppendChild (Of Sheets) (New Sheets ()) ‘Adaugati o noua foaie de lucru si asociati-o cu registrul de lucru. Dim sheet As Sheet = Foaie noua sheet.Id = spreadsheetDocument.WorkbookPart.GetIdOfPart (worksheetPart) sheet.SheetId = 1 sheet.Name = “mySheet” foi. Adaugati (sheet) workbookpart.Workbook.Save () ‘Inchideti documentul. spreadsheetDocument.Close () End Sub SheetId = 1 sheet.Name = “mySheet” foi. Adaugati (foaie) carte de lucru parte.Workbook.Save () ‘Inchideti documentul. spreadsheetDocument.Close () End Sub SheetId = 1 sheet.Name = “mySheet” foi. Adaugati (foaie) carte de lucru parte.Workbook.Save () ‘Inchideti documentul. spreadsheetDocument.Close () End Sub

Foaie de calcul generata ML

Dupa ce rulati codul Open XML SDK 2.5 pentru a genera un registru de lucru minim, puteti explora continutul pachetului .zip pentru a vizualiza codul XML SpreadsheetML. Pentru a vizualiza pachetul .zip, redenumiti extensia din foaia de calcul minima din .xlsx in .zip . In interiorul pachetului .zip, exista mai multe parti care alcatuiesc registrul de lucru minim.

Urmatoarea figura arata structura din folderul xl al pachetului .zip pentru un registru de lucru minim.

Figura 1. Structura folderului .zip

Fisierul workbook.xml contine elemente < sheet > care fac referire la foile de lucru din registrul de lucru. Fiecare foaie de lucru este asociata registrului de lucru printr-un ID de foaie si un ID de relatie. SheetID este ID – ul utilizat in cadrul pachetului pentru a identifica o foaie si trebuie sa fie unic in cadrul registrului de lucru. ID – ul este ID relatie care identifica definitia parte foaie asociata cu o foaie.

Urmatorul cod XML este foaia de calcul ML care reprezinta partea din registrul de lucru al documentului de foaie de calcul. Acest cod este generat atunci cand rulati codul Open XML SDK 2.5 pentru a crea un registru de lucru minim.

<? 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: registru de lucru>

Fisierul workbook.xml.rels contine elementele < Relationship > care definesc relatiile dintre registrul de lucru si foile de lucru pe care le contine.

Urmatorul cod XML este foaia de calcul ML care reprezinta partea de relatie a documentului de foaie de calcul. Acest cod este generat atunci cand rulati Open XML SDK 2.5 pentru a crea un registru de lucru minim.

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

Fisierul sheet.xml contine elementul < sheetData > care reprezinta tabelul de celule. In acest exemplu, registrul de lucru este gol, deci elementul < sheetData > este gol. Pentru mai multe informatii despre foi, consultati Lucrul cu foi (Open XML SDK) **.

Urmatorul cod XML este foaia de calcul ML care reprezinta partea din foaia de lucru a documentului de foaie de calcul. Acest cod este generat atunci cand rulati Open XML SDK 2.5 pentru a crea un registru de lucru minim.

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

Scenariu tipic de carte de lucru

Un registru de lucru tipic nu va fi un registru de lucru minim, gol. Un registru de lucru tipic poate contine numere, text, diagrame, tabele si tabele pivot. Fiecare dintre aceste parti suplimentare este continuta in pachetul .zip din documentul foii de calcul.

Urmatoarea figura prezinta majoritatea elementelor pe care le-ati gasi intr-o foaie de calcul tipica.

Figura 2. Elemente tipice ale foii de calcul