INodeIterator

INodeIterator interface

Les itérateurs sont utilisés pour parcourir un ensemble de nœuds, par exemple l’ensemble de nœuds dans une NodeList, le sous-arbre de documents régi par un nœud particulier, les résultats d’une requête ou tout autre ensemble de nœuds. L’ensemble de nœuds à itérer est déterminé par l’implémentation de NodeIterator. DOM niveau 2 spécifie une implémentation unique de NodeIterator pour la traversée de l’ordre des documents d’une sous-arborescence de documents. Les instances de ces itérateurs sont créées en appelant DocumentTraversal .createNodeIterator().

Voir aussi leDocument object Model (DOM) Level 2 Traversal and Range Specification. @depuis le niveau DOM 2

public interface INodeIterator : ITraversal

Propriétés

NomLa description
PointerBeforeReferenceNode { get; }La valeur de cet indicateur détermine si les enfants des nœuds de référence entity sont visibles pour l’itérateur. Si faux, ils et leurs descendants seront rejetés. Notez que ce rejet prend priorité sur whatToShow et le filtre. Notez également qu’il s’agit actuellement de la seule situation où NodeIterators peut rejeter une sous-arborescence complète plutôt que ignorer des nœuds individuels. Pour produire une vue du document qui a des références d’entité développées et n’expose pas le nœud de référence d’entité lui-même, utilisez les indicateurs whatToShow pour masquez la référence d’entité node et définissez expandEntityReferences sur true lors de la création de l’itérateur . Pour produire une vue du document qui a des nœuds d’entité reference mais pas d’expansion d’entité, utilisez le whatToShow flags pour afficher le nœud de référence d’entité et set expandEntityReferences sur false.
ReferenceNode { get; }Le nœud de référence actuel.

Méthodes

NomLa description
Detach()Détache le NodeIterator de l’ensemble sur lequel il a itéré , libérant toutes les ressources de calcul et plaçant l’iterator dans l’état INVALID. Une fois que le détachement a été appelé, les appels à nextNode ou previousNode lèveront l’exception INVALID_STATE_ERR.
NextNode()Renvoie le nœud suivant dans l’ensemble et avance la position de l’itérateur dans l’ensemble. Après la création d’un NodeIterator, le premier appel à nextNode() renvoie le premier nœud dans l’ensemble.
PreviousNode()Renvoie le nœud précédent dans l’ensemble et déplace la position du NodeIterator vers l’arrière dans l’ensemble.

Voir également