System::Xml::XmlReader class

XmlReader class

Representa un lector que proporciona acceso rápido, sin caché y solo de avance a los datos XML.

class XmlReader : public System::IDisposable

Métodos

Método	Descripción
virtual Close()	Cuando se sobrescribe en una clase derivada, cambia el XmlReader::get_ReadState a ReadState::Closed.
static Create(const String&)	Crea una nueva instancia de XmlReader con la URI especificada.
static Create(const String&, const SharedPtr<XmlReaderSettings>&)	Crea una nueva instancia de XmlReader usando la URI y la configuración especificadas.
static Create(const String&, SharedPtr<XmlReaderSettings>, const SharedPtr<XmlParserContext>&)	Crea una nueva instancia de XmlReader usando la URI, la configuración y la información de contexto para el análisis.
static Create(const SharedPtr<IO::Stream>&)	Crea una nueva instancia de XmlReader usando el flujo especificado con la configuración predeterminada.
static Create(const SharedPtr<IO::Stream>&, const SharedPtr<XmlReaderSettings>&)	Crea una nueva instancia de XmlReader con el flujo y la configuración especificados.
static Create(const SharedPtr<IO::Stream>&, SharedPtr<XmlReaderSettings>, const String&)	Crea una nueva instancia de XmlReader usando el flujo, la URI base y la configuración especificados.
static Create(const SharedPtr<IO::Stream>&, SharedPtr<XmlReaderSettings>, const SharedPtr<XmlParserContext>&)	Crea una nueva instancia de XmlReader usando el flujo, la configuración y la información de contexto para el análisis.
static Create(const SharedPtr<IO::TextReader>&)	Crea una nueva instancia de XmlReader usando el lector de texto especificado.
static Create(const SharedPtr<IO::TextReader>&, const SharedPtr<XmlReaderSettings>&)	Crea una nueva instancia de XmlReader usando el lector de texto y la configuración especificados.
static Create(const SharedPtr<IO::TextReader>&, SharedPtr<XmlReaderSettings>, const String&)	Crea una nueva instancia de XmlReader usando el lector de texto, la configuración y la URI base especificados.
static Create(const SharedPtr<IO::TextReader>&, SharedPtr<XmlReaderSettings>, const SharedPtr<XmlParserContext>&)	Crea una nueva instancia de XmlReader usando el lector de texto, la configuración y la información de contexto para el análisis.
static Create(const SharedPtr<XmlReader>&, SharedPtr<XmlReaderSettings>)	Crea una nueva instancia de XmlReader usando el lector XML y la configuración especificados.
Dispose() override	Libera todos los recursos utilizados por la instancia actual de la clase XmlReader.
virtual get_AttributeCount()	Cuando se sobrescribe en una clase derivada, obtiene el número de atributos del nodo actual.
virtual get_BaseURI()	Cuando se sobrescribe en una clase derivada, obtiene la URI base del nodo actual.
virtual get_CanReadBinaryContent()	Devuelve un valor que indica si el XmlReader implementa los métodos de lectura de contenido binario.
virtual get_CanReadValueChunk()	Devuelve un valor que indica si el XmlReader implementa el método XmlReader::ReadValueChunk.
virtual get_CanResolveEntity()	Devuelve un valor que indica si este lector puede analizar y resolver entidades.
virtual get_Depth()	Cuando se sobrescribe en una clase derivada, obtiene la profundidad del nodo actual en el documento XML.
virtual get_EOF()	Cuando se sobrescribe en una clase derivada, obtiene un valor que indica si el lector está posicionado al final del flujo.
virtual get_HasAttributes()	Devuelve un valor que indica si el nodo actual tiene atributos.
virtual get_HasValue()	Cuando se sobrescribe en una clase derivada, obtiene un valor que indica si el nodo actual puede tener un valor de XmlReader::get_Value.
virtual get_IsDefault()	Cuando se sobrescribe en una clase derivada, obtiene un valor que indica si el nodo actual es un atributo generado a partir del valor predeterminado definido en el DTD o esquema.
virtual get_IsEmptyElement()	Cuando se sobrescribe en una clase derivada, obtiene un valor que indica si el nodo actual es un elemento vacío (por ejemplo, ).
virtual get_LocalName()	Cuando se sobrescribe en una clase derivada, obtiene el nombre local del nodo actual.
virtual get_Name()	Cuando se sobrescribe en una clase derivada, obtiene el nombre calificado del nodo actual.
virtual get_NamespaceURI()	Cuando se sobrescribe en una clase derivada, obtiene la URI del espacio de nombres (según lo definido en la especificación de espacios de nombres de W3C) del nodo en el que está posicionado el lector.
virtual get_NameTable()	Cuando se sobrescribe en una clase derivada, obtiene la XmlNameTable asociada con esta implementación.
virtual get_NodeType()	Cuando se sobrescribe en una clase derivada, obtiene el tipo del nodo actual.
virtual get_Prefix()	Cuando se sobrescribe en una clase derivada, obtiene el prefijo de espacio de nombres asociado al nodo actual.
virtual get_QuoteChar()	Cuando se sobrescribe en una clase derivada, obtiene el carácter de comilla utilizado para encerrar el valor de un nodo de atributo.
virtual get_ReadState()	Cuando se sobrescribe en una clase derivada, obtiene el estado del lector.
virtual get_SchemaInfo()	Devuelve la información del esquema que se ha asignado al nodo actual como resultado de la validación del esquema.
virtual get_Settings()	Devuelve el objeto XmlReaderSettings utilizado para crear esta instancia de XmlReader.
virtual get_Value()	Cuando se sobrescribe en una clase derivada, obtiene el valor de texto del nodo actual.
virtual get_ValueType()	Devuelve el tipo del nodo actual.
virtual get_XmlLang()	Cuando se sobrescribe en una clase derivada, obtiene el alcance actual de xml:lang.
virtual get_XmlSpace()	Cuando se sobrescribe en una clase derivada, obtiene el alcance actual de xml:space.
virtual GetAttribute(String)	Cuando se sobrescribe en una clase derivada, obtiene el valor del atributo con el valor especificado de XmlReader::get_Name.
virtual GetAttribute(String, String)	Cuando se sobrescribe en una clase derivada, obtiene el valor del atributo con los valores especificados de XmlReader::get_LocalName y XmlReader::get_NamespaceURI.
virtual GetAttribute(int32_t)	Cuando se sobrescribe en una clase derivada, obtiene el valor del atributo con el índice especificado.
virtual idx_get(int32_t)	Cuando se sobrescribe en una clase derivada, obtiene el valor del atributo con el índice especificado.
virtual idx_get(String)	Cuando se sobrescribe en una clase derivada, obtiene el valor del atributo con el valor especificado de XmlReader::get_Name.
virtual idx_get(String, String)	Cuando se sobrescribe en una clase derivada, obtiene el valor del atributo con los valores especificados de XmlReader::get_LocalName y XmlReader::get_NamespaceURI.
static IsName(const String&)	Devuelve un valor que indica si el argumento de cadena es un nombre XML válido.
static IsNameToken(const String&)	Devuelve un valor que indica si el argumento de cadena es o no un token de nombre XML válido.
virtual IsStartElement()	Llama a XmlReader::MoveToContent y verifica si el nodo de contenido actual es una etiqueta de inicio o una etiqueta de elemento vacío.
virtual IsStartElement(String)	Llama a XmlReader::MoveToContent y verifica si el nodo de contenido actual es una etiqueta de inicio o una etiqueta de elemento vacío y si el valor de XmlReader::get_Name del elemento encontrado coincide con el argumento proporcionado.
virtual IsStartElement(String, String)	Llama a XmlReader::MoveToContent y verifica si el nodo de contenido actual es una etiqueta de inicio o una etiqueta de elemento vacío y si los valores de XmlReader::get_LocalName y XmlReader::get_NamespaceURI del elemento encontrado coinciden con las cadenas proporcionadas.
virtual LookupNamespace(const String&)	Cuando se sobrescribe en una clase derivada, resuelve un prefijo de espacio de nombres en el alcance del elemento actual.
virtual MoveToAttribute(String)	Cuando se sobrescribe en una clase derivada, se desplaza al atributo con el valor especificado de XmlReader::get_Name.
virtual MoveToAttribute(String, String)	Cuando se sobrescribe en una clase derivada, se desplaza al atributo con los valores especificados de XmlReader::get_LocalName y XmlReader::get_NamespaceURI.
virtual MoveToAttribute(int32_t)	Cuando se sobrescribe en una clase derivada, se desplaza al atributo con el índice especificado.
virtual MoveToContent()	Comprueba si el nodo actual es un nodo de contenido (texto que no es espacio en blanco, CDATA, Element, EndElement, EntityReference o EndEntity). Si el nodo no es un nodo de contenido, el lector avanza hasta el siguiente nodo de contenido o el final del archivo. Omite los nodos del siguiente tipo: ProcessingInstruction, DocumentType, Comment, Whitespace o SignificantWhitespace.
virtual MoveToElement()	Cuando se sobrescribe en una clase derivada, se desplaza al elemento que contiene el nodo de atributo actual.
virtual MoveToFirstAttribute()	Cuando se sobrescribe en una clase derivada, se desplaza al primer atributo.
virtual MoveToNextAttribute()	Cuando se sobrescribe en una clase derivada, se desplaza al siguiente atributo.
virtual Read()	Cuando se sobrescribe en una clase derivada, lee el siguiente nodo del flujo.
virtual ReadAttributeValue()	Cuando se sobrescribe en una clase derivada, analiza el valor del atributo en uno o más nodos Text, EntityReference o EndEntity.
virtual ReadContentAs(const TypeInfo&, SharedPtr<IXmlNamespaceResolver>)	Lee el contenido como un objeto del tipo especificado.
virtual ReadContentAsBase64(ArrayPtr<uint8_t>, int32_t, int32_t)	Lee el contenido y devuelve los bytes binarios decodificados en Base64.
virtual ReadContentAsBinHex(ArrayPtr<uint8_t>, int32_t, int32_t)	Lee el contenido y devuelve los bytes binarios decodificados en BinHex.
virtual ReadContentAsBoolean()	Lee el contenido de texto en la posición actual como un Boolean.
virtual ReadContentAsDateTime()	Lee el contenido de texto en la posición actual como un objeto DateTime.
virtual ReadContentAsDateTimeOffset()	Lee el contenido de texto en la posición actual como un objeto DateTimeOffset.
virtual ReadContentAsDecimal()	Lee el contenido de texto en la posición actual como un objeto Decimal.
virtual ReadContentAsDouble()	Lee el contenido de texto en la posición actual como un número de punto flotante de doble precisión.
virtual ReadContentAsFloat()	Lee el contenido de texto en la posición actual como un número de punto flotante de precisión simple.
virtual ReadContentAsInt()	Lee el contenido de texto en la posición actual como un entero con signo de 32 bits.
virtual ReadContentAsLong()	Lee el contenido de texto en la posición actual como un entero con signo de 64 bits.
virtual ReadContentAsObject()	Lee el contenido de texto en la posición actual como un Object.
virtual ReadContentAsString()	Lee el contenido de texto en la posición actual como un objeto String.
virtual ReadElementContentAs(const TypeInfo&, SharedPtr<IXmlNamespaceResolver>)	Lee el contenido del elemento como el tipo solicitado.
virtual ReadElementContentAs(const TypeInfo&, SharedPtr<IXmlNamespaceResolver>, String, String)	Comprueba que el nombre local y el URI del espacio de nombres especificados coinciden con los del elemento actual, y luego lee el contenido del elemento como el tipo solicitado.
virtual ReadElementContentAsBase64(ArrayPtr<uint8_t>, int32_t, int32_t)	Lee el elemento y decodifica el contenido Base64.
virtual ReadElementContentAsBinHex(ArrayPtr<uint8_t>, int32_t, int32_t)	Lee el elemento y decodifica el contenido BinHex.
virtual ReadElementContentAsBoolean()	Lee el elemento actual y devuelve el contenido como un objeto Boolean.
virtual ReadElementContentAsBoolean(String, String)	Comprueba que el nombre local y el URI del espacio de nombres especificados coinciden con los del elemento actual, y luego lee el elemento actual y devuelve el contenido como un objeto Boolean.
virtual ReadElementContentAsDateTime()	Lee el elemento actual y devuelve el contenido como un objeto DateTime.
virtual ReadElementContentAsDateTime(String, String)	Comprueba que el nombre local y el URI del espacio de nombres especificados coinciden con los del elemento actual, y luego lee el elemento actual y devuelve el contenido como un objeto DateTime.
virtual ReadElementContentAsDecimal()	Lee el elemento actual y devuelve el contenido como un objeto Decimal.
virtual ReadElementContentAsDecimal(String, String)	Comprueba que el nombre local y el URI del espacio de nombres especificados coinciden con los del elemento actual, y luego lee el elemento actual y devuelve el contenido como un objeto Decimal.
virtual ReadElementContentAsDouble()	Lee el elemento actual y devuelve el contenido como un número de punto flotante de doble precisión.
virtual ReadElementContentAsDouble(String, String)	Comprueba que el nombre local y el URI del espacio de nombres especificados coinciden con los del elemento actual, luego lee el elemento actual y devuelve el contenido como un número de punto flotante de doble precisión.
virtual ReadElementContentAsFloat()	Lee el elemento actual y devuelve el contenido como un número de punto flotante de precisión simple.
virtual ReadElementContentAsFloat(String, String)	Comprueba que el nombre local y el URI del espacio de nombres especificados coinciden con los del elemento actual, luego lee el elemento actual y devuelve el contenido como un número de punto flotante de precisión simple.
virtual ReadElementContentAsInt()	Lee el elemento actual y devuelve el contenido como un entero con signo de 32 bits.
virtual ReadElementContentAsInt(String, String)	Comprueba que el nombre local y el URI del espacio de nombres especificados coinciden con los del elemento actual, luego lee el elemento actual y devuelve el contenido como un entero con signo de 32 bits.
virtual ReadElementContentAsLong()	Lee el elemento actual y devuelve el contenido como un entero con signo de 64 bits.
virtual ReadElementContentAsLong(String, String)	Comprueba que el nombre local y el URI del espacio de nombres especificados coinciden con los del elemento actual, luego lee el elemento actual y devuelve el contenido como un entero con signo de 64 bits.
virtual ReadElementContentAsObject()	Lee el elemento actual y devuelve el contenido como un Object.
virtual ReadElementContentAsObject(String, String)	Comprueba que el nombre local y el URI del espacio de nombres especificados coinciden con los del elemento actual, luego lee el elemento actual y devuelve el contenido como un Object.
virtual ReadElementContentAsString()	Lee el elemento actual y devuelve el contenido como un objeto String.
virtual ReadElementContentAsString(String, String)	Comprueba que el nombre local y el URI del espacio de nombres especificados coinciden con los del elemento actual, luego lee el elemento actual y devuelve el contenido como un objeto String.
virtual ReadElementString()	Lee un elemento solo de texto. Sin embargo, se recomienda usar el método XmlReader::ReadElementContentAsString en su lugar, porque proporciona una forma más directa de manejar esta operación.
virtual ReadElementString(String)	Comprueba que el valor XmlReader::get_Name del elemento encontrado coincida con la cadena proporcionada antes de leer un elemento solo de texto. Sin embargo, se recomienda usar el método XmlReader::ReadElementContentAsString en su lugar, porque proporciona una forma más directa de manejar esta operación.
virtual ReadElementString(String, String)	Comprueba que los valores XmlReader::get_LocalName y XmlReader::get_NamespaceURI del elemento encontrado coincidan con las cadenas proporcionadas antes de leer un elemento solo de texto. Sin embargo, se recomienda usar el método XmlReader::ReadElementContentAsString en su lugar, porque proporciona una forma más directa de manejar esta operación.
virtual ReadEndElement()	Comprueba que el nodo de contenido actual sea una etiqueta de cierre y avanza el lector al siguiente nodo.
virtual ReadInnerXml()	Cuando se sobrescribe en una clase derivada, lee todo el contenido, incluido el marcado, como una cadena.
virtual ReadOuterXml()	Cuando se sobrescribe en una clase derivada, lee el contenido, incluido el marcado, que representa este nodo y todos sus hijos.
virtual ReadStartElement()	Comprueba que el nodo actual sea un elemento y avanza el lector al siguiente nodo.
virtual ReadStartElement(String)	Comprueba que el nodo de contenido actual sea un elemento con el valor XmlReader::get_Name proporcionado y avanza el lector al siguiente nodo.
virtual ReadStartElement(String, String)	Comprueba que el nodo de contenido actual sea un elemento con los valores XmlReader::get_LocalName y XmlReader::get_NamespaceURI proporcionados y avanza el lector al siguiente nodo.
virtual ReadString()	Cuando se sobrescribe en una clase derivada, lee el contenido de un elemento o nodo de texto como una cadena. Sin embargo, se recomienda usar el método XmlReader::ReadElementContentAsString en su lugar, porque proporciona una forma más directa de manejar esta operación.
virtual ReadSubtree()	Devuelve una nueva instancia de XmlReader que puede usarse para leer el nodo actual y todos sus descendientes.
virtual ReadToDescendant(String)	Avanza el XmlReader al siguiente elemento descendiente con el nombre calificado especificado.
virtual ReadToDescendant(String, String)	Avanza el XmlReader al siguiente elemento descendiente con el nombre local y el URI del espacio de nombres especificados.
virtual ReadToFollowing(String)	Lee hasta que se encuentre un elemento con el nombre calificado especificado.
virtual ReadToFollowing(String, String)	Lee hasta que se encuentre un elemento con el nombre local y el URI de espacio de nombres especificados.
virtual ReadToNextSibling(String)	Avanza el XmlReader al siguiente elemento hermano con el nombre calificado especificado.
virtual ReadToNextSibling(String, String)	Avanza el XmlReader al siguiente elemento hermano con el nombre local y el URI de espacio de nombres especificados.
virtual ReadValueChunk(ArrayPtr<char16_t>, int32_t, int32_t)	Lee flujos grandes de texto incrustados en un documento XML.
virtual ResolveEntity()	Cuando se sobrescribe en una clase derivada, resuelve la referencia de entidad para los nodos EntityReference.
virtual Skip()	Omite los hijos del nodo actual.

Typedefs

Typedef	Descripción
Ptr	Un alias para un puntero compartido a una instancia de esta clase.

Ver también

Clase System::Xml::XmlQualifiedName Clase System::Xml::XmlReaderSettings