---
title: "Aspose.Words DOM"
---

Aspose.Words Document Object Model (DOM) to reprezentacja dokumentu Word w pamięci. Aspose.Words DOM umożliwia programowe odczytywanie, manipulowanie i modyfikowanie zawartości i formatowania dokumentu programu Word.

W tej sekcji opisano główne klasy Aspose.Words DOM i ich relacje. Korzystając z klas Aspose.Words DOM, można uzyskać programowy dostęp do elementów dokumentu i formatowania.

## Utwórz drzewo obiektów `Document` {#create-a-document-objects-tree}

Kiedy dokument jest wczytywany do Aspose.Words DOM, budowane jest drzewo obiektów, a różne typy elementów dokumentu źródłowego mają własne obiekty drzewa DOM o różnych właściwościach.

### Zbuduj drzewo węzłów dokumentów {#build-document-nodes-tree}

Kiedy Aspose.Words wczytuje dokument Word do pamięci, tworzy obiekty różnych typów, które reprezentują różne elementy dokumentu. Każdy ciąg tekstu, akapitu, tabeli lub sekcji jest węzłem i 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 jest zgodne ze złożonym wzorcem projektowym:

- Wszystkie klasy węzłów ostatecznie wywodzą się z klasy [Node](https://reference.aspose.com/words/python-net/aspose.words/node/), która jest klasą bazową w formacie Aspose.Words Document Object Model.
- Węzły, które mogą zawierać inne węzły, na przykład [Section](https://reference.aspose.com/words/python-net/aspose.words/section/) lub [Paragraph](https://reference.aspose.com/words/python-net/aspose.words/paragraph/), wywodzą się z klasy [CompositeNode](https://reference.aspose.com/words/python-net/aspose.words/compositenode/), która z kolei wywodzi się z klasy [Node](https://reference.aspose.com/words/python-net/aspose.words/node/).

Poniższy diagram przedstawia dziedziczenie pomiędzy klasami węzłów Aspose.Words Document Object Model (DOM). Nazwy klas abstrakcyjnych podano kursywą.

![aspose-słowa-dom](/words/python-net/aspose-words-document-object-model/aspose-words-dom.png)

```

Aspose.Words DOM zawiera również klasy inne niż węzłowe, takie jak [Style](https://reference.aspose.com/words/python-net/aspose.words/style/) lub [Font](https://reference.aspose.com/words/python-net/aspose.words/font/), które służą do dostosowywania wyglądu i stylów w dokumencie. Klasy te nie są pokazane na tym schemacie, ponieważ nie są odziedziczone z klasy [Node](https://reference.aspose.com/words/python-net/aspose.words/node/).

```

Spójrzmy na przykład. Poniższy obraz przedstawia dokument Microsoft Word z różnymi typami treści.

![przykład-dokumentu-aspose-words](/words/python-net/aspose-words-document-object-model/document-example.png)

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

![dom-aspose-words](/words/python-net/aspose-words-document-object-model/document-example-dom.png)

[Document](https://reference.aspose.com/words/python-net/aspose.words/document/), [Section](https://reference.aspose.com/words/python-net/aspose.words/section/), [Paragraph](https://reference.aspose.com/words/python-net/aspose.words/paragraph/), [Table](https://reference.aspose.com/words/python-net/aspose.words.tables/table/), [Shape](https://reference.aspose.com/words/python-net/aspose.words.drawing/shape/), [Run](https://reference.aspose.com/words/python-net/aspose.words/run/) i wszystkie inne elipsy na diagramie to obiekty Aspose.Words reprezentujące elementy dokumentu Word.

### Zdobądź plik {#get-a-node-type} typu `Node`

Chociaż klasa [Node](https://reference.aspose.com/words/python-net/aspose.words/node/) jest wystarczająca do rozróżnienia różnych węzłów, Aspose.Words udostępnia wyliczenie [NodeType](https://reference.aspose.com/words/python-net/aspose.words/nodetype/) w celu uproszczenia niektórych zadań API, takich jak wybieranie węzłów określonego typu.

Typ każdego węzła można uzyskać za pomocą właściwości [Node.node_type](https://reference.aspose.com/words/python-net/aspose.words/node/node_type/). Ta właściwość zwraca wartość wyliczenia [NodeType](https://reference.aspose.com/words/python-net/aspose.words/nodetype/). Na przykład węzeł akapitu reprezentowany przez klasę [Paragraph](https://reference.aspose.com/words/python-net/aspose.words/paragraph/) zwraca [NodeType.PARAGRAPH](https://reference.aspose.com/words/python-net/aspose.words/nodetype/#paragraph), a węzeł tabeli reprezentowany przez klasę [Table](https://reference.aspose.com/words/python-net/aspose.words.tables/table/) zwraca [NodeType.TABLE](https://reference.aspose.com/words/python-net/aspose.words/nodetype/#table).

Poniższy przykład pokazuje, jak uzyskać typ węzła za pomocą wyliczenia [NodeType](https://reference.aspose.com/words/python-net/aspose.words/nodetype/):

{{< gist "aspose-words-gists" "e9d8f984dac599756ccb4a64b8c79768" "Examples-DocsExamples-DocsExamples-Programming with Documents-working_with_node-UseNodeType.py" >}}

## Nawigacja po drzewie dokumentów {#document-tree-navigation}

Aspose.Words reprezentuje dokument jako drzewo węzłów, które umożliwia nawigację pomiędzy węzłami. W tej sekcji opisano, jak eksplorować i poruszać się po drzewie dokumentów w Aspose.Words.

Po otwarciu zaprezentowanego wcześniej przykładowego dokumentu w Eksploratorze dokumentów drzewo węzłów wygląda dokładnie tak, jak jest reprezentowane w Aspose.Words.

![eksplorator dokumentu w wersji elastycznej](/words/python-net/aspose-words-document-object-model/document-in-document-explorer.png)

```

Możesz zapoznać się z przykładowym projektem "Document Explorer" w [Aspose.Words GitHub](https://github.com/aspose-words/Aspose.Words-for-.NET/tree/master/Examples/DocsExamples).

```

### Relacje węzłów dokumentu {#document-nodes-relationships}

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

- Węzeł zawierający inny węzeł to *parent.*
- Węzeł zawarty w węźle nadrzędnym to *child.* Węzły podrzędne tego samego rodzica to węzły *sibling*.
- Węzeł *root* jest zawsze węzłem [Document](https://reference.aspose.com/words/python-net/aspose.words/document/).

Węzły, które mogą zawierać inne węzły, wywodzą się z klasy [CompositeNode](https://reference.aspose.com/words/python-net/aspose.words/compositenode/), a wszystkie węzły ostatecznie wywodzą się z klasy [Node](https://reference.aspose.com/words/python-net/aspose.words/node/). Te dwie klasy podstawowe zapewniają wspólne metody i właściwości do nawigacji i modyfikacji struktury drzewa.

Poniższy diagram obiektów UML przedstawia kilka węzłów przykładowego dokumentu i ich wzajemne relacje poprzez właściwości nadrzędne, podrzędne i równorzędne:

![dokumenty-węzły-relacje-aspose-words](/words/python-net/aspose-words-document-object-model/document-nodes-relationships.png)

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

Węzeł zawsze należy do konkretnego dokumentu, nawet jeśli został właśnie utworzony lub usunięty z drzewa, ponieważ istotne struktury całego dokumentu, takie jak style i listy, są przechowywane w węźle [Document](https://reference.aspose.com/words/python-net/aspose.words/document/). Na przykład nie jest możliwe utworzenie [Paragraph](https://reference.aspose.com/words/python-net/aspose.words/paragraph/) bez [Document](https://reference.aspose.com/words/python-net/aspose.words/document/), ponieważ każdy akapit ma przypisany styl, który jest zdefiniowany globalnie dla dokumentu. Reguła ta jest używana podczas tworzenia nowych węzłów. Dodanie nowego [Paragraph](https://reference.aspose.com/words/python-net/aspose.words/paragraph/) bezpośrednio do DOM wymaga przekazania obiektu dokumentu do konstruktora.

```

Właściwość [Node.document](https://reference.aspose.com/words/python-net/aspose.words/node/document/) zwraca dokument, do którego należy węzeł.

```

Tworząc nowy akapit przy użyciu [DocumentBuilder](https://reference.aspose.com/words/python-net/aspose.words/documentbuilder/), konstruktor zawsze ma powiązaną z nim klasę [Document](https://reference.aspose.com/words/python-net/aspose.words/document/) poprzez właściwość [DocumentBuilder.document](https://reference.aspose.com/words/python-net/aspose.words/documentbuilder/document/).

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

{{< gist "aspose-words-gists" "e9d8f984dac599756ccb4a64b8c79768" "Examples-DocsExamples-DocsExamples-Programming with Documents-working_with_node-OwnerDocument.py" >}}

#### Węzeł nadrzędny

Każdy węzeł ma rodzica określonego przez właściwość [parent_node](https://reference.aspose.com/words/python-net/aspose.words/node/parent_node/). Węzeł nie ma węzła nadrzędnego, tzn. [parent_node](https://reference.aspose.com/words/python-net/aspose.words/node/parent_node/) to *None* w następujących przypadkach:

- Węzeł został właśnie utworzony i nie został jeszcze dodany do drzewa.
- Węzeł został usunięty z drzewa.
- To jest główny węzeł [Document](https://reference.aspose.com/words/python-net/aspose.words/document/), który zawsze ma węzeł nadrzędny Brak.

Możesz usunąć węzeł z jego rodzica, wywołując metodę [Node.remove](https://reference.aspose.com/words/python-net/aspose.words/node/remove/). Poniższy przykładowy kod pokazuje, jak uzyskać dostęp do węzła nadrzędnego:

{{< gist "aspose-words-gists" "e9d8f984dac599756ccb4a64b8c79768" "Examples-DocsExamples-DocsExamples-Programming with Documents-working_with_node-GetParentNode.py" >}}

#### Węzły podrzędne

Najbardziej efektywnym sposobem uzyskania dostępu do węzłów podrzędnych [CompositeNode](https://reference.aspose.com/words/python-net/aspose.words/compositenode/) jest użycie właściwości [first_child](https://reference.aspose.com/words/python-net/aspose.words/compositenode/first_child/) i [last_child](https://reference.aspose.com/words/python-net/aspose.words/compositenode/last_child/), które zwracają odpowiednio pierwszy i ostatni węzeł podrzędny. Jeśli nie ma żadnych węzłów podrzędnych, te właściwości zwracają *None*.

[CompositeNode](https://reference.aspose.com/words/python-net/aspose.words/compositenode/) udostępnia także kolekcję [get_child_nodes](https://reference.aspose.com/words/python-net/aspose.words/compositenode/get_child_nodes/) umożliwiającą indeksowany lub wyliczeniowy dostęp do węzłów podrzędnych. Metoda [get_child_nodes](https://reference.aspose.com/words/python-net/aspose.words/compositenode/get_child_nodes/) zwraca aktualną kolekcję węzłów, co oznacza, że przy każdej zmianie dokumentu, na przykład po usunięciu lub dodaniu węzłów, kolekcja **get_child_nodes** jest automatycznie aktualizowana.

Jeśli węzeł nie ma dziecka, metoda **get_child_nodes** zwraca pustą kolekcję. Możesz sprawdzić, czy [CompositeNode](https://reference.aspose.com/words/python-net/aspose.words/compositenode/) zawiera jakiekolwiek węzły podrzędne, korzystając z właściwości [has_child_nodes](https://reference.aspose.com/words/python-net/aspose.words/compositenode/has_child_nodes/).

Poniższy przykład kodu pokazuje, jak wyliczyć bezpośrednie węzły podrzędne [CompositeNode](https://reference.aspose.com/words/python-net/aspose.words/compositenode/) przy użyciu modułu wyliczającego dostarczonego przez kolekcję **get_child_nodes**:

{{< gist "aspose-words-gists" "e9d8f984dac599756ccb4a64b8c79768" "Examples-DocsExamples-DocsExamples-Programming with Documents-working_with_node-EnumerateChildNodes.py" >}}

#### Węzły rodzeństwa

Można uzyskać węzeł bezpośrednio poprzedzający lub następujący po określonym węźle, korzystając odpowiednio z właściwości [previous_sibling](https://reference.aspose.com/words/python-net/aspose.words/node/previous_sibling/) i [next_sibling](https://reference.aspose.com/words/python-net/aspose.words/node/next_sibling/). Jeśli węzeł jest ostatnim dzieckiem swojego rodzica, wówczas właściwością [next_sibling](https://reference.aspose.com/words/python-net/aspose.words/node/next_sibling/) jest *None*. I odwrotnie, jeśli węzeł jest pierwszym dzieckiem swojego rodzica, właściwością [previous_sibling](https://reference.aspose.com/words/python-net/aspose.words/node/previous_sibling/) jest *None*.

Poniższy przykład kodu pokazuje, jak efektywnie odwiedzać wszystkie bezpośrednie i pośrednie węzły podrzędne węzła złożonego:

{{< gist "aspose-words-gists" "e9d8f984dac599756ccb4a64b8c79768" "Examples-DocsExamples-DocsExamples-Programming with Documents-working_with_node-RecurseAllNodes.py" >}}

### Wpisany dostęp do węzłów podrzędnych i nadrzędnych {#typed-access-to-child-and-parent-nodes}

Do tej pory omówiliśmy właściwości zwracające jeden z typów bazowych - [Node](https://reference.aspose.com/words/python-net/aspose.words/node/) lub [CompositeNode](https://reference.aspose.com/words/python-net/aspose.words/compositenode/). Czasami jednak zdarzają się sytuacje, w których może być konieczne rzutowanie wartości na konkretną klasę węzła, taką jak [Run](https://reference.aspose.com/words/python-net/aspose.words/run/) lub [Paragraph](https://reference.aspose.com/words/python-net/aspose.words/paragraph/). Oznacza to, że nie można całkowicie odejść od odlewania podczas pracy z plikiem Aspose.Words DOM, który jest złożony.

Aby zmniejszyć potrzebę rzutowania, większość klas Aspose.Words udostępnia właściwości i kolekcje zapewniające dostęp o jednoznacznie określonym typie. Istnieją trzy podstawowe wzorce dostępu wpisywanego:

- Węzeł nadrzędny udostępnia wpisane właściwości **pierwszy_XXX** i **ostatni_XXX**. Na przykład [Document](https://reference.aspose.com/words/python-net/aspose.words/document/) ma właściwości [first_section](https://reference.aspose.com/words/python-net/aspose.words/document/first_section/) i [last_section](https://reference.aspose.com/words/python-net/aspose.words/document/last_section/). Podobnie [Table](https://reference.aspose.com/words/python-net/aspose.words.tables/table/) ma właściwości takie jak [first_row](https://reference.aspose.com/words/python-net/aspose.words.tables/table/first_row/), [last_row](https://reference.aspose.com/words/python-net/aspose.words.tables/table/last_row/) i inne.
- Węzeł nadrzędny udostępnia wpisaną kolekcję węzłów podrzędnych, takich jak [Document.sections](https://reference.aspose.com/words/python-net/aspose.words/document/sections/), [Body.paragraphs](https://reference.aspose.com/words/python-net/aspose.words/story/paragraphs/) i inne.
- Węzeł podrzędny zapewnia dostęp do swojego rodzica za pomocą wpisania, taki jak [Run.parent_paragraph](https://reference.aspose.com/words/python-net/aspose.words/inline/parent_paragraph/), [Paragraph.parent_section](https://reference.aspose.com/words/python-net/aspose.words/paragraph/parent_section/) i inne.

Wpisane właściwości to jedynie przydatne skróty, które czasami zapewniają łatwiejszy dostęp niż właściwości ogólne odziedziczone z [Node.parent_node](https://reference.aspose.com/words/python-net/aspose.words/node/parent_node/) i [CompositeNode.first_child](https://reference.aspose.com/words/python-net/aspose.words/compositenode/first_child/).

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

{{< gist "aspose-words-gists" "e9d8f984dac599756ccb4a64b8c79768" "Examples-DocsExamples-DocsExamples-Programming with Documents-working_with_node-TypedAccess.py" >}}