Aspose.Words Model Obiect Document (DOM)

Modelul de obiect Document Aspose.Words (DOM) este o reprezentare în memorie a unui document Word. Aspose.Words DOM vă permite să citiți, să manipulați și să modificați în mod programatic conținutul și formatarea unui document Word.

Această secțiune descrie clasele principale ale Aspose.Words DOM și relațiile lor. Folosind clasele Aspose.Words DOM, puteți obține acces programatic la elementele documentului și formatare.

Creare Document Arbore Obiect

Când un document este citit în Aspose.Words DOM, atunci este construit un arbore de obiecte și diferite tipuri de elemente ale documentului sursă au propriile lor obiecte de copac DOM cu proprietăți diferite.

Construiți Arborele Nodurilor Documentului

Când Aspose.Words citește un document Word în memorie, acesta creează obiecte de diferite tipuri care reprezintă diferite elemente ale documentului. Fiecare rulare a unui text, paragraf, tabel sau secțiune este un nod și chiar documentul în sine este un nod. Aspose.Words definește o clasă pentru fiecare tip de nod de document.

Arborele de documente din Aspose.Words urmează modelul de proiectare compozit:

• Toate clasele de noduri derivă în cele din urmă din clasa Node, care este clasa de bază din modelul obiectului Document Aspose.Words.
• Nodurile care pot conține alte noduri, de exemplu, Section sau Paragraph, derivă din clasa CompositeNode, care la rândul său derivă din clasa Node.

Diagrama furnizată mai jos arată moștenirea între clasele de noduri ale modelului de obiect Document Aspose.Words (DOM). Numele claselor abstracte sunt în italice.

Aspose.Words DOM conține, de asemenea, clasele non-nod, cum ar fi Style sau Font, care sunt utilizate pentru a personaliza aspectul și stilurile dintr-un document. Aceste clase nu sunt prezentate în această diagramă ca fiind moștenite de la clasa Node.

Să ne uităm la un exemplu. Următoarea imagine prezintă un document Microsoft Word cu diferite tipuri de conținut.

Când citiți documentul de mai sus în Aspose.Words DOM, arborele obiectelor este creat, așa cum se arată în schema de mai jos.

Document, Section, Paragraph, Table, Shape, Run, și toate celelalte elipse din diagramă sunt obiecte Aspose.Words care reprezintă elemente ale documentului Word.

Obțineți un Node Tip

Deși clasa Node este suficientă pentru a distinge diferite noduri unele de altele, Aspose.Words oferă enumerarea NodeType pentru a simplifica unele sarcini API, cum ar fi selectarea nodurilor de un anumit tip.

Tipul fiecărui nod poate fi obținut folosind proprietatea NodeType. Această proprietate returnează o valoare de enumerare NodeType. De exemplu, un nod de paragraf reprezentat de clasa Paragraph returnează NodeType.Paragraph, iar un nod de tabel reprezentat de clasa Table returnează NodeType.Table.

Următorul exemplu arată cum să obțineți un tip de nod folosind enumerarea NodeType:

Document Tree Navigation

Aspose.Words reprezintă un document ca arbore de noduri, care vă permite să navigați între noduri. Această secțiune descrie modul de explorare și navigare a arborelui de documente în Aspose.Words.

Când deschideți documentul eșantion, prezentat anterior, în Document Explorer, arborele nodului apare exact așa cum este reprezentat în Aspose.Words.

Relații Nod Document

Nodurile din copac au relații între ele:

• Un nod care conține un alt nod este un parent.
• Nodul conținut în nodul părinte este un child. nodurile copil ale aceluiași părinte sunt sibling noduri.
• Nodul root este întotdeauna nodul Document.

Nodurile care pot conține alte noduri derivă din clasa CompositeNode, iar toate nodurile derivă în cele din urmă din clasa Node. Aceste două clase de bază oferă metode și proprietăți comune pentru navigarea și modificarea structurii arborești.

Următoarea diagramă de obiecte UML prezintă mai multe noduri ale documentului eșantion și relațiile lor între ele prin proprietățile părinte, copil și frate:

Documentul este proprietarul nodului

Un nod aparține întotdeauna unui anumit document, chiar dacă tocmai a fost creat sau eliminat din copac, deoarece structurile vitale la nivelul întregului document, cum ar fi stilurile și listele, sunt stocate în nodul Document. De exemplu, nu este posibil să aveți un Paragraph fără un Document deoarece fiecare paragraf are un stil atribuit care este definit global pentru document. Această regulă este utilizată la crearea oricăror noduri noi. Adăugarea unui nou Paragraph Direct la DOM necesită un obiect document transmis constructorului.

Proprietatea Node.Document returnează documentul căruia îi aparține nodul.

Când creați un paragraf nou folosind DocumentBuilder, constructorul are întotdeauna o clasă Document legată de acesta prin proprietatea DocumentBuilder.Document.

Următorul exemplu de cod arată că atunci când creați orice nod, un document care va deține nodul este întotdeauna definit:

Nodul Părinte

Fiecare nod are un părinte specificat de proprietatea ParentNode. Un nod nu are nod părinte, adică ParentNode este nul, în următoarele cazuri:

• Nodul tocmai a fost creat și nu a fost încă adăugat la copac.
• Nodul a fost scos din copac.
• Acesta este nodul rădăcină Document care are întotdeauna un nod părinte nul.

Puteți elimina un nod din părintele său apelând metoda Remove.Următorul exemplu de cod arată cum să accesați nodul părinte:

Noduri Copil

Cel mai eficient mod de a accesa nodurile copil ale unui CompositeNode este prin proprietățile FirstChild și LastChild care returnează primul și ultimul nod copil, respectiv. Dacă nu există noduri copil, aceste proprietăți returnează null.

CompositeNode

Dacă un nod nu are copil, atunci proprietatea ChildNodes returnează o colecție goală. Puteți verifica dacă CompositeNode conține noduri copil folosind proprietatea HasChildNodes.

Următorul exemplu de cod arată cum să enumerați nodurile copil imediate ale unui CompositeNode folosind enumeratorul furnizat de colecția ChildNodes:

Următorul exemplu de cod arată cum să enumerați nodurile copil imediate ale unui CompositeNode folosind accesul indexat:

Noduri De Frate

Puteți obține nodul care precede sau urmează imediat un anumit nod folosind proprietățile PreviousSibling și, respectiv, NextSibling. Dacă un nod este ultimul copil al părintelui său, atunci proprietatea NextSibling este null. În schimb, dacă nodul este primul copil al părintelui său, proprietatea PreviousSibling este null.

Următorul exemplu de cod arată cum să vizitați eficient toate nodurile copil directe și indirecte ale unui nod compus:

Acces tastat la nodurile copil și părinte

Până în prezent, am discutat despre proprietățile care returnează unul dintre tipurile de bază – Node sau CompositeNode. Dar uneori există situații în care ar putea fi necesar să aruncați valori într-o anumită clasă de noduri, cum ar fi Run sau Paragraph. Adică, nu puteți scăpa complet de turnare atunci când lucrați cu Aspose.Words DOM, care este compozit.

Pentru a reduce nevoia de turnare, majoritatea claselor Aspose.Words oferă proprietăți și colecții care oferă acces puternic tipărit. Există trei modele de bază de acces tastat:

• Un nod părinte expune proprietățile tastate FirstXXX și LastXXX. De exemplu, Document are FirstSection și LastSection proprietăți. În mod similar, Table are proprietăți precum FirstRow, LastRow și altele.
• Un nod părinte expune o colecție tipărită de noduri copil, cum ar fi Document.Sections, Body.Paragraphs și altele.
• Un nod copil oferă acces tastat la părintele său, cum ar fi Run.ParentParagraph, Paragraph.ParentSection și altele.

Proprietățile tastate sunt doar scurtături utile care uneori oferă acces mai ușor decât proprietățile generice moștenite de la Node.ParentNode și CompositeNode.FirstChild.

Următorul exemplu de cod arată cum să utilizați proprietățile tastate pentru a accesa nodurile arborelui de documente: