XmlTextReader Clase

Definición

Espacio de nombres:

System.Xml

Ensamblado:

System.Xml.ReaderWriter.dll

Representa un lector que proporciona acceso rápido a datos XML, sin almacenamiento en caché y con desplazamiento solo hacia delante.

A partir de .NET Framework 2.0, se recomienda usar la clase XmlReader en su lugar.

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

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

type XmlTextReader = class
    inherit XmlReader
    interface IXmlLineInfo
    interface IXmlNamespaceResolver

Public Class XmlTextReader
Inherits XmlReader
Implements IXmlLineInfo, IXmlNamespaceResolver

Herencia

Object

XmlReader

XmlTextReader

Implementaciones

IXmlLineInfo IXmlNamespaceResolver

Comentarios

Para obtener más información sobre esta API, consulte Comentarios complementarios de la API para XmlTextReader.

Notas a los desarrolladores de herederos

Esta clase tiene una demanda de herencia. Se requiere plena confianza para heredar de XmlTextReader.

Constructores

XmlTextReader()	Inicializa una nueva instancia de XmlTextReader.
XmlTextReader(Stream)	Inicializa una nueva instancia de la clase XmlTextReader con el flujo especificado.
XmlTextReader(Stream, XmlNameTable)	Inicializa una nueva instancia de la clase XmlTextReader con el flujo especificado y XmlNameTable.
XmlTextReader(Stream, XmlNodeType, XmlParserContext)	Inicializa una nueva instancia de la clase XmlTextReader con el flujo especificado, XmlNodeType y XmlParserContext.
XmlTextReader(String)	Inicializa una nueva instancia de la clase XmlTextReader con el archivo especificado.
XmlTextReader(String, Stream)	Inicializa una nueva instancia de la clase XmlTextReader con la dirección URL y el flujo especificados.
XmlTextReader(String, Stream, XmlNameTable)	Inicializa una nueva instancia de la clase XmlTextReader con la dirección URL, el flujo y la XmlNameTable especificados.
XmlTextReader(String, TextReader)	Inicializa una nueva instancia de la clase XmlTextReader con la dirección URL y el TextReader especificados.
XmlTextReader(String, TextReader, XmlNameTable)	Inicializa una nueva instancia de la clase XmlTextReader con la dirección URL y los objetos TextReader y XmlNameTable especificados.
XmlTextReader(String, XmlNameTable)	Inicializa una nueva instancia de la clase XmlTextReader con el archivo y el objeto XmlNameTable especificados.
XmlTextReader(String, XmlNodeType, XmlParserContext)	Inicializa una nueva instancia de la clase XmlTextReader con la cadena y los objetos XmlNodeType y XmlParserContext especificados.
XmlTextReader(TextReader)	Inicializa una nueva instancia de la clase XmlTextReader con el objeto TextReader especificado.
XmlTextReader(TextReader, XmlNameTable)	Inicializa una nueva instancia de la clase XmlTextReader con los parámetros TextReader y XmlNameTable especificados.
XmlTextReader(XmlNameTable)	Inicializa una nueva instancia de la clase XmlTextReader con el objeto XmlNameTable especificado.

Propiedades

AttributeCount	Obtiene el número de atributos del nodo actual.
BaseURI	Obtiene el identificador URI base del nodo actual.
CanReadBinaryContent	Obtiene un valor que indica si XmlTextReader implementa los métodos de lectura de contenido binario.
CanReadValueChunk	Obtiene un valor que indica si XmlTextReader implementa el método ReadValueChunk(Char[], Int32, Int32).
CanResolveEntity	Obtiene un valor que indica si este lector puede analizar y resolver entidades.
Depth	Obtiene la profundidad del nodo actual en el documento XML.
DtdProcessing	Obtiene o establece la enumeración DtdProcessing.
Encoding	Obtiene la codificación del documento.
EntityHandling	Obtiene o establece un valor que especifica cómo controla el lector las entidades.
EOF	Obtiene un valor que indica si el lector está situado al final del flujo.
HasAttributes	Obtiene un valor que indica si el nodo actual tiene algún atributo. (Heredado de XmlReader)
HasValue	Obtiene un valor que indica si el nodo actual puede tener una propiedad Value con un valor distinto de String.Empty.
IsDefault	Obtiene un valor que indica si el nodo actual es un atributo que se ha generado a partir del valor predeterminado definido en la DTD o esquema.
IsEmptyElement	Obtiene un valor que indica si el nodo actual es un elemento vacío (por ejemplo, <MyElement/>).
Item[Int32]	Cuando se invalida en una clase derivada, obtiene el valor del atributo con el índice especificado. (Heredado de XmlReader)
Item[String, String]	Cuando se invalida en una clase derivada, obtiene el valor del atributo con las propiedades LocalName y NamespaceURI especificadas. (Heredado de XmlReader)
Item[String]	Cuando se invalida en una clase derivada, obtiene el valor del atributo con la propiedad Name especificada. (Heredado de XmlReader)
LineNumber	Obtiene el número de línea actual.
LinePosition	Obtiene la posición de línea actual.
LocalName	Obtiene el nombre local del nodo actual.
Name	Obtiene el nombre completo del nodo actual.
Namespaces	Obtiene o establece un valor que indica si se ha de aplicar la compatibilidad de espacio de nombres.
NamespaceURI	Obtiene el URI de espacio de nombres (según se define en la especificación relativa a espacios de nombres del Consorcio W3C) del nodo en el que está situado el lector.
NameTable	Obtiene el XmlNameTable asociado a esta implementación.
NodeType	Obtiene el tipo del nodo actual.
Normalization	Obtiene o establece un valor que indica si se deben normalizar los valores de atributo y de espacio en blanco.
Prefix	Obtiene el prefijo de espacio de nombres asociado al nodo actual.
ProhibitDtd	Obsoletos. Obtiene o establece un valor que indica si se debe permitir el procesamiento de DTD. Esta propiedad ha quedado obsoleta. Utilice DtdProcessing en su lugar.
QuoteChar	Obtiene el carácter de comillas entre las que se encierra el valor de un nodo de atributo.
ReadState	Obtiene el estado del lector.
SchemaInfo	Obtiene la información de esquema asignada al nodo actual como resultado de la validación del esquema. (Heredado de XmlReader)
Settings	Obtiene el objeto XmlReaderSettings que se usa para crear esta instancia de XmlReader. (Heredado de XmlReader)
Value	Obtiene el valor de texto del nodo actual.
ValueType	Obtiene el tipo de Common Language Runtime (CLR) del nodo actual. (Heredado de XmlReader)
WhitespaceHandling	Obtiene o establece un valor que indica cómo se controla el espacio en blanco.
XmlLang	Obtiene el ámbito de xml:lang actual.
XmlResolver	Establece el objeto XmlResolver que se usa para resolver las referencias a DTD.
XmlSpace	Obtiene el ámbito de xml:space actual.

Métodos

Close()	Cambia la propiedad ReadState a Closed.
Dispose()	Libera todos los recursos usados por la instancia actual de la clase XmlReader. (Heredado de XmlReader)
Dispose(Boolean)	Libera los recursos no administrados que usa XmlReader y, de forma opcional, libera los recursos administrados. (Heredado de XmlReader)
Equals(Object)	Determina si el objeto especificado es igual que el objeto actual. (Heredado de Object)
GetAttribute(Int32)	Obtiene el valor del atributo con el índice especificado.
GetAttribute(String)	Obtiene el valor del atributo con el nombre especificado.
GetAttribute(String, String)	Obtiene el valor del atributo con el nombre local y el identificador URI de espacio de nombres que se hayan especificado.
GetHashCode()	Sirve como la función hash predeterminada. (Heredado de Object)
GetNamespacesInScope(XmlNamespaceScope)	Obtiene una colección que contiene todos los espacios de nombres que hay actualmente en el ámbito.
GetRemainder()	Obtiene el resto de XML con búfer.
GetType()	Obtiene el Type de la instancia actual. (Heredado de Object)
GetValueAsync()	Obtiene de forma asincrónica el valor del nodo actual. (Heredado de XmlReader)
HasLineInfo()	Obtiene un valor que indica si la clase puede devolver información de línea.
IsStartElement()	Llama al método MoveToContent() y comprueba si el nodo de contenido actual es una etiqueta de apertura o una etiqueta de elemento vacío. (Heredado de XmlReader)
IsStartElement(String)	Llama al método MoveToContent() y comprueba si el nodo de contenido actual es una etiqueta de apertura o una etiqueta de elemento vacío y si la propiedad Name del elemento encontrado coincide con el argumento especificado. (Heredado de XmlReader)
IsStartElement(String, String)	Llama al método MoveToContent() y comprueba si el nodo de contenido actual es una etiqueta de apertura o una etiqueta de elemento vacío y si las propiedades LocalName y NamespaceURI del elemento encontrado coinciden con las cadenas especificadas. (Heredado de XmlReader)
LookupNamespace(String)	Resuelve un prefijo de espacio de nombres en el ámbito del elemento actual.
MemberwiseClone()	Crea una copia superficial del Object actual. (Heredado de Object)
MoveToAttribute(Int32)	Se desplaza hasta el atributo con el índice especificado.
MoveToAttribute(String)	Se desplaza hasta el atributo con el nombre especificado.
MoveToAttribute(String, String)	Se desplaza hasta el atributo con el nombre local y el URI de espacio de nombres que se hayan especificado.
MoveToContent()	Comprueba si el nodo actual es un nodo de contenido (texto sin espacios en blanco, CDATA, Element, EndElement, EntityReference o EndEntity). Si el nodo no es un nodo de contenido, el lector salta hasta el siguiente nodo de contenido o el final del archivo. Omite los siguientes tipos de nodo: ProcessingInstruction, DocumentType, Comment, Whitespace o SignificantWhitespace. (Heredado de XmlReader)
MoveToContentAsync()	De forma asincrónica comprueba si el nodo actual es un nodo de contenido. Si el nodo no es un nodo de contenido, el lector salta hasta el siguiente nodo de contenido o el final del archivo. (Heredado de XmlReader)
MoveToElement()	Se desplaza hasta el elemento que contiene el nodo de atributo actual.
MoveToFirstAttribute()	Se mueve al primer atributo.
MoveToNextAttribute()	Se mueve al siguiente atributo.
Read()	Lee el siguiente nodo del flujo.
ReadAsync()	De forma asincrónica lee el nodo siguiente del flujo. (Heredado de XmlReader)
ReadAttributeValue()	Analiza el valor de atributo en uno o varios nodos Text, EntityReference o EndEntity.
ReadBase64(Byte[], Int32, Int32)	Descodifica Base64 y devuelve los bytes binarios descodificados.
ReadBinHex(Byte[], Int32, Int32)	Descodifica BinHex y devuelve los bytes binarios descodificados.
ReadChars(Char[], Int32, Int32)	Lee el contenido de texto de un elemento en un búfer de caracteres. Este método se ha diseñado para leer grandes flujos de texto incrustado llamando sucesivamente al método.
ReadContentAs(Type, IXmlNamespaceResolver)	Lee el contenido como objeto del tipo especificado. (Heredado de XmlReader)
ReadContentAsAsync(Type, IXmlNamespaceResolver)	Lee asincrónicamente el contenido como objeto del tipo especificado. (Heredado de XmlReader)
ReadContentAsBase64(Byte[], Int32, Int32)	Lee el contenido y devuelve los bytes binarios descodificados de Base64.
ReadContentAsBase64Async(Byte[], Int32, Int32)	Lee asincrónicamente el contenido y devuelve los bytes binarios descodificados en Base64. (Heredado de XmlReader)
ReadContentAsBinHex(Byte[], Int32, Int32)	Lee el contenido y devuelve los bytes binarios descodificados de BinHex.
ReadContentAsBinHexAsync(Byte[], Int32, Int32)	Lee asincrónicamente el contenido y devuelve los bytes binarios descodificados de BinHex. (Heredado de XmlReader)
ReadContentAsBoolean()	Lee el contenido de texto en la posición actual como valor Boolean. (Heredado de XmlReader)
ReadContentAsDateTime()	Lee el contenido de texto en la posición actual como un objeto DateTime. (Heredado de XmlReader)
ReadContentAsDateTimeOffset()	Lee el contenido de texto en la posición actual como un objeto DateTimeOffset. (Heredado de XmlReader)
ReadContentAsDecimal()	Lee el contenido de texto en la posición actual como un objeto Decimal. (Heredado de XmlReader)
ReadContentAsDouble()	Lee el contenido de texto en la posición actual como número de punto flotante de precisión doble. (Heredado de XmlReader)
ReadContentAsFloat()	Lee el contenido de texto en la posición actual como número de punto flotante de precisión sencilla. (Heredado de XmlReader)
ReadContentAsInt()	Lee el contenido de texto en la posición actual como un entero de 32 bits con signo. (Heredado de XmlReader)
ReadContentAsLong()	Lee el contenido de texto en la posición actual como un entero de 64 bits con signo. (Heredado de XmlReader)
ReadContentAsObject()	Lee el contenido de texto en la posición actual como Object. (Heredado de XmlReader)
ReadContentAsObjectAsync()	Lee asincrónicamente el contenido de texto en la posición actual como un objeto Object. (Heredado de XmlReader)
ReadContentAsString()	Lee el contenido de texto en la posición actual como un objeto String. (Heredado de XmlReader)
ReadContentAsStringAsync()	Lee asincrónicamente el contenido de texto en la posición actual como un objeto String. (Heredado de XmlReader)
ReadElementContentAs(Type, IXmlNamespaceResolver)	Lee el contenido de los elementos como el tipo solicitado. (Heredado de XmlReader)
ReadElementContentAs(Type, IXmlNamespaceResolver, String, String)	Comprueba que el nombre local especificado y el URI de espacio de nombres coinciden con los del elemento actual y, a continuación, lee el contenido de los elementos como el tipo solicitado. (Heredado de XmlReader)
ReadElementContentAsAsync(Type, IXmlNamespaceResolver)	Lee asincrónicamente el contenido del elemento como el tipo solicitado. (Heredado de XmlReader)
ReadElementContentAsBase64(Byte[], Int32, Int32)	Lee el elemento y descodifica el contenido de Base64.
ReadElementContentAsBase64Async(Byte[], Int32, Int32)	Lee asincrónicamente el elemento y descodifica el contenido de Base64. (Heredado de XmlReader)
ReadElementContentAsBinHex(Byte[], Int32, Int32)	Lee el elemento y descodifica el contenido de BinHex.
ReadElementContentAsBinHexAsync(Byte[], Int32, Int32)	Lee asincrónicamente el elemento y descodifica el contenido de BinHex. (Heredado de XmlReader)
ReadElementContentAsBoolean()	Lee el elemento actual y devuelve el contenido como un objeto Boolean. (Heredado de XmlReader)
ReadElementContentAsBoolean(String, String)	Comprueba que el nombre local especificado y el URI del espacio de nombres coinciden con los del elemento actual y, a continuación, lee este elemento y devuelve el contenido como objeto Boolean. (Heredado de XmlReader)
ReadElementContentAsDateTime()	Lee el elemento actual y devuelve el contenido como un objeto DateTime. (Heredado de XmlReader)
ReadElementContentAsDateTime(String, String)	Comprueba que el nombre local especificado y el URI del espacio de nombres coinciden con los del elemento actual y, a continuación, lee este elemento y devuelve el contenido como objeto DateTime. (Heredado de XmlReader)
ReadElementContentAsDecimal()	Lee el elemento actual y devuelve el contenido como un objeto Decimal. (Heredado de XmlReader)
ReadElementContentAsDecimal(String, String)	Comprueba que el nombre local especificado y el URI del espacio de nombres coinciden con los del elemento actual y, a continuación, lee este elemento y devuelve el contenido como objeto Decimal. (Heredado de XmlReader)
ReadElementContentAsDouble()	Lee el elemento actual y devuelve el contenido como número de punto flotante de precisión doble. (Heredado de XmlReader)
ReadElementContentAsDouble(String, String)	Comprueba que el nombre local especificado y el URI del espacio de nombres coinciden con los del elemento actual y, a continuación, lee este elemento y devuelve el contenido como número de punto flotante de precisión doble. (Heredado de XmlReader)
ReadElementContentAsFloat()	Lee el elemento actual y devuelve el contenido como número de punto flotante de precisión sencilla. (Heredado de XmlReader)
ReadElementContentAsFloat(String, String)	Comprueba que el nombre local especificado y el URI del espacio de nombres coinciden con los del elemento actual y, a continuación, lee este elemento y devuelve el contenido como número de punto flotante de precisión sencilla. (Heredado de XmlReader)
ReadElementContentAsInt()	Lee el elemento actual y devuelve el contenido como un entero de 32 bits con signo. (Heredado de XmlReader)
ReadElementContentAsInt(String, String)	Comprueba que el nombre local especificado y el URI del espacio de nombres coinciden con los del elemento actual y, a continuación, lee el elemento actual y devuelve el contenido como entero de 32 bits con signo. (Heredado de XmlReader)
ReadElementContentAsLong()	Lee el elemento actual y devuelve el contenido como entero de 64 bits con signo. (Heredado de XmlReader)
ReadElementContentAsLong(String, String)	Comprueba que el nombre local y el identificador URI del espacio de nombres especificados coinciden con los del elemento actual, luego lee el elemento actual y devuelve el contenido como entero de 64 bits con signo. (Heredado de XmlReader)
ReadElementContentAsObject()	Lee el elemento actual y devuelve el contenido como objeto Object. (Heredado de XmlReader)
ReadElementContentAsObject(String, String)	Comprueba que el nombre local especificado y el URI del espacio de nombres coinciden con los del elemento actual y, a continuación, lee este elemento y devuelve el contenido como objeto Object. (Heredado de XmlReader)
ReadElementContentAsObjectAsync()	Lee asincrónicamente el elemento actual y devuelve el contenido como objeto Object. (Heredado de XmlReader)
ReadElementContentAsString()	Lee el elemento actual y devuelve el contenido como un objeto String. (Heredado de XmlReader)
ReadElementContentAsString(String, String)	Comprueba que el nombre local especificado y el URI del espacio de nombres coinciden con los del elemento actual y, a continuación, lee este elemento y devuelve el contenido como objeto String. (Heredado de XmlReader)
ReadElementContentAsStringAsync()	Lee asincrónicamente el elemento actual y devuelve el contenido como un objeto String. (Heredado de XmlReader)
ReadElementString()	Lee un elemento de solo texto. Sin embargo, se recomienda usar el método ReadElementContentAsString() en su lugar, porque proporciona una manera más sencilla de controlar esta operación. (Heredado de XmlReader)
ReadElementString(String)	Comprueba si la propiedad Name del elemento encontrado coincide con la cadena especificada antes de leer un elemento de sólo texto. Sin embargo, se recomienda usar el método ReadElementContentAsString() en su lugar, porque proporciona una manera más sencilla de controlar esta operación. (Heredado de XmlReader)
ReadElementString(String, String)	Comprueba si las propiedades LocalName y NamespaceURI del elemento encontrado coinciden con las cadenas especificadas antes de leer un elemento de sólo texto. Sin embargo, se recomienda usar el método ReadElementContentAsString(String, String) en su lugar, porque proporciona una manera más sencilla de controlar esta operación. (Heredado de XmlReader)
ReadEndElement()	Comprueba si el nodo de contenido actual es una etiqueta de cierre y desplaza el lector hasta el siguiente nodo. (Heredado de XmlReader)
ReadInnerXml()	Cuando se invalida en una clase derivada, lee todo el contenido, incluido el marcado, como una cadena. (Heredado de XmlReader)
ReadInnerXmlAsync()	De forma asincrónica lee todo el contenido, incluido el marcado, como una cadena. (Heredado de XmlReader)
ReadOuterXml()	Cuando se invalida en una clase derivada, lee el contenido, incluido el marcado, que representa este nodo y todos sus nodos secundarios. (Heredado de XmlReader)
ReadOuterXmlAsync()	De forma asincrónica lee el contenido, incluido el marcado, que representa este nodo y todos sus elementos secundarios. (Heredado de XmlReader)
ReadStartElement()	Comprueba si el nodo actual es un elemento y hace avanzar el sistema de lectura hasta el siguiente nodo. (Heredado de XmlReader)
ReadStartElement(String)	Comprueba si el nodo de contenido actual es un elemento con la propiedad Name especificada y desplaza el lector hasta el siguiente nodo. (Heredado de XmlReader)
ReadStartElement(String, String)	Comprueba si el nodo de contenido actual es un elemento con las propiedades LocalName y NamespaceURI especificadas y desplaza el lector hasta el siguiente nodo. (Heredado de XmlReader)
ReadString()	Lee el contenido de un nodo de texto o un elemento como cadena.
ReadSubtree()	Devuelve una nueva instancia de XmlReader que se puede utilizar para leer el nodo actual y todos sus descendientes. (Heredado de XmlReader)
ReadToDescendant(String)	Hace avanzar el objeto XmlReader hasta al siguiente elemento descendiente con el nombre completo especificado. (Heredado de XmlReader)
ReadToDescendant(String, String)	Hace avanzar el objeto XmlReader hasta el siguiente elemento descendiente que tenga el URI de espacio de nombres y el nombre local especificados. (Heredado de XmlReader)
ReadToFollowing(String)	Lee hasta que encuentra un elemento con el nombre completo especificado. (Heredado de XmlReader)
ReadToFollowing(String, String)	Lee hasta que encuentra un elemento con el nombre local y el URI de espacio de nombres especificados. (Heredado de XmlReader)
ReadToNextSibling(String)	Hace avanzar el objeto XmlReader hasta al siguiente elemento relacionado con el nombre completo especificado. (Heredado de XmlReader)
ReadToNextSibling(String, String)	Hace avanzar el objeto XmlReader al siguiente elemento del mismo nivel que tenga el URI del espacio de nombres y el nombre local especificados. (Heredado de XmlReader)
ReadValueChunk(Char[], Int32, Int32)	Lee grandes secuencias de texto incrustadas en un documento XML. (Heredado de XmlReader)
ReadValueChunkAsync(Char[], Int32, Int32)	Lee asincrónicamente grandes secuencias de texto incrustadas en un documento XML. (Heredado de XmlReader)
ResetState()	Restablece el estado del lector en ReadState.Initial.
ResolveEntity()	Resuelve la referencia a entidad de los nodos EntityReference.
Skip()	Omite los nodos secundarios del nodo actual.
SkipAsync()	Omite de forma asincrónica los elementos secundarios del valor del nodo actual. (Heredado de XmlReader)
ToString()	Devuelve una cadena que representa el objeto actual. (Heredado de Object)

Implementaciones de interfaz explícitas

IXmlNamespaceResolver.GetNamespacesInScope(XmlNamespaceScope)	Para obtener una descripción de este miembro, vea GetNamespacesInScope(XmlNamespaceScope).
IXmlNamespaceResolver.LookupNamespace(String)	Para obtener una descripción de este miembro, vea LookupNamespace(String).
IXmlNamespaceResolver.LookupPrefix(String)	Para obtener una descripción de este miembro, vea LookupPrefix(String).

Consulte también

• Documentos y datos XML