XamlReader.ReadSubtree Метод

Определение

Пространство имен:

System.Xaml

Сборка:

System.Xaml.dll

Возвращает объект XamlReader , основанный на текущем XamlReader, где возвращаемый XamlReader используется для итерации через поддерев структуры узла XAML.

public:
 virtual System::Xaml::XamlReader ^ ReadSubtree();

public virtual System.Xaml.XamlReader ReadSubtree();

abstract member ReadSubtree : unit -> System.Xaml.XamlReader
override this.ReadSubtree : unit -> System.Xaml.XamlReader

Public Overridable Function ReadSubtree () As XamlReader

Возвращаемое значение

XamlReader

Новый экземпляр средства чтения XAML для поддерев.

Комментарии

Этот метод имеет реализацию по умолчанию и возвращает допустимое XamlReaderзначение. Возвращенный XamlReader класс — это внутренний класс, ограничивающий определенные XamlReader действия. Ограничения согласуются с целью чтения только размерного поддерева большого источника для набора узлов XAML, а также возврата конца файла или null текущего узла при выходе поддерев.

Как правило, необходимо проверить текущий узел с начальной Read точки, чтобы определить, требуется ли средство чтения поддерев. Как проверить это может быть конкретной реализацией; однако избегайте создания нескольких модулей чтения поддерев для каждого поддеревного дерева. Кроме того, избегайте вызова средства чтения поддерев для определенных вариантов узлов (например, для NamespaceDeclaration), которые не могут содержать поддерев узлов.

После получения средства чтения поддерев необходимо вызвать Read его для получения текущего узла (или вызова Skip для получения следующего узла). При создании не получается начальное положение узла из средства чтения поддерев.

Средство чтения, полученное путем вызова ReadSubtree из этой реализации по умолчанию, является внутренним классом. Внутренний класс основывает свое поведение на реализации, используемой XamlReader при ReadSubtree вызове. Цель внутреннего класса заключается в том, чтобы упаковать Read и общее поведение обхода. Обход остается в предполагаемом поддереве путем отслеживания StartMember/EndMember пар или StartObject/EndObject пар. Он также правильно возвращает falseRead значение и true для IsEof того, когда средство чтения находится в конце поддерев, как определено его точкой входа. В общем случае предполагается, что любой api, XamlReader который вы вызываете из средства чтения поддерев, имеет ту же реализацию, что и общее XamlReader , за исключением поведения обхода ограничивающего режима.

ReadSubtree Однако это виртуальная. Таким образом, определенная XamlReader реализация может обеспечить поведение, которое отличается от XamlReader поведения внутренней оболочки. Реализация XamlReader может даже отключить функции чтения поддерев, возвращая NotImplementedException или другие исключения.