Aspose.Words Document Object Model (DOM)

W Aspose.Words Document Object Model (DOM) jest in- memoriałową reprezentacją dokumentu Word. W Aspose.Words DOM pozwala programowo czytać, manipulować i modyfikować zawartość i formatowanie dokumentu Word.

Niniejsza sekcja opisuje główne klasy Aspose.Words DOM i ich związki. Używając Aspose.Words DOM zajęcia, można uzyskać dostęp programowy do elementów dokumentów i formatowanie.

Utwórz dokument Drzewo obiektów

Kiedy dokument jest odczytywany do Aspose.Words <span notrans="<span notrans=" DOM"="">", > Następnie powstaje drzewo obiektowe i różne rodzaje elementów dokumentu źródłowego mają swoje własne DOM obiekty drzewne o różnych właściwościach.

Zbuduj drzewo węzłów dokumentów

Kiedy Aspose.Words odczyt dokumentu Word do pamięci, tworzy obiekty różnych typów, które reprezentują różne elementy dokumentu. Każdy ciąg tekstu, paragrafu, tabeli lub sekcji jest węzłem, a nawet sam dokument jest węzłem. Aspose.Words definiuje klasę dla każdego typu węzła dokumentu.

Drzewo dokumentów w Aspose.Words następujące wzory konstrukcyjne kompozytowe:

• Wszystkie klasy węzłów ostatecznie pochodzą z Node klasa, która jest klasa podstawowa w Aspose.Words Document Object Model.
• Węzły, które mogą zawierać inne węzły, na przykład, Section lub Paragraph, pochodzą z CompositeNode klasy, która z kolei pochodzi z Node Klasa.

Schemat przedstawiony poniżej pokazuje dziedziczenie między klasami węzłów Aspose.Words Document Object Model (DOM). Nazwy klas abstrakcyjnych są po włosku.

W Aspose.Words DOM zawiera również klasy non-node, takie jak Style lub Font, które są używane do dostosowania wyglądu i stylów w dokumencie. Klasy te nie są pokazane w tym schemacie, jak nie dziedziczone od Node Klasa.

Spójrzmy na przykład. Poniższy obrazek pokazuje Microsoft Word dokument z różnymi rodzajami treści.

Podczas czytania powyższego dokumentu do Aspose.Words DOM, drzewo obiektów jest tworzone, jak pokazano w schemacie poniżej.

Document, Section, Paragraph, Table, Shape, Run, i wszystkie inne elipsy na diagramie są Aspose.Words obiekty, które reprezentują elementy dokumentu Word.

Pobierz Node Rodzaj

Chociaż Node klasa jest wystarczająca do odróżnienia różnych węzłów od siebie, Aspose.Words zapewnia NodeType wyliczenie w celu uproszczenia niektórych API zadania takie jak wybór węzłów określonego typu.

Typ każdego węzła można uzyskać za pomocą NodeType nieruchomości. Ta właściwość zwraca a NodeType wartość wyliczenia. Na przykład, węzeł paragrafu reprezentowany przez Paragraph zwroty klasy NodeType.Paragraphoraz węzeł stołowy reprezentowany przez Table zwroty klasy NodeType.Table.

Poniższy przykład pokazuje jak uzyskać typ węzła za pomocą NodeType wyliczenie:

Nawigacja drzewa dokumentów

Aspose.Words reprezentuje dokument jako drzewo węzłów, które pozwala poruszać się między węzłami. Ta sekcja opisuje, jak badać i nawigować drzewo dokumentów w Aspose.Words.

Po otwarciu przykładowego dokumentu, przedstawionego wcześniej, w dokumencie Document Explorer drzewo węzła pojawia się dokładnie tak, jak jest reprezentowane w Aspose.Words.

Można nauczyć się przykładowego projektu “Document Explorer” na Aspose.Words GitHub.

Powiązania węzła dokumentu

Węzły w drzewie mają relacje między nimi:

• Węzeł zawierający inny węzeł jest parent.
• Węzeł zawarty w węźle macierzystym jest child. Węzły dziecięce tego samego rodzica są sibling węzły.
• root węzeł jest zawsze Document węzeł.

Węzły, które mogą zawierać inne węzły pochodzą z CompositeNode klasy, i wszystkie węzły ostatecznie pochodzą z Node Klasa. Te dwie klasy bazowe zapewniają wspólne metody i właściwości nawigacji i modyfikacji struktury drzew.

Poniższy diagram obiektu UML pokazuje kilka węzłów dokumentu próbki i ich relacje ze sobą poprzez właściwości rodzica, dziecka i rodzeństwa:

Dokument jest właścicielem węzła

Węzeł zawsze należy do konkretnego dokumentu, nawet jeśli został on po prostu stworzony lub usunięty z drzewa, ponieważ istotne struktury dokumentów, takie jak style i listy są przechowywane w Document węzeł. Na przykład, nie jest możliwe posiadanie Paragraph bez Document ponieważ każdy akapit ma przypisany styl zdefiniowany globalnie dla dokumentu. Zasada ta jest używana przy tworzeniu nowych węzłów. Dodawanie nowego Paragraph bezpośrednio do DOM wymaga obiektu dokumentu przekazanego konstruktorowi.

W Node.Document właściwość zwraca dokument, do którego należy węzeł.

Przy tworzeniu nowego akapitu DocumentBuilder, budowniczy zawsze ma Document klasy związane z nim poprzez DocumentBuilder.Document nieruchomości.

Poniższy przykład kodu pokazuje, że przy tworzeniu dowolnego węzła zawsze jest zdefiniowany dokument, który będzie właścicielem węzła:

Węzeł rodzica

Każdy węzeł ma określony przez ParentNode nieruchomości. Węzeł nie ma węzła macierzystego. ParentNode jest zerowa, w następujących przypadkach:

• Węzeł został właśnie stworzony i nie został jeszcze dodany do drzewa.
• Węzeł został usunięty z drzewa.
• To jest pierwiastek Document węzeł, który zawsze ma zerowy węzeł macierzysty.

Możesz usunąć węzeł z jego rodzica przez wywołanie Remove Metoda. Poniższy przykład kodu pokazuje jak uzyskać dostęp do węzła macierzystego:

Węzły dziecięce

Najbardziej skuteczny sposób dostępu do węzłów dziecięcych CompositeNode jest za pośrednictwem FirstChild oraz LastChild właściwości, które zwracają odpowiednio pierwsze i ostatnie węzły dziecięce. Jeśli nie ma węzłów dziecięcych, te właściwości wracają null.

CompositeNode zapewnia również ChildNodes kolekcja umożliwiająca dostęp do węzłów dziecięcych z indeksem lub numeracją. W ChildNodes właściwość jest zbiór na żywo węzłów, co oznacza, że w każdym przypadku zmiany dokumentu, takich jak gdy węzły są usuwane lub dodawane, ChildNodes zbieranie jest automatycznie aktualizowane.

Jeśli węzeł nie ma dziecka, to ChildNodes właściwość zwraca pusty zbiór. Można sprawdzić, czy CompositeNode zawiera wszystkie węzły dziecięce za pomocą HasChildNodes nieruchomości.

Poniższy przykład kodu pokazuje, jak wyliczyć natychmiastowe węzły dziecięce CompositeNode przy użyciu enumeratora dostarczonego przez ChildNodes Kolekcja:

Poniższy przykład kodu pokazuje, jak wyliczyć natychmiastowe węzły dziecięce CompositeNode korzystanie ze zindeksowanego dostępu:

Węzły rodzeństwa

Można uzyskać węzeł, który natychmiast poprzedza lub podąża za danym węzłem za pomocą PreviousSibling oraz NextSibling właściwości, odpowiednio. Jeśli węzeł jest ostatnim dzieckiem jego rodzica, to NextSibling nieruchomość jest null. Natomiast, jeśli węzeł jest pierwszym dzieckiem jego rodzica, PreviousSibling nieruchomość jest null.

Poniższy przykład kodu pokazuje, jak skutecznie odwiedzić wszystkie bezpośrednie i pośrednie węzły dziecięce węzła kompozytowego:

Wpisany dostęp do węzłów dziecięcych i rodzicielskich

Dotychczas omawialiśmy właściwości, które zwracają jeden z typów podstawowych - Node lub CompositeNode. Ale czasami są sytuacje, w których może być konieczne rzucenie wartości do określonej klasy węzłów, takich jak Run lub Paragraph. To znaczy, nie można całkowicie uciec od castingu podczas pracy z Aspose.Words DOM, który jest złożony.

Aby zmniejszyć potrzebę odlewania, większość Aspose.Words klasy zapewniają właściwości i kolekcje, które zapewniają dostęp do warstw. Istnieją trzy podstawowe wzory dostępu na maszynie:

• Kącik macierzysty ujawnia wpisane FirstXXX oraz LastXXX nieruchomości. Na przykład: Document ma FirstSection oraz LastSection nieruchomości. Podobnie, Table posiada właściwości, takie jak FirstRow, LastRow, I innych.
• węzeł macierzysty eksponuje zbiór węzłów dziecięcych, takich jak Document.Sections, Body.Paragraphs, I innych.
• węzeł dziecięcy zapewnia dostęp do jego rodzica, jak np. Run.ParentParagraph, Paragraph.ParentSection, I innych.

Właściwości wpisywane są jedynie przydatnymi skrótami, które czasami zapewniają łatwiejszy dostęp niż właściwości ogólne odziedziczone po Node.ParentNode oraz CompositeNode.FirstChild.

Poniższy przykład kodu pokazuje, jak używać właściwości wpisanych do dostępu do węzłów drzewa dokumentów: