XamlReader.ReadSubtree Método
Definição
Importante
Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.
Retorna a XamlReader que é baseado na corrente XamlReader, onde o retornado XamlReader é usado para iterar através de uma subárvore da estrutura do nó 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.XamlReaderPublic Overridable Function ReadSubtree () As XamlReaderDevoluções
Uma nova instância de leitor XAML para a subárvore.
Observações
Este método tem uma implementação por defeito e devolve um válido XamlReader. O retornado XamlReader é uma classe interna que restringe certas XamlReader ações. As restrições são consistentes com o propósito de ler apenas uma subárvore dimensionada de uma fonte maior para um conjunto de nós XAML, e de devolver o fim do ficheiro ou null no nó atual quando a subárvore é encerrada.
Geralmente, deve verificar o nó atual a partir do inicial Read para determinar se precisa de um leitor de subárvores. A forma como verificam isto pode depender de cada implementação; No entanto, evite criar múltiplos leitores de subárvores para cada subárvore. Além disso, evite invocar um leitor de subárvore para certos casos de nós (por exemplo, para NamespaceDeclaration) que não podem conter uma subárvore de nós.
Depois de obter um leitor de subárvore, deve apelá-lo Read para obter um nó atual (ou chamar Skip para obter um próximo nó). Não obtém automaticamente uma posição inicial do nó a partir do leitor de subárvore quando o cria.
O leitor que obtém ao chamar ReadSubtree a partir desta implementação padrão é uma classe interna. A classe interna baseia o seu comportamento na XamlReader implementação que está a ser usada quando ReadSubtree é chamada. O objetivo da classe interna é envolver o Read comportamento geral de percurso. A travessia mantém-se dentro da subárvore pretendida, mantendo o registo de StartMember/EndMember pares ou StartObject/EndObject pares. Também retorna false corretamente para Read e true para IsEof quando o leitor está no final da subárvore, conforme definido pelo seu ponto de entrada. Em geral, assume que qualquer XamlReader API que chame a partir de um leitor de subárvores tem a mesma implementação do geral XamlReader , exceto pelo comportamento de delimitação de travessia.
No entanto, ReadSubtree é virtual. Assim, uma implementação específica XamlReader pode fornecer um comportamento diferente do XamlReader comportamento interno do wrapper; e uma XamlReader implementação pode até desativar a funcionalidade do leitor de subárvores através de exceções retornadas NotImplementedException ou outras.