INodeIterator

INodeIterator interface

Gli iteratori vengono utilizzati per scorrere un insieme di nodi, ad esempio l’insieme di nodi in una NodeList, il sottoalbero del documento governato da un particolare Nodo, i risultati di una query o qualsiasi altro insieme di nodi. L’insieme di nodi da iterare è determinato dall’implementazione di NodeIterator. DOM Level 2 specifica un’implementazione di singolo NodeIterator per l’attraversamento dell’ordine dei documenti di un sottoalbero di documenti. Le istanze di questi iteratori vengono create chiamando DocumentTraversal .createNodeIterator().

Vedi anche ilDocument Object Model (DOM) Livello 2 Traversal and Range Specification. @dal livello DOM 2

public interface INodeIterator : ITraversal

Proprietà

NomeDescrizione
PointerBeforeReferenceNode { get; }Il valore di questo flag determina se i figli dei nodi di riferimento entity sono visibili all’iteratore. Se false, loro e i loro discendenti saranno rifiutati. Nota che questo rifiuto ha la precedenza su whatToShow e il filtro. Nota inoltre che questa è attualmente l’unica situazione in cui NodeIterators può rifiutare un sottoalbero completo invece di saltare i singoli nodi. Per produrre una vista del documento che ha riferimenti a entità espansi e non espone il nodo di riferimento a entità stesso, usa i flag whatToShow a nascondere il riferimento all’entità node e impostare expandEntityReferences su true durante la creazione dell’iteratore . Per produrre una vista del documento che ha nodi entità reference ma nessuna espansione entità, usa whatToShow flags per mostrare il nodo di riferimento entità e imposta expandEntityReferences su false.
ReferenceNode { get; }Il nodo di riferimento corrente.

Metodi

NomeDescrizione
Detach()Stacca il NodeIterator dal set su cui ha ripetuto , rilasciando tutte le risorse di calcolo e ponendo l’iteratore nello stato INVALID. Dopo che il distacco è stato richiamato, chiama nextNode o previousNode solleverà l’eccezione INVALID_STATE_ERR.
NextNode()Restituisce il nodo successivo nel set e fa avanzare la posizione dell’iteratore nel set. Dopo aver creato un NodeIterator, la prima chiamata a nextNode() restituisce il primo nodo in il set.
PreviousNode()Restituisce il nodo precedente nel set e sposta la posizione del NodeIterator all’indietro nel set.

Guarda anche

INodeFilter ITraversal