Clase System::Xml::XmlTextReader

XmlTextReader class

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

class XmlTextReader : public System::Xml::XmlReader,
                      public System::Xml::IXmlLineInfo,
                      public System::Xml::IXmlNamespaceResolver

Métodos

MétodoDescripción
Close() overrideCambia el XmlReader::get_ReadState a Closed.
get_AttributeCount() overrideDevuelve el número de atributos del nodo actual.
get_BaseURI() overrideDevuelve el URI base del nodo actual.
get_CanReadBinaryContent() overrideDevuelve un valor que indica si el XmlTextReader implementa los métodos de lectura de contenido binario.
get_CanReadValueChunk() overrideDevuelve un valor que indica si el XmlTextReader implementa el método XmlReader::ReadValueChunk.
get_CanResolveEntity() overrideDevuelve un valor que indica si este lector puede analizar y resolver entidades.
get_Depth() overrideDevuelve la profundidad del nodo actual en el documento XML.
get_DtdProcessing()Devuelve la enumeración DtdProcessing.
get_Encoding()Devuelve la codificación del documento.
get_EntityHandling()Devuelve un valor que especifica cómo el lector maneja las entidades.
get_EOF() overrideDevuelve un valor que indica si el lector está posicionado al final del flujo.
get_HasValue() overrideDevuelve un valor que indica si el nodo actual puede tener un XmlTextReader::get_Value distinto de String::Empty.
get_IsDefault() overrideDevuelve un valor que indica si el nodo actual es un atributo que fue generado a partir del valor predeterminado definido en el DTD o esquema.
get_IsEmptyElement() overrideDevuelve un valor que indica si el nodo actual es un elemento vacío (por ejemplo, ).
get_LineNumber() overrideDevuelve el número de línea actual.
get_LinePosition() overrideDevuelve la posición de línea actual.
get_LocalName() overrideDevuelve el nombre local del nodo actual.
get_Name() overrideDevuelve el nombre calificado del nodo actual.
get_Namespaces()Devuelve un valor que indica si se debe habilitar el soporte de espacios de nombres.
get_NamespaceURI() overrideDevuelve el 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.
get_NameTable() overrideDevuelve la XmlNameTable asociada con esta implementación.
get_NodeType() overrideDevuelve el tipo del nodo actual.
get_Normalization()Devuelve un valor que indica si se debe normalizar los espacios en blanco y los valores de los atributos.
get_Prefix() overrideDevuelve el prefijo del espacio de nombres asociado con el nodo actual.
get_ProhibitDtd()Devuelve un valor que indica si se permite el procesamiento de DTD.
get_QuoteChar() overrideDevuelve el carácter de comilla utilizado para encerrar el valor de un nodo de atributo.
get_ReadState() overrideDevuelve el estado del lector.
get_Value() overrideDevuelve el valor de texto del nodo actual.
get_WhitespaceHandling()Devuelve un valor que especifica cómo se manejan los espacios en blanco.
get_XmlLang() overrideDevuelve el alcance actual de xml:lang.
get_XmlSpace() overrideDevuelve el alcance actual de xml:space.
GetAttribute(String) overrideDevuelve el valor del atributo con el nombre especificado.
GetAttribute(String, String) overrideDevuelve el valor del atributo con el nombre local y el URI del espacio de nombres especificados.
GetAttribute(int32_t) overrideDevuelve el valor del atributo con el índice especificado.
GetNamespacesInScope(XmlNamespaceScope) overrideDevuelve una colección que contiene todos los espacios de nombres actualmente en alcance.
GetRemainder()Devuelve el resto del XML almacenado en búfer.
HasLineInfo() overrideDevuelve un valor que indica si la clase puede devolver información de línea.
LookupNamespace(const String&) overrideResuelve un prefijo de espacio de nombres en el alcance del elemento actual.
MoveToAttribute(String) overrideSe mueve al atributo con el nombre especificado.
MoveToAttribute(String, String) overrideSe mueve al atributo con el nombre local y el URI del espacio de nombres especificados.
MoveToAttribute(int32_t) overrideSe mueve al atributo con el índice especificado.
MoveToElement() overrideSe mueve al elemento que contiene el nodo de atributo actual.
MoveToFirstAttribute() overrideSe mueve al primer atributo.
MoveToNextAttribute() overrideSe mueve al siguiente atributo.
Read() overrideLee el siguiente nodo del flujo.
ReadAttributeValue() overrideAnaliza el valor del atributo en uno o más nodos Text, EntityReference o EndEntity.
ReadBase64(const ArrayPtr<uint8_t>&, int32_t, int32_t)Decodifica Base64 y devuelve los bytes binarios decodificados.
ReadBinHex(const ArrayPtr<uint8_t>&, int32_t, int32_t)Decodifica BinHex y devuelve los bytes binarios decodificados.
ReadChars(const ArrayPtr<char16_t>&, int32_t, int32_t)Lee el contenido de texto de un elemento en un búfer de caracteres. Este método está diseñado para leer flujos grandes de texto incrustado llamándolo sucesivamente.
ReadContentAsBase64(ArrayPtr<uint8_t>, int32_t, int32_t) overrideLee el contenido y devuelve los bytes binarios decodificados en Base64.
ReadContentAsBinHex(ArrayPtr<uint8_t>, int32_t, int32_t) overrideLee el contenido y devuelve los bytes binarios decodificados en BinHex.
ReadElementContentAsBase64(ArrayPtr<uint8_t>, int32_t, int32_t) overrideLee el elemento y decodifica el contenido en Base64.
ReadElementContentAsBinHex(ArrayPtr<uint8_t>, int32_t, int32_t) overrideLee el elemento y decodifica el contenido BinHex.
ReadString() overrideLee el contenido de un elemento o de un nodo de texto como una cadena.
ResetState()Restablece el estado del lector a ReadState::Initial.
ResolveEntity() overrideResuelve la referencia de entidad para los nodos EntityReference.
set_DtdProcessing(System::Xml::DtdProcessing)Establece la enumeración DtdProcessing.
set_EntityHandling(System::Xml::EntityHandling)Establece un valor que especifica cómo el lector maneja las entidades.
set_Namespaces(bool)Establece un valor que indica si se debe habilitar el soporte de espacios de nombres.
set_Normalization(bool)Establece un valor que indica si se normaliza el espacio en blanco y los valores de los atributos.
set_ProhibitDtd(bool)Establece un valor que indica si se permite el procesamiento de DTD.
set_WhitespaceHandling(System::Xml::WhitespaceHandling)Establece un valor que especifica cómo se maneja el espacio en blanco.
set_XmlResolver(const SharedPtr<System::Xml::XmlResolver>&)Establece el XmlResolver utilizado para resolver referencias DTD.
Skip() overrideOmite los hijos del nodo actual.
XmlTextReader(const SharedPtr<IO::Stream>&)Inicializa una nueva instancia de la clase XmlTextReader con el flujo especificado.
XmlTextReader(const String&, const SharedPtr<IO::Stream>&)Inicializa una nueva instancia de la clase XmlTextReader con la URL y el flujo especificados.
XmlTextReader(const SharedPtr<IO::Stream>&, const SharedPtr<XmlNameTable>&)Inicializa una nueva instancia de la clase XmlTextReader con el flujo y el XmlNameTable especificados.
XmlTextReader(const String&, const SharedPtr<IO::Stream>&, const SharedPtr<XmlNameTable>&)Inicializa una nueva instancia de la clase XmlTextReader con la URL, el flujo y el XmlNameTable especificados.
XmlTextReader(const SharedPtr<IO::TextReader>&)Inicializa una nueva instancia de la clase XmlTextReader con el TextReader especificado.
XmlTextReader(const String&, const SharedPtr<IO::TextReader>&)Inicializa una nueva instancia de la clase XmlTextReader con la URL y el TextReader especificados.
XmlTextReader(const SharedPtr<IO::TextReader>&, const SharedPtr<XmlNameTable>&)Inicializa una nueva instancia de la clase XmlTextReader con el TextReader y el XmlNameTable especificados.
XmlTextReader(const String&, const SharedPtr<IO::TextReader>&, const SharedPtr<XmlNameTable>&)Inicializa una nueva instancia de la clase XmlTextReader con la URL, el TextReader y el XmlNameTable especificados.
XmlTextReader(const SharedPtr<IO::Stream>&, XmlNodeType, const SharedPtr<XmlParserContext>&)Inicializa una nueva instancia de la clase XmlTextReader con el flujo, el XmlNodeType y el XmlParserContext especificados.
XmlTextReader(const String&, XmlNodeType, const SharedPtr<XmlParserContext>&)Inicializa una nueva instancia de la clase XmlTextReader con la cadena, el XmlNodeType y el XmlParserContext especificados.
XmlTextReader(const String&)Inicializa una nueva instancia de la clase XmlTextReader con el archivo especificado.
XmlTextReader(const String&, const SharedPtr<XmlNameTable>&)Inicializa una nueva instancia de la clase XmlTextReader con el archivo y el XmlNameTable especificados.

Typedefs

TypedefDescripción
PtrUn alias para un puntero compartido a una instancia de esta clase.

Observaciones

Se recomienda usar la clase XmlReader en su lugar.

Los objetos de esta clase solo deben asignarse usando la función System::MakeObject(). Nunca cree instancias de este tipo en la pila ni usando el operador new, ya que provocará errores en tiempo de ejecución y/o fallos de aserción. Siempre envuelva esta clase en un puntero System::SmartPtr y use ese puntero para pasarlo a funciones como argumento.

Ver también