INodeIterator

INodeIterator interface

Итераторы используются для перехода через набор узлов, например, набор узлов в списке узлов, поддерево документа, управляемое конкретным узлом, результаты запроса или любой другой набор узлов . Набор итерируемых узлов определяется реализацией NodeIterator. DOM уровня 2 определяет одиночную реализацию NodeIterator для обхода поддерева документа в порядке документа. Экземпляры этих итераторов создаются путем вызова DocumentTraversal .createNodeIterator().

См. такжеМодель объекта документа (DOM) Уровень 2 Спецификация обхода и диапазона. @с уровня DOM 2

public interface INodeIterator : ITraversal

Характеристики

ИмяОписание
PointerBeforeReferenceNode { get; }Значение этого флага определяет, видны ли итератору потомки ссылочных узлов entity . Если false, они и их потомки будут отклонены. Обратите внимание, что это отклонение имеет приоритет над whatToShow и фильтром. Также обратите внимание на то, что в настоящее время это единственная ситуация, когда NodeIterators может отклонить полное поддерево, а не пропустить отдельные узлы. скройте ссылку на сущность node и установите для параметра expandEntityReferences значение true при создании итератора . Чтобы создать представление документа с узлами ссылки на сущность , но без расширения сущности, используйте флаги whatToShow для отображения узла ссылки на сущность и установите для свойства expandEntityReferences значение false.
ReferenceNode { get; }Текущий опорный узел.

Методы

ИмяОписание
Detach()Отсоединяет NodeIterator от набора, по которому он выполнял итерацию , освобождая все вычислительные ресурсы и переводя итератор в состояние INVALID. После вызова detach вызовы nextNode или previousNode будут вызывать исключение INVALID_STATE_ERR.
NextNode()Возвращает следующий узел в наборе и продвигает позицию итератора в наборе. После создания NodeIterator первый вызов nextNode() возвращает первый узел в наборе.
PreviousNode()Возвращает предыдущий узел в наборе и перемещает позицию NodeIterator назад в наборе.

Смотрите также

INodeFilter ITraversal