XmlTextReader (Clase) (System.Xml)

Cambiar vista:

Sin script

Biblioteca de clases de .NET Framework

XmlTextReader (Clase)

Este artículo se tradujo de forma manual. Para ver esta página en modo editable y el contenido en inglés al mismo tiempo, cambie a Lightweight según sus preferencias de visualización.

[Esta documentación se proporciona solo para fines preliminares y está sujeta a cambios en versiones posteriores. Se incluye temas en blanco como marcadores].

Representa un lector que proporcione rápidamente, acceso sin almacenamiento en memoria caché, hacia delante a los datos XML.

Jerarquía de herencia

System.Object
System.Xml.XmlReader
System.Xml.XmlTextReader

Espacio de nombres: System.Xml
Ensamblado: System.Xml (en System.Xml.dll)

Sintaxis

Visual Basic


<PermissionSetAttribute(SecurityAction.InheritanceDemand, Name := "FullTrust")> _
Public Class XmlTextReader _
	Inherits XmlReader _
	Implements IXmlLineInfo, IXmlNamespaceResolver


[PermissionSetAttribute(SecurityAction.InheritanceDemand, Name = "FullTrust")]
public class XmlTextReader : XmlReader, 
	IXmlLineInfo, IXmlNamespaceResolver

Visual C++


[PermissionSetAttribute(SecurityAction::InheritanceDemand, Name = L"FullTrust")]
public ref class XmlTextReader : public XmlReader, 
	IXmlLineInfo, IXmlNamespaceResolver


[<PermissionSetAttribute(SecurityAction.InheritanceDemand, Name = "FullTrust")>]
type XmlTextReader =  
    class
        inherit XmlReader
        interface IXmlLineInfo
        interface IXmlNamespaceResolver
    end

El tipo XmlTextReader expone los siguientes miembros.

Constructores

	Nombre	Descripción
	XmlTextReader()	Inicializa una nueva instancia de XmlTextReader.
	XmlTextReader(Stream)	Inicializa una nueva instancia de la clase de XmlTextReader con la secuencia especificada.
	XmlTextReader(String)	Inicializa una nueva instancia de la clase de XmlTextReader con el archivo especificado.
	XmlTextReader(TextReader)	Inicializa una nueva instancia de la clase de XmlTextReader con TextReaderespecificado.
	XmlTextReader(XmlNameTable)	Infraestructura. Inicializa una nueva instancia de la clase de XmlTextReader con XmlNameTableespecificado.
	XmlTextReader(Stream, XmlNameTable)	Inicializa una nueva instancia de la clase de XmlTextReader con la secuencia especificada y XmlNameTable.
	XmlTextReader(String, Stream)	Inicializa una nueva instancia de la clase de XmlTextReader con la dirección URL especificada y la secuencia.
	XmlTextReader(String, TextReader)	Inicializa una nueva instancia de la clase de XmlTextReader con la dirección URL especificada y TextReader.
	XmlTextReader(String, XmlNameTable)	Inicializa una nueva instancia de la clase de XmlTextReader con el archivo especificado y XmlNameTable.
	XmlTextReader(TextReader, XmlNameTable)	Inicializa una nueva instancia de la clase de XmlTextReader con TextReader especificado y XmlNameTable.
	XmlTextReader(Stream, XmlNodeType, XmlParserContext)	Inicializa una nueva instancia de la clase de XmlTextReader con la secuencia especificada, XmlNodeType, y XmlParserContext.
	XmlTextReader(String, Stream, XmlNameTable)	Inicializa una nueva instancia de la clase de XmlTextReader con la dirección URL especificada, la secuencia y XmlNameTable.
	XmlTextReader(String, TextReader, XmlNameTable)	Inicializa una nueva instancia de la clase de XmlTextReader con la dirección URL especificada, TextReader y XmlNameTable.
	XmlTextReader(String, XmlNodeType, XmlParserContext)	Inicializa una nueva instancia de la clase de XmlTextReader con la cadena especificada, XmlNodeType, y XmlParserContext.

Arriba

Propiedades

	Nombre	Descripción
	AttributeCount	Obtiene el número de atributos del nodo actual. (Invalida a XmlReader.AttributeCount).
	BaseURI	Obtiene el URI base del nodo actual. (Invalida a XmlReader.BaseURI).
	CanReadBinaryContent	Obtiene un valor que indica si XmlTextReader implementa los métodos binarios de lectura del contenido. (Invalida a XmlReader.CanReadBinaryContent).
	CanReadValueChunk	obtiene un valor que indica si XmlTextReader implementa el método de ReadValueChunk . (Invalida a XmlReader.CanReadValueChunk).
	CanResolveEntity	Obtiene un valor que indica si este lector puede analizar y resolver las entidades. (Invalida a XmlReader.CanResolveEntity).
	Depth	Obtiene la profundidad del nodo actual en el documento XML. (Invalida a XmlReader.Depth).
	DtdProcessing	obtiene o establece la enumeración de DtdProcessing .
	Encoding	Obtiene la codificación del documento.
	EntityHandling	Obtiene o establece un valor que especifica cómo el lector controla las entidades.
	EOF	Obtiene un valor que indica si se colocan el lector al final de la secuencia. (Invalida a XmlReader.EOF).
	HasAttributes	Obtiene un valor que indica si el nodo actual tiene atributos. (Se hereda de XmlReader).
	HasValue	Obtiene un valor que indica si el nodo actual puede tener Value distinto de String.Empty. (Invalida a XmlReader.HasValue).
	IsDefault	Obtiene un valor que indica si el nodo actual es un atributo que se generó a partir del valor predeterminado definido en el DTD o esquema. (Invalida a XmlReader.IsDefault).
	IsEmptyElement	obtiene un valor que indica si el nodo actual es un elemento vacío (por ejemplo, <MyElement/>). (Invalida a XmlReader.IsEmptyElement).
	Item[Int32]	Cuando se invalida en una clase derivada, obtiene el valor del atributo con el índice especificado. (Se hereda de XmlReader).
	Item[String]	Cuando se invalida en una clase derivada, obtiene el valor del atributo con la propiedad Name especificada. (Se hereda de XmlReader).
	Item[String, String]	Cuando se invalida en una clase derivada, obtiene el valor del atributo con las propiedades LocalName y NamespaceURI especificadas. (Se hereda 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. (Invalida a XmlReader.LocalName).
	Name	Obtiene el nombre completo del nodo actual. (Invalida a XmlReader.Name).
	Namespaces	Obtiene o establece un valor que indica si realizar la compatibilidad del espacio de nombres.
	NamespaceURI	Obtiene el URI del espacio de nombres (como definido en la especificación de espacio de nombres de W3C) del nodo en el que colocan el lector. (Invalida a XmlReader.NamespaceURI).
	NameTable	obtiene XmlNameTable asociado con esta implementación. (Invalida a XmlReader.NameTable).
	NodeType	Obtiene el tipo del nodo actual. (Invalida a XmlReader.NodeType).
	Normalization	Obtiene o establece un valor que indica si normalizar el espacio en blanco y los valores de atributo.
	Prefix	Obtiene el prefijo de espacio de nombres asociado al nodo actual. (Invalida a XmlReader.Prefix).
	ProhibitDtd	Obsoleto. Obtiene o establece un valor que indica si permitir el procesamiento de DTD. Esta propiedad ha quedado obsoleta. Uso DtdProcessing en su lugar.
	QuoteChar	Obtiene el carácter de comillas utilizado para agregar el valor de un nodo de atributo. (Invalida a XmlReader.QuoteChar).
	ReadState	Obtiene el estado del lector. (Invalida a XmlReader.ReadState).
	SchemaInfo	Obtiene la información de esquema asignada al nodo actual como resultado de la validación del esquema. (Se hereda de XmlReader).
	Settings	Obtiene el objeto XmlReaderSettings utilizado para crear esta instancia de XmlReader. (Se hereda de XmlReader). En XNA Framework, este miembro está invalidado por Settings.
	Value	Obtiene el valor de texto del nodo actual. (Invalida a XmlReader.Value).
	ValueType	Obtiene el tipo de Common Language Runtime (CLR) del nodo actual. (Se hereda de XmlReader).
	WhitespaceHandling	Obtiene o establece un valor que especifica cómo se controla el espacio en blanco.
	XmlLang	obtiene el ámbito actual de xml:lang . (Invalida a XmlReader.XmlLang).
	XmlResolver	Establece XmlResolver utilizado para resolver referencias de DTD.
	XmlSpace	obtiene el ámbito actual de xml:space . (Invalida a XmlReader.XmlSpace).

Arriba

Métodos

	Nombre	Descripción
	Close	cambia ReadState a Closed. (Invalida a XmlReader.Close()).
	Dispose()	Libera todos los recursos usados por la instancia actual de la clase XmlReader. (Se hereda de XmlReader).
	Dispose(Boolean)	Libera los recursos no administrados que utiliza el objeto XmlReader y, opcionalmente, los recursos administrados. (Se hereda de XmlReader).
	Equals(Object)	Determina si el objeto Object especificado es igual al objeto Object actual. (Se hereda de Object).
	Finalize	Permite que un objeto intente liberar recursos y realizar otras operaciones de limpieza antes de ser reclamado por la recolección de elementos no utilizados. (Se hereda de Object).
	GetAttribute(Int32)	Obtiene el valor del atributo con el índice especificado. (Invalida a XmlReader.GetAttribute(Int32)).
	GetAttribute(String)	Obtiene el valor del atributo con el nombre especificado. (Invalida a XmlReader.GetAttribute(String)).
	GetAttribute(String, String)	Obtiene el valor del atributo con el URI especificado del nombre local y el espacio de nombres. (Invalida a XmlReader.GetAttribute(String, String)).
	GetHashCode	Actúa como función hash para un tipo concreto. (Se hereda de Object).
	GetNamespacesInScope	Obtiene una colección que contiene todo el en-ámbito namespaces actualmente.
	GetRemainder	obtiene el resto de XML almacenado en búfer.
	GetType	Obtiene el objeto Type de la instancia actual. (Se hereda de Object).
	GetValueAsync	Asincrónicamente Obtiene el valor del nodo actual. (Se hereda de XmlReader).
	HasLineInfo	Obtiene un valor que indica si puede la clase información de línea return.
	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. (Se hereda 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. (Se hereda 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. (Se hereda de XmlReader).
	LookupNamespace	Resuelve un prefijo de espacio de nombres en el ámbito del elemento actual. (Invalida a XmlReader.LookupNamespace(String)).
	MemberwiseClone	Crea una copia superficial del objeto Object actual. (Se hereda de Object).
	MoveToAttribute(Int32)	Se desplaza al atributo con el índice especificado. (Invalida a XmlReader.MoveToAttribute(Int32)).
	MoveToAttribute(String)	Se desplaza al atributo con el nombre especificado. (Invalida a XmlReader.MoveToAttribute(String)).
	MoveToAttribute(String, String)	Se desplaza al atributo con el URI especificado del nombre local y el espacio de nombres. (Invalida a XmlReader.MoveToAttribute(String, String)).
	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. (Se hereda de XmlReader).
	MoveToContentAsync	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. (Se hereda de XmlReader).
	MoveToElement	Se desplaza al elemento que contiene el nodo de atributo actual. (Invalida a XmlReader.MoveToElement()).
	MoveToFirstAttribute	Se desplaza al primer atributo. (Invalida a XmlReader.MoveToFirstAttribute()).
	MoveToNextAttribute	Se desplaza al siguiente atributo. (Invalida a XmlReader.MoveToNextAttribute()).
	Read	lee el nodo siguiente de la secuencia. (Invalida a XmlReader.Read()).
	ReadAsync	Lee el siguiente nodo de forma asincrónica de la secuencia. (Se hereda de XmlReader).
	ReadAttributeValue	analiza el valor de atributo en uno o más Text, EntityReference, o los nodos de EndEntity . (Invalida a XmlReader.ReadAttributeValue()).
	ReadBase64	descodifica Base64 y devuelve los bytes binarios descodificados.
	ReadBinHex	descodifica BinHex y devuelve los bytes binarios descodificados.
	ReadChars	Lee el contenido de texto de un elemento en un búfer de caracteres. Este método está diseñado para leer secuencias grandes de texto incrustado llamarlo sucesivamente.
	ReadContentAs	Lee el contenido como objeto del tipo especificado. (Se hereda de XmlReader).
	ReadContentAsAsync	Lee el contenido de forma asincrónica como un objeto del tipo especificado. (Se hereda de XmlReader).
	ReadContentAsBase64	Lee el contenido y devuelve Base64 descodificado bytes binarios. (Invalida a XmlReader.ReadContentAsBase64(Byte[], Int32, Int32)).
	ReadContentAsBase64Async	Asincrónica lee el contenido y devuelve que la base de 64 bytes binarios descodificados. (Se hereda de XmlReader).
	ReadContentAsBinHex	Lee el contenido y devuelve BinHex descodificado bytes binarios. (Invalida a XmlReader.ReadContentAsBinHex(Byte[], Int32, Int32)).
	ReadContentAsBinHexAsync	Lee el contenido de forma asincrónica y devuelve el BinHex bytes binarios descodificados. (Se hereda de XmlReader).
	ReadContentAsBoolean	Lee el contenido de texto en la posición actual como valor Boolean. (Se hereda de XmlReader).
	ReadContentAsDateTime	Lee el contenido de texto en la posición actual como un objeto DateTime. (Se hereda de XmlReader).
	ReadContentAsDateTimeOffset	Lee el contenido de texto en la posición actual como un objeto DateTimeOffset. (Se hereda de XmlReader).
	ReadContentAsDecimal	Lee el contenido de texto en la posición actual como un objeto Decimal. (Se hereda de XmlReader).
	ReadContentAsDouble	Lee el contenido de texto en la posición actual como número de punto flotante de precisión doble. (Se hereda de XmlReader).
	ReadContentAsFloat	Lee el contenido de texto en la posición actual como número de punto flotante de precisión sencilla. (Se hereda de XmlReader).
	ReadContentAsInt	Lee el contenido de texto en la posición actual como un entero de 32 bits con signo. (Se hereda de XmlReader).
	ReadContentAsLong	Lee el contenido de texto en la posición actual como un entero de 64 bits con signo. (Se hereda de XmlReader).
	ReadContentAsObject	Lee el contenido de texto en la posición actual como Object. (Se hereda de XmlReader).
	ReadContentAsObjectAsync	Asincrónicamente lee el contenido de texto en la posición actual como un Object. (Se hereda de XmlReader).
	ReadContentAsString	Lee el contenido de texto en la posición actual como un objeto String. (Se hereda de XmlReader).
	ReadContentAsStringAsync	Asincrónicamente lee el contenido de texto en la posición actual como un String objeto. (Se hereda de XmlReader).
	ReadElementContentAs(Type, IXmlNamespaceResolver)	Lee el contenido de los elementos como el tipo solicitado. (Se hereda 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. (Se hereda de XmlReader).
	ReadElementContentAsAsync	Asincrónicamente lee el contenido del elemento como el tipo solicitado. (Se hereda de XmlReader).
	ReadElementContentAsBase64	lee el elemento y descodifica el contenido Base64. (Invalida a XmlReader.ReadElementContentAsBase64(Byte[], Int32, Int32)).
	ReadElementContentAsBase64Async	Lee el elemento de forma asincrónica y descodifica el Base64 contenido. (Se hereda de XmlReader).
	ReadElementContentAsBinHex	lee el elemento y descodifica el contenido de BinHex . (Invalida a XmlReader.ReadElementContentAsBinHex(Byte[], Int32, Int32)).
	ReadElementContentAsBinHexAsync	Lee el elemento de forma asincrónica y descodifica el BinHex contenido. (Se hereda de XmlReader).
	ReadElementContentAsBoolean()	Lee el elemento actual y devuelve el contenido como un objeto Boolean. (Se hereda 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. (Se hereda de XmlReader).
	ReadElementContentAsDateTime()	Lee el elemento actual y devuelve el contenido como un objeto DateTime. (Se hereda 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. (Se hereda de XmlReader).
	ReadElementContentAsDecimal()	Lee el elemento actual y devuelve el contenido como un objeto Decimal. (Se hereda 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. (Se hereda de XmlReader).
	ReadElementContentAsDouble()	Lee el elemento actual y devuelve el contenido como número de punto flotante de precisión doble. (Se hereda 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. (Se hereda de XmlReader).
	ReadElementContentAsFloat()	Lee el elemento actual y devuelve el contenido como número de punto flotante de precisión sencilla. (Se hereda 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. (Se hereda de XmlReader).
	ReadElementContentAsInt()	Lee el elemento actual y devuelve el contenido como un entero de 32 bits con signo. (Se hereda 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. (Se hereda de XmlReader).
	ReadElementContentAsLong()	Lee el elemento actual y devuelve el contenido como un entero de 64 bits con signo. (Se hereda de XmlReader).
	ReadElementContentAsLong(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 64 bits con signo. (Se hereda de XmlReader).
	ReadElementContentAsObject()	Lee el elemento actual y devuelve el contenido como objeto Object. (Se hereda 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. (Se hereda de XmlReader).
	ReadElementContentAsObjectAsync	Lee el elemento actual de forma asincrónica y devuelve el contenido como un Object. (Se hereda de XmlReader).
	ReadElementContentAsString()	Lee el elemento actual y devuelve el contenido como un objeto String. (Se hereda 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. (Se hereda de XmlReader).
	ReadElementContentAsStringAsync	Lee el elemento actual de forma asincrónica y devuelve el contenido como un String objeto. (Se hereda de XmlReader).
	ReadElementString()	Lee un elemento de sólo texto. (Se hereda 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. (Se hereda 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. (Se hereda de XmlReader).
	ReadEndElement	Comprueba si el nodo de contenido actual es una etiqueta de cierre y desplaza el lector hasta el siguiente nodo. (Se hereda de XmlReader).
	ReadInnerXml	Cuando se invalida en una clase derivada, lee todo el contenido, incluido el marcado, como una cadena. (Se hereda de XmlReader).
	ReadInnerXmlAsync	Asincrónicamente lee todo el contenido, incluido el marcado, como una cadena. (Se hereda 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. (Se hereda de XmlReader).
	ReadOuterXmlAsync	Asincrónicamente lee el contenido, incluido el marcado, que representa este nodo y todos sus elementos secundarios. (Se hereda de XmlReader).
	ReadStartElement()	Comprueba si el nodo actual es un elemento y desplaza el lector hasta el siguiente nodo. (Se hereda 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. (Se hereda 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. (Se hereda de XmlReader).
	ReadString	Lee el contenido de un elemento o un nodo de texto como cadena. (Invalida a XmlReader.ReadString()).
	ReadSubtree	Devuelve una nueva instancia de XmlReader que se puede utilizar para leer el nodo actual y todos sus descendientes. (Se hereda de XmlReader).
	ReadToDescendant(String)	Hace avanzar el objeto XmlReader hasta al siguiente elemento descendiente con el nombre completo especificado. (Se hereda 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. (Se hereda de XmlReader).
	ReadToFollowing(String)	Lee hasta que encuentra un elemento con el nombre completo especificado. (Se hereda de XmlReader).
	ReadToFollowing(String, String)	Lee hasta que encuentra un elemento con el nombre local y el URI de espacio de nombres especificados. (Se hereda de XmlReader).
	ReadToNextSibling(String)	Hace avanzar el objeto XmlReader hasta al siguiente elemento relacionado con el nombre completo especificado. (Se hereda de XmlReader).
	ReadToNextSibling(String, String)	Hace avanzar el objeto XmlReader hasta el siguiente elemento relacionado que tenga el URI del espacio de nombres y el nombre local especificados. (Se hereda de XmlReader).
	ReadValueChunk	Lee grandes secuencias de texto incrustadas en un documento XML. (Se hereda de XmlReader).
	ReadValueChunkAsync	Asincrónicamente lee grandes secuencias de texto incrustado en un documento XML. (Se hereda de XmlReader).
	ResetState	Restaura el estado del lector a ReadState.Initial.
	ResolveEntity	resuelve la referencia de entidad para los nodos de EntityReference . (Invalida a XmlReader.ResolveEntity()).
	Skip	Omite los elementos secundarios del nodo actual. (Invalida a XmlReader.Skip()).
	SkipAsync	Asincrónicamente omite a los nodos secundarios del nodo actual. (Se hereda de XmlReader).
	ToString	Devuelve una cadena que representa el objeto actual. (Se hereda de Object).

Arriba

Implementaciones explícitas de interfaces

	Nombre	Descripción
	IDisposable.Dispose	Para obtener una descripción de este miembro, vea IDisposable.Dispose. (Se hereda de XmlReader).
	IXmlNamespaceResolver.GetNamespacesInScope	Para obtener una descripción de este miembro, vea IXmlNamespaceResolver.GetNamespacesInScope.
	IXmlNamespaceResolver.LookupNamespace	Para obtener una descripción de este miembro, vea IXmlNamespaceResolver.LookupNamespace.
	IXmlNamespaceResolver.LookupPrefix	Para obtener una descripción de este miembro, vea IXmlNamespaceResolver.LookupPrefix.

Arriba

Comentarios

Note
En la versión de .NET Framework 2.0 , la práctica recomendada es crear instancias de XmlReader utilizando el método de XmlReader.Create . Esto permite aprovecha las ventajas de las nuevas características introducidas en esta versión. Para obtener más información, vea Creating XML Readers.

XmlTextReader proporciona hacia delante, acceso de solo lectura a una secuencia de datos XML. El nodo actual hace referencia al nodo en el que colocan el lector. Avanzan el lector mediante cualquiera de los métodos de lectura y propiedades reflejan el valor del nodo actual.

Esta clase implementa XmlReader y se ajusta a W3C el lenguaje de marcado extensible (XML) 1,0 y los espacios de nombres en recomendaciones XML. XmlTextReader proporciona la funcionalidad siguiente:

Aplica las reglas XML correcto.
XmlTextReader no proporciona validación de datos.
Comprueba si los nodos de DocumentType están bien formados. XmlTextReader comprueba el DTD para el well-formedness, pero no se valida utilizando el DTD.
Para los nodos donde es XmlNodeType.EntityReferenceNodeType , se devuelve un único nodo vacío de EntityReference (es decir, la propiedad de Value es String.Empty).

Note
las declaraciones reales de entidades en el DTD se denominan los nodos de Entity . Al hacer referencia a estos nodos en los datos, se denominan los nodos de EntityReference .

No se expanden los atributos predeterminados.

Dado que XmlTextReader no realiza las comprobaciones adicionales necesarias para la validación de datos, proporciona un analizador rápido de well-formedness.

Para realizar la validación de datos, utilice XmlReaderque valida. Para obtener más información, vea Validating XML Data with XmlReader.

Para leer datos XML de XmlDocument, utilice XmlNodeReader.

XmlTextReader produce XmlException en los errores de análisis de XML. Después de que se produzca una excepción el estado del lector no es confiable. Por ejemplo, el tipo de nodo que puede ser diferente que el tipo de nodo real del nodo actual. Utilice la propiedad de ReadState para comprobar si un lector está en estado de error.

Para obtener una explicación adicional en las clases de XmlReader , vea Reading XML with the XmlReader.

Consideraciones de seguridad

Los siguientes son aspectos que deben tenerse en cuenta al utilizar la clase de XmlTextReader .

Las excepciones producidas XmlTextReader pueden revelar información de ruta de acceso que no desea burbujeado hasta la aplicación. Las aplicaciones deben detectar excepciones y procesarlas adecuadamente.
El procesamiento de DTD está habilitada de forma predeterminada. Deshabilite el procesamiento de DTD si le preocupa problemas de la denegación de servicio o si está trabajando con orígenes que no son de confianza. Establezca la propiedad de DtdProcessing a Prohibit para deshabilitar el procesamiento de DTD.

Si tiene el procesamiento de DTD habilitar, puede utilizar XmlSecureResolver para restringir los recursos a los que XmlTextReader tiene acceso. También puede diseñar la aplicación para que el procesamiento XML es la memoria y tiempo restringidos. Por ejemplo, configure los límites de tiempo de espera en la aplicación ASP.NET.
Los datos XML pueden incluir referencias a recursos externos como un archivo de DTD. De forma predeterminada se resuelven los recursos externos mediante un objeto de XmlUrlResolver sin credenciales de usuario. Puede garantizar este aún más mediante uno de los siguientes:
- Restrinja los recursos a los que XmlTextReader puede tener acceso estableciendo la propiedad de XmlResolver a un objeto de XmlSecureResolver .
- No permita que XmlReader abra ningún recurso externo estableciendo la propiedad de XmlResolver a null.
Los datos XML pueden contener un gran número de atributos, declaraciones de espacio de nombres, los elementos anidados etc. que requieren una cantidad de tiempo sustancial de procesar. Para limitar el tamaño de la entrada que se envía a XmlTextReader, cree una implementación personalizada de IStream y suminístrela XmlTextReader.
El método de ReadValueChunk se puede utilizar para controlar grandes flujos de datos. Este método lee una pequeña cantidad de caracteres al mismo tiempo en lugar de asignar una única cadena por valor de conjunto.
De forma predeterminada no se expanden a las entidades generales. Expanda a las entidades generales al llamar al método de ResolveEntity .

Notas para los herederos

Esta clase tiene una petición de herencia. la plena confianza se requiere para heredar de XmlTextReader. Vea Peticiones de herencia para obtener más información.

Información de versión

.NET Framework

Compatible con: 4.5, 4, 3.5, 3.0, 2.0, 1.1, 1.0

.NET Framework Client Profile

Compatible con: 4, 3.5 SP1

Plataformas

Windows 8 Release Preview, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008 SP2, Windows Server 2008 R2 (Server Core Role supported with SP1 or later; Itanium not supported)

.NET Framework no admite todas las versiones de todas las plataformas. Para obtener una lista de las versiones compatibles, vea Requisitos de sistema de .NET Framework.

Seguridad para subprocesos

Todos los miembros static (Shared en Visual Basic) públicos de este tipo son seguros para la ejecución de subprocesos. No se garantiza que los miembros de instancias sean seguros para la ejecución de subprocesos.

Vea también

Referencia

System.Xml (Espacio de nombres)

Otros recursos

XML Documents and Data

Security and Your System.Xml Applications