Creați un tabel

Aspose.Words permite utilizatorilor să creeze tabele într-un document de la zero și oferă mai multe metode diferite pentru a face acest lucru. Acest articol prezintă detalii despre cum să adăugați tabele formatate la documentul dvs. utilizând Fiecare metodă, precum și o comparație a fiecărei metode la sfârșitul articolului.

Stiluri De Masă Implicite

Tabelului nou creat i se dau valori implicite similare cu cele utilizate în Microsoft Word:

Proprietatea Tabelului Implicit în Aspose.Words
Border Style Single
Border Width 1/2 pt
Culoarea Chenarului Black
Left and Right Padding 5.4 pts
AutoFit Mode AutoFit to Window
Allow AutoFit True

Creați un tabel cu DocumentBuilder

În Aspose.Words, Utilizatorii pot crea un tabel într-un document folosind DocumentBuilder. Algoritmul de bază pentru crearea unui tabel este următorul:

  1. Începeți tabelul cu StartTable
  2. Adăugați o celulă la tabel folosind InsertCell - aceasta pornește automat un nou rând
  3. Opțional, utilizați proprietatea CellFormat pentru a specifica formatarea celulei
  4. Introduceți conținutul celulei folosind metodele corespunzătoare DocumentBuilder, cum ar fi Writeln, InsertImage și altele
  5. Repetați pașii 2 - 4 până când rândul este complet
  6. Apelați EndRow pentru a încheia rândul curent
  7. Opțional, utilizați proprietatea RowFormat pentru a specifica formatarea rândurilor
  8. Repetați pașii 2 - 7 până când tabelul este complet
  9. Apelați EndTable pentru a termina construirea mesei

Procesul de creare a unui tabel poate fi văzut clar în imaginea următoare:

creating-table-process

Următorul exemplu de cod arată cum să creați un tabel simplu folosind DocumentBuilder cu formatare implicită:

Următorul exemplu de cod arată cum se creează un tabel formatat folosind DocumentBuilder:

Următorul exemplu de cod arată cum să inserați un tabel imbricat folosind DocumentBuilder:

Creați un tabel prin DOM (Document Object Model)

Puteți insera tabele direct în DOM adăugând un nou nod Table la o anumită poziție.

Vă rugăm să rețineți că imediat după crearea nodului tabelului, tabelul în sine va fi complet gol, adică nu conține încă rânduri și celule. Pentru a insera rânduri și celule într-un tabel, adăugați nodurile copil corespunzătoare Row și Cell la DOM.

Următorul exemplu de cod arată cum să construiți un nou tabel de la zero prin adăugarea nodurilor copil corespunzătoare în arborele de documente:

Creați un tabel din HTML

Aspose.Words acceptă inserarea conținutului într-un document dintr-o sursă HTML folosind metoda InsertHtml. Intrarea poate fi o pagină completă HTML sau doar un fragment parțial.

Folosind această metodă InsertHtml, utilizatorii pot insera tabele în document prin etichete de tabel precum <table>, <tr>, <td>.

Următorul exemplu de cod arată cum să inserați un tabel într-un document dintr-un șir care conține etichete HTML:

Inserați o copie a unui tabel existent

Există adesea momente când trebuie să creați un tabel bazat pe un tabel deja existent într-un document. Cel mai simplu mod de a duplica un tabel păstrând în același timp toate formatările este de a clona nodul tabelului folosind metoda deepClone.

Aceeași tehnică poate fi utilizată pentru a adăuga copii ale unui rând sau celulă existentă la un tabel.

Următorul exemplu de cod arată cum să duplicați un tabel folosind constructori de noduri:

Următorul exemplu de cod arată cum să clonați ultimul rând al unui tabel și să îl adăugați la tabel:

Dacă vă uitați la crearea de tabele într-un document care cresc dinamic cu fiecare înregistrare din sursa de date, atunci metoda de mai sus nu este recomandată. În schimb, rezultatul dorit este mai ușor de obținut prin utilizarea Mail merge cu regiuni. Puteți afla mai multe despre această tehnică în Mail Merge cu regiuni secțiunea.

Comparați modalitățile de a crea un tabel

Aspose.Words oferă mai multe metode pentru a crea tabele noi într-un document. Fiecare metodă are propriile avantaje și dezavantaje, astfel încât alegerea utilizării depinde adesea de situația specifică.

Să aruncăm o privire mai atentă asupra acestor moduri de a crea tabele și de a compara avantajele și dezavantajele acestora:

Metoda Avantaje Dezavantaje
Prin DocumentBuilder Metoda standard pentru inserarea tabelelor și a altor conținuturi ale documentelor Uneori dificil de a crea mai multe soiuri de tabele, în același timp, cu aceeași instanță constructor
Prin DOM Se potrivește mai bine cu codul înconjurător care creează și inserează noduri direct în DOM fără a utiliza un DocumentBuilder Tabelul este creat “gol”: înainte de a efectua majoritatea operațiunilor, trebuie să apelați EnsureMinimum pentru a crea noduri copil lipsă
Din HTML Poate crea un nou tabel din HTML sursă folosind etichete precum <table>, <tr>, <td> Nu toate formatele de tabel Microsoft Word posibile pot fi aplicate la HTML
Clonarea unui tabel existent Puteți crea o copie a unui tabel existent păstrând în același timp toate formatarea rândurilor și celulelor Nodurile copil corespunzătoare trebuie eliminate înainte ca tabelul să fie gata de utilizare