Navigation

Navigation

Aspose.Words FOSS pour .NET inclut un petit Nodes.Navigation espace de noms pour itérer et positionner au sein de l’arbre de nœuds d’un document : NodeEnumerator, le type d’énumérateur derrière l’itération de type for-each sur les nœuds enfants, et DocumentPositionMovement, une énumération décrivant comment la position d’un nœud se rapporte à celle d’un autre lors du parcours. Cela diffère des API de manipulation d’arbre (insertion, suppression et réorganisation des nœuds) couvertes sur le Nodes page — cette page porte sur le déplacement et la comparaison des positions dans un arbre déjà existant.

Itération des nœuds enfants

Tout CompositeNode (la classe de base pour les nœuds conteneurs tels que Document, Section, Body et Paragraph) prend en charge l’itération de style for-each sur ses enfants immédiats via GetEnumerator(), qui — selon sa documentation — fournit le support de l’itération de style for-each sur les nœuds enfants d’un nœud. L’énumérateur retourné implémente IEnumerator<Node>; dans cette surface API, ce rôle est assuré par NodeEnumerator, qui implémente également IDocumentPositionListener afin de pouvoir suivre les changements de position pendant que l’arbre sous-jacent est énuméré. NodeEnumerator expose les membres standards Dispose() et Reset() ainsi que le contrat IEnumerator<Node>.

Déplacement de position du document

DocumentPositionMovement est une énumération comportant six membres — None, Inside, StartEnd, Sibling, Above et Below — représentant la façon dont une position dans le document se rapporte à une autre lors de la navigation dans l’arbre: qu’elle soit inchangée, déplacée à l’intérieur d’un nœud, déplacée vers une frontière de début/fin, déplacée vers un nœud frère, ou déplacée au-dessus ou en dessous de la position de référence. Elle est définie aux côtés de NodeEnumerator dans la même zone Nodes.Navigation de la surface API, reflétant son rôle dans le suivi des changements de position pendant l’énumération.

Conseils et bonnes pratiques

• Utilisez un C# foreach standard sur tout CompositeNode (ou appelez GetEnumerator() directement) pour parcourir les enfants immédiats d’un nœud — l’énumérateur gère le contrat IEnumerator<Node> pour vous.
• Étant donné que NodeEnumerator implémente également IDocumentPositionListener, évitez de mettre en cache un énumérateur lors de modifications structurelles de l’arbre; récupérez-le à nouveau via GetEnumerator() si la collection de nœuds que vous parcourez a changé.
• Pour des parcours d’arbre en profondeur (pas seulement les enfants immédiats), utilisez Node.NextPreOrder(rootNode) / PreviousPreOrder(rootNode), ou GetChildNodes(nodeType, isDeep) avec isDeep défini sur true, plutôt que d’imbriquer manuellement les énumérateurs.

Problèmes courants

FAQ

Ai-je besoin d’utiliser NodeEnumerator directement?

Pas habituellement — un C# foreach standard sur un CompositeNode l’utilise implicitement via GetEnumerator(). Recourez à lui directement uniquement lorsque vous avez besoin d’un contrôle explicite sur Dispose()/Reset().

Que décrit DocumentPositionMovement?

La relation entre deux positions dans l’arbre du document lors de la navigation — None, Inside, StartEnd, Sibling, Above ou Below.

En quoi cela diffère-t-il des API de manipulation d’arbre sur la page Nodes?

Le Nodes La page couvre l’insertion, la suppression, le clonage et la réorganisation des nœuds. Cette page couvre le parcours en lecture seule et le positionnement au sein d’un arbre déjà existant.

API Reference Résumé

Voir aussi

• Aspose.Words for .NET — Enterprise Documentation