XamlReader XamlReader XamlReader XamlReader Class

Definición

Proporciona definiciones de base para las clases que usan la entrada de XAML y generan flujos de nodos XAML.Provides base definitions for classes that consume XAML input and produce XAML node streams.

public ref class XamlReader abstract : IDisposable
public abstract class XamlReader : IDisposable
type XamlReader = class
    interface IDisposable
Public MustInherit Class XamlReader
Implements IDisposable
Herencia
XamlReaderXamlReaderXamlReaderXamlReader
Derivado
Implementaciones

Comentarios

XamlReaderes una clase abstracta y no proporciona implementaciones ni definiciones que tengan un resultado de trabajo para todos los miembros.XamlReader is an abstract class and does not provide implementations or definitions that have a working result for all members. Los miembros que tienen una implementación en XamlReader se indican en las notas de ese miembro.Members that do have an implementation in XamlReader are noted in the remarks for that member. En concreto XamlReader , tiene varios miembros abstractos que se deben implementar y varios miembros virtuales.Specifically, XamlReader has several abstract members that must be implemented, and several virtual members.

De los miembros virtuales, ReadSubtree y Skip cada uno proporciona una implementación predeterminada adecuada para la mayoría de los casos.Of the virtual members, ReadSubtree and Skip each provide a default implementation that is appropriate for most cases. Sin embargo, ReadSubtree las Skip implementaciones predeterminadas de y dependen de otro comportamiento esperado del lector XAML de implementación; en concreto, Read se basan en la invalidación.However, the ReadSubtree and Skip default implementations rely on other expected behavior of the implementing XAML reader; in particular, they rely on the Read override. Disposetambién es un miembro virtual que tiene una implementación predeterminada operativa.Dispose is also a virtual member that has a working default implementation.

Las dos clases siguientes son las clases derivadas más relevantes y prácticas en .NET Framework los servicios XAML y el ensamblado System. XAML:The following two classes are the most relevant and practical derived classes in .NET Framework XAML Services and the System.Xaml assembly:

  • XamlObjectReader, que lee un gráfico de objetos, como el gráfico de objetos activos de una aplicación en tiempo de ejecución.XamlObjectReader, which reads an object graph, such as the active object graph of an application at run time.

  • XamlXmlReader, que lee XAML en forma de archivo de texto XML utilizando un general XmlReader que carga el archivo como una clase auxiliar intermediaria.XamlXmlReader, which reads XAML in the form of a XML text file by using a general XmlReader that loads the file as an intermediary helper class.

Otros lectores XAML de otros marcos de trabajo Baml2006Reader incluyen XamlDebuggerXmlReadery.Other XAML readers from other frameworks include Baml2006Reader and XamlDebuggerXmlReader.

XamlReaderdifiere de Modelo de objetos de documento (DOM) XMLXML Document Object Model (DOM) los XmlReader principios de diseño XamlReader de y porque no Create tiene un método para devolver implementaciones de lector XAML predeterminadas subyacentes.XamlReader differs from Modelo de objetos de documento (DOM) XMLXML Document Object Model (DOM) and XmlReader design principles because XamlReader does not have a Create method to return underlying default XAML reader implementations. En su lugar, debe crear instancias de clases de lector XAML derivadas específicas llamando a sus constructores u otras API auxiliares específicas de la clase.You must instead instantiate specific derived XAML reader classes by calling their constructors or other class-specific helper APIs.

Lectores de subárbolSubtree Readers

En su mayor parte, se llama XamlReader a la API en el contexto de clases específicas del lector XAML XamlReaderque derivan de.For the most part, you call XamlReader API in the context of specific XAML reader classes that derive from XamlReader. Sin embargo, en un caso concreto, se XamlReader tiene acceso a la API en una instancia de lector de XAML práctico que no XamlObjectReader es XamlXmlReaderpública y no se deriva de o.However, in one particular case, you access XamlReader API on a practical XAML reader instance that is not public and not derived from XamlObjectReader or XamlXmlReader. Este caso es cuando se llama ReadSubtreea, que devuelve XamlReader una instancia de.This case is when you call ReadSubtree, which returns a XamlReader instance. En la implementación predeterminada, el XamlReader devuelto por esta API es una clase interna.In the default implementation, the XamlReader that is returned by this API is an internal class.

El XamlReader obtenido para la lectura de subárbol tiene acciones válidas para Read las NodeTypeAPI como y, y esas acciones se basan en la clase lector principal.The XamlReader obtained for subtree reading has valid actions for APIs such as Read and NodeType, and those actions are based on the parent reader class. Este diseño permite que la clase interna realice un seguimiento del nivel de marco en el que se escribió el subárbol.This design enables the internal class to track the frame level where the subtree was entered. El subárbol XamlReader que actúa se asegura de que si la posición del nodo actual se mueve más allá de los límites del subárbol, el lector de subárbol específico informa del final null del archivo o del nodo actual.The acting subtree XamlReader makes sure that if the current node position is moved beyond the bounds of the subtree, the specific subtree reader reports end-of-file or null at the current node.

Las notas sobre el uso del lector de subárbol XamlReader se incluyen en ciertas API.Notes about subtree reader usage are included on certain XamlReader APIs.

Constructores

XamlReader() XamlReader() XamlReader() XamlReader()

Inicializa la clase XamlReader.Initializes the XamlReader class.

Propiedades

IsDisposed IsDisposed IsDisposed IsDisposed

Obtiene un valor que indica si se ha llamado al método Dispose(Boolean).Gets whether Dispose(Boolean) has been called.

IsEof IsEof IsEof IsEof

Cuando se implementa en una clase derivada, obtiene un valor que notifica si la posición del lector está al final del archivo.When implemented in a derived class, gets a value that reports whether the reader position is at end-of-file.

Member Member Member Member

Cuando se implementa en una clase derivada, obtiene el miembro actual situado en la posición del lector, si la posición del lector está en un miembro StartMember.When implemented in a derived class, gets the current member at the reader position, if the reader position is on a StartMember.

Namespace Namespace Namespace Namespace

Cuando se implementa en una clase derivada, obtiene la información del espacio de nombres XAML del nodo actual.When implemented in a derived class, gets the XAML namespace information from the current node.

NodeType NodeType NodeType NodeType

Cuando se implementa en una clase derivada, obtiene el tipo del nodo actual.When implemented in a derived class, gets the type of the current node.

SchemaContext SchemaContext SchemaContext SchemaContext

Cuando se implementa en una clase derivada, obtiene un objeto que proporciona información sobre el contexto de esquema XAML del conjunto de información.When implemented in a derived class, gets an object that provides XAML schema context information for the information set.

Type Type Type Type

Cuando se implementa en una clase derivada, obtiene el objeto XamlType del nodo actual.When implemented in a derived class, gets the XamlType of the current node.

Value Value Value Value

Cuando se implementa en una clase derivada, obtiene el valor del nodo actual.When implemented in a derived class, gets the value of the current node.

Métodos

Close() Close() Close() Close()

Cierra el flujo de nodos XAML.Closes the XAML node stream.

Dispose(Boolean) Dispose(Boolean) Dispose(Boolean) Dispose(Boolean)

Libera los recursos no administrados que usa XamlReader y, de forma opcional, libera los recursos administrados.Releases the unmanaged resources used by the XamlReader, and optionally, releases the managed resources.

Equals(Object) Equals(Object) Equals(Object) Equals(Object)

Determina si el objeto especificado es igual al objeto actual.Determines whether the specified object is equal to the current object.

(Inherited from Object)
GetHashCode() GetHashCode() GetHashCode() GetHashCode()

Sirve como la función hash predeterminada.Serves as the default hash function.

(Inherited from Object)
GetType() GetType() GetType() GetType()

Obtiene el Type de la instancia actual.Gets the Type of the current instance.

(Inherited from Object)
MemberwiseClone() MemberwiseClone() MemberwiseClone() MemberwiseClone()

Crea una copia superficial del objeto Object actual.Creates a shallow copy of the current Object.

(Inherited from Object)
Read() Read() Read() Read()

Cuando se implementa en una clase derivada, proporciona el siguiente nodo XAML del origen, si hay alguno disponible.When implemented in a derived class, provides the next XAML node from the source, if a node is available.

ReadSubtree() ReadSubtree() ReadSubtree() ReadSubtree()

Devuelve un objeto XamlReader que se basa en el objeto XamlReader actual, donde el objeto XamlReader devuelto se usa para recorrer en iteración un subárbol de la estructura de nodos XAML.Returns a XamlReader that is based on the current XamlReader, where the returned XamlReader is used to iterate through a subtree of the XAML node structure.

Skip() Skip() Skip() Skip()

Omite el nodo actual y avanza la posición del lector hasta el nodo siguiente.Skips the current node and advances the reader position to the next node.

ToString() ToString() ToString() ToString()

Devuelve una cadena que representa el objeto actual.Returns a string that represents the current object.

(Inherited from Object)

Implementaciones de interfaz explícitas

IDisposable.Dispose() IDisposable.Dispose() IDisposable.Dispose() IDisposable.Dispose()

Libera todos los recursos usados por la instancia actual de la clase XamlReader.Releases all resources used by the current instance of the XamlReader class.

Se aplica a

Consulte también: