XmlReader Clase

Definición

Espacio de nombres:

System.Xml

Ensamblado:

System.Xml.dll

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

public ref class XmlReader abstract : IDisposable

public abstract class XmlReader : IDisposable

type XmlReader = class
    interface IDisposable

Public MustInherit Class XmlReader
Implements IDisposable

Herencia

Object

XmlReader

Derivado

System.Xml.XmlDictionaryReader

System.Xml.XmlNodeReader

System.Xml.XmlTextReader

System.Xml.XmlValidatingReader

Implementaciones

IDisposable

Ejemplos

En el código de ejemplo siguiente se muestra cómo usar la API asincrónica para analizar XML.

async Task TestReader(System.IO.Stream stream)
{
    XmlReaderSettings settings = new XmlReaderSettings();
    settings.Async = true;

    using (XmlReader reader = XmlReader.Create(stream, settings))
    {
        while (await reader.ReadAsync())
        {
            switch (reader.NodeType)
            {
                case XmlNodeType.Element:
                    Console.WriteLine("Start Element {0}", reader.Name);
                    break;
                case XmlNodeType.Text:
                    Console.WriteLine("Text Node: {0}",
                             await reader.GetValueAsync());
                    break;
                case XmlNodeType.EndElement:
                    Console.WriteLine("End Element {0}", reader.Name);
                    break;
                default:
                    Console.WriteLine("Other node {0} with value {1}",
                                    reader.NodeType, reader.Value);
                    break;
            }
        }
    }
}

Public Async Function TestReader(stream As System.IO.Stream) As Task
    Dim settings As New XmlReaderSettings()
    settings.Async = True

    Using reader As XmlReader = XmlReader.Create(stream, settings)
        While (Await reader.ReadAsync())
            Select Case (reader.NodeType)
                Case XmlNodeType.Element
                    Console.WriteLine("Start Element {0}", reader.Name)
                Case XmlNodeType.Text
                    Console.WriteLine("Text Node: {0}",
                             Await reader.GetValueAsync())
                Case XmlNodeType.EndElement
                    Console.WriteLine("End Element {0}", reader.Name)
                Case Else
                    Console.WriteLine("Other node {0} with value {1}",
                                    reader.NodeType, reader.Value)
            End Select
        End While
    End Using
End Function

Comentarios

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

Constructores

Nombre	Description
XmlReader()	Inicializa una nueva instancia de la clase XmlReader.

Propiedades

Nombre	Description
AttributeCount	Cuando se reemplaza en una clase derivada, obtiene el número de atributos en el nodo actual.
BaseURI	Cuando se reemplaza en una clase derivada, obtiene el URI base del nodo actual.
CanReadBinaryContent	Obtiene un valor que indica si XmlReader implementa los métodos de lectura de contenido binario.
CanReadValueChunk	Obtiene un valor que indica si implementa XmlReader el ReadValueChunk(Char[], Int32, Int32) método .
CanResolveEntity	Obtiene un valor que indica si este lector puede analizar y resolver entidades.
Depth	Cuando se reemplaza en una clase derivada, obtiene la profundidad del nodo actual en el documento XML.
EOF	Cuando se reemplaza en una clase derivada, obtiene un valor que indica si el lector está situado al final de la secuencia.
HasAttributes	Obtiene un valor que indica si el nodo actual tiene atributos.
HasValue	Cuando se reemplaza en una clase derivada, obtiene un valor que indica si el nodo actual puede tener .Value
IsDefault	Cuando se reemplaza en una clase derivada, 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 el esquema.
IsEmptyElement	Cuando se reemplaza en una clase derivada, obtiene un valor que indica si el nodo actual es un elemento vacío (por ejemplo, <MyElement/>).
Item[Int32]	Cuando se reemplaza en una clase derivada, obtiene el valor del atributo con el índice especificado.
Item[String, String]	Cuando se reemplaza en una clase derivada, obtiene el valor del atributo con el especificado LocalName y NamespaceURI.
Item[String]	Cuando se reemplaza en una clase derivada, obtiene el valor del atributo con el especificado Name.
LocalName	Cuando se reemplaza en una clase derivada, obtiene el nombre local del nodo actual.
Name	Cuando se reemplaza en una clase derivada, obtiene el nombre completo del nodo actual.
NamespaceURI	Cuando se reemplaza en una clase derivada, obtiene el URI del espacio de nombres (tal como se define en la especificación del espacio de nombres W3C) del nodo en el que se coloca el lector.
NameTable	Cuando se invalida en una clase derivada, obtiene el XmlNameTable asociado a esta implementación.
NodeType	Cuando se reemplaza en una clase derivada, obtiene el tipo del nodo actual.
Prefix	Cuando se reemplaza en una clase derivada, obtiene el prefijo de espacio de nombres asociado al nodo actual.
QuoteChar	Cuando se reemplaza en una clase derivada, obtiene el carácter de comillas usado para incluir el valor de un nodo de atributo.
ReadState	Cuando se reemplaza en una clase derivada, obtiene el estado del lector.
SchemaInfo	Obtiene la información de esquema que se ha asignado al nodo actual como resultado de la validación del esquema.
Settings	Obtiene el XmlReaderSettings objeto usado para crear esta XmlReader instancia.
Value	Cuando se reemplaza en una clase derivada, obtiene el valor de texto del nodo actual.
ValueType	Obtiene el tipo Common Language Runtime (CLR) para el nodo actual.
XmlLang	Cuando se invalida en una clase derivada, obtiene el ámbito actual xml:lang .
XmlSpace	Cuando se invalida en una clase derivada, obtiene el ámbito actual xml:space .

Métodos

Nombre	Description
Close()	Cuando se reemplaza en una clase derivada, cambia a ReadStateClosed.
Create(Stream, XmlReaderSettings, String)	Crea una nueva XmlReader instancia con la secuencia, el URI base y la configuración especificados.
Create(Stream, XmlReaderSettings, XmlParserContext)	Crea una nueva XmlReader instancia mediante la secuencia, la configuración y la información de contexto especificadas para el análisis.
Create(Stream, XmlReaderSettings)	Crea una nueva XmlReader instancia con la secuencia y la configuración especificadas.
Create(Stream)	Crea una nueva XmlReader instancia mediante el flujo especificado con la configuración predeterminada.
Create(String, XmlReaderSettings, XmlParserContext)	Crea una nueva XmlReader instancia mediante el URI, la configuración y la información de contexto especificadas para el análisis.
Create(String, XmlReaderSettings)	Crea una nueva XmlReader instancia mediante el URI y la configuración especificados.
Create(String)	Crea una nueva XmlReader instancia con el URI especificado.
Create(TextReader, XmlReaderSettings, String)	Crea una nueva XmlReader instancia mediante el lector de texto, la configuración y el URI base especificados.
Create(TextReader, XmlReaderSettings, XmlParserContext)	Crea una nueva XmlReader instancia mediante el lector de texto, la configuración y la información de contexto especificadas para el análisis.
Create(TextReader, XmlReaderSettings)	Crea una nueva XmlReader instancia mediante el lector de texto y la configuración especificados.
Create(TextReader)	Crea una nueva XmlReader instancia mediante el lector de texto especificado.
Create(XmlReader, XmlReaderSettings)	Crea una nueva XmlReader instancia mediante el lector XML y la configuración especificados.
Dispose()	Libera todos los recursos usados por la instancia actual de la XmlReader clase .
Dispose(Boolean)	Libera los recursos no administrados utilizados por XmlReader y, opcionalmente, libera los recursos administrados.
Equals(Object)	Determina si el objeto especificado es igual al objeto actual. (Heredado de Object)
GetAttribute(Int32)	Cuando se reemplaza en una clase derivada, obtiene el valor del atributo con el índice especificado.
GetAttribute(String, String)	Cuando se reemplaza en una clase derivada, obtiene el valor del atributo con el especificado LocalName y NamespaceURI.
GetAttribute(String)	Cuando se reemplaza en una clase derivada, obtiene el valor del atributo con el especificado Name.
GetHashCode()	Actúa como la función hash predeterminada. (Heredado de Object)
GetType()	Obtiene el Type de la instancia actual. (Heredado de Object)
GetValueAsync()	Obtiene de forma asincrónica el valor del nodo actual.
IsName(String)	Devuelve un valor que indica si el argumento de cadena es un nombre XML válido.
IsNameToken(String)	Devuelve un valor que indica si el argumento de cadena es un token de nombre XML válido.
IsStartElement()	Llama MoveToContent() a y comprueba si el nodo de contenido actual es una etiqueta de inicio o una etiqueta de elemento vacía.
IsStartElement(String, String)	Llama MoveToContent() a y comprueba si el nodo de contenido actual es una etiqueta de inicio o una etiqueta de elemento vacía y si las LocalName propiedades y NamespaceURI del elemento encontrado coinciden con las cadenas especificadas.
IsStartElement(String)	Llama MoveToContent() a y comprueba si el nodo de contenido actual es una etiqueta de inicio o una etiqueta de elemento vacía y si la Name propiedad del elemento encontrado coincide con el argumento especificado.
LookupNamespace(String)	Cuando se reemplaza en una clase derivada, resuelve un prefijo de espacio de nombres en el ámbito del elemento actual.
MemberwiseClone()	Crea una copia superficial del Objectactual. (Heredado de Object)
MoveToAttribute(Int32)	Cuando se invalida en una clase derivada, se mueve al atributo con el índice especificado.
MoveToAttribute(String, String)	Cuando se invalida en una clase derivada, se mueve al atributo con el especificado LocalName y NamespaceURI.
MoveToAttribute(String)	Cuando se reemplaza en una clase derivada, se mueve al atributo con el especificado Name.
MoveToContent()	Comprueba si el nodo actual es un nodo de contenido (texto que no es de espacio en blanco, CDATA, ElementEndElement, , EntityReferenceo EndEntity). Si el nodo no es un nodo de contenido, el lector se omite al siguiente nodo de contenido o al final del archivo. Omite los nodos del tipo siguiente: ProcessingInstruction, DocumentType, Comment, Whitespaceo SignificantWhitespace.
MoveToContentAsync()	Comprueba de forma asincrónica si el nodo actual es un nodo de contenido. Si el nodo no es un nodo de contenido, el lector se omite al siguiente nodo de contenido o al final del archivo.
MoveToElement()	Cuando se invalida en una clase derivada, se mueve al elemento que contiene el nodo de atributo actual.
MoveToFirstAttribute()	Cuando se invalida en una clase derivada, se mueve al primer atributo.
MoveToNextAttribute()	Cuando se invalida en una clase derivada, se mueve al atributo siguiente.
Read()	Cuando se reemplaza en una clase derivada, lee el siguiente nodo de la secuencia.
ReadAsync()	Lee de forma asincrónica el siguiente nodo de la secuencia.
ReadAttributeValue()	Cuando se invalida en una clase derivada, analiza el valor del atributo en uno o varios Textnodos , EntityReferenceo EndEntity .
ReadContentAs(Type, IXmlNamespaceResolver)	Lee el contenido como un objeto del tipo especificado.
ReadContentAsAsync(Type, IXmlNamespaceResolver)	Lee de forma asincrónica el contenido como un objeto del tipo especificado.
ReadContentAsBase64(Byte[], Int32, Int32)	Lee el contenido y devuelve los bytes binarios descodificados de Base64.
ReadContentAsBase64Async(Byte[], Int32, Int32)	Lee de forma asincrónica el contenido y devuelve los bytes binarios descodificados de Base64.
ReadContentAsBinHex(Byte[], Int32, Int32)	Lee el contenido y devuelve los BinHex bytes binarios descodificados.
ReadContentAsBinHexAsync(Byte[], Int32, Int32)	Lee de forma asincrónica el contenido y devuelve los BinHex bytes binarios descodificados.
ReadContentAsBoolean()	Lee el contenido de texto en la posición actual como .Boolean
ReadContentAsDateTime()	Lee el contenido de texto en la posición actual como un DateTime objeto .
ReadContentAsDateTimeOffset()	Lee el contenido de texto en la posición actual como un DateTimeOffset objeto .
ReadContentAsDecimal()	Lee el contenido de texto en la posición actual como un Decimal objeto .
ReadContentAsDouble()	Lee el contenido de texto en la posición actual como un número de punto flotante de precisión doble.
ReadContentAsFloat()	Lee el contenido de texto en la posición actual como un número de punto flotante de precisión sencilla.
ReadContentAsInt()	Lee el contenido de texto en la posición actual como un entero de 32 bits con signo.
ReadContentAsLong()	Lee el contenido de texto en la posición actual como un entero de 64 bits con signo.
ReadContentAsObject()	Lee el contenido de texto en la posición actual como .Object
ReadContentAsObjectAsync()	Lee de forma asincrónica el contenido de texto en la posición actual como .Object
ReadContentAsString()	Lee el contenido de texto en la posición actual como un String objeto .
ReadContentAsStringAsync()	Lee de forma asincrónica el contenido de texto en la posición actual como un String objeto .
ReadElementContentAs(Type, IXmlNamespaceResolver, String, String)	Comprueba que el nombre local especificado y el URI del espacio de nombres coincidan con el del elemento actual y, a continuación, lee el contenido del elemento como el tipo solicitado.
ReadElementContentAs(Type, IXmlNamespaceResolver)	Lee el contenido del elemento como el tipo solicitado.
ReadElementContentAsAsync(Type, IXmlNamespaceResolver)	Lee de forma asincrónica el contenido del elemento como el tipo solicitado.
ReadElementContentAsBase64(Byte[], Int32, Int32)	Lee el elemento y descodifica el Base64 contenido.
ReadElementContentAsBase64Async(Byte[], Int32, Int32)	Lee de forma asincrónica el elemento y descodifica el Base64 contenido.
ReadElementContentAsBinHex(Byte[], Int32, Int32)	Lee el elemento y descodifica el BinHex contenido.
ReadElementContentAsBinHexAsync(Byte[], Int32, Int32)	Lee de forma asincrónica el elemento y descodifica el BinHex contenido.
ReadElementContentAsBoolean()	Lee el elemento actual y devuelve el contenido como un Boolean objeto .
ReadElementContentAsBoolean(String, String)	Comprueba que el nombre local especificado y el URI del espacio de nombres coincidan con el del elemento actual y, a continuación, lee el elemento actual y devuelve el contenido como un Boolean objeto .
ReadElementContentAsDateTime()	Lee el elemento actual y devuelve el contenido como un DateTime objeto .
ReadElementContentAsDateTime(String, String)	Comprueba que el nombre local especificado y el URI del espacio de nombres coincidan con el del elemento actual y, a continuación, lee el elemento actual y devuelve el contenido como un DateTime objeto .
ReadElementContentAsDecimal()	Lee el elemento actual y devuelve el contenido como un Decimal objeto .
ReadElementContentAsDecimal(String, String)	Comprueba que el nombre local especificado y el URI del espacio de nombres coincidan con el del elemento actual y, a continuación, lee el elemento actual y devuelve el contenido como un Decimal objeto .
ReadElementContentAsDouble()	Lee el elemento actual y devuelve el contenido como un número de punto flotante de precisión doble.
ReadElementContentAsDouble(String, String)	Comprueba que el nombre local especificado y el URI del espacio de nombres coincidan con el del elemento actual y, a continuación, lee el elemento actual y devuelve el contenido como un número de punto flotante de precisión doble.
ReadElementContentAsFloat()	Lee el elemento actual y devuelve el contenido como número de punto flotante de precisión sencilla.
ReadElementContentAsFloat(String, String)	Comprueba que el nombre local especificado y el URI del espacio de nombres coincidan con el del elemento actual y, a continuación, lee el elemento actual y devuelve el contenido como un número de punto flotante de precisión única.
ReadElementContentAsInt()	Lee el elemento actual y devuelve el contenido como un entero de 32 bits con signo.
ReadElementContentAsInt(String, String)	Comprueba que el nombre local especificado y el URI del espacio de nombres coincidan con el del elemento actual y, a continuación, lee el elemento actual y devuelve el contenido como un entero con signo de 32 bits.
ReadElementContentAsLong()	Lee el elemento actual y devuelve el contenido como un entero de 64 bits con signo.
ReadElementContentAsLong(String, String)	Comprueba que el nombre local especificado y el URI del espacio de nombres coincidan con el del elemento actual y, a continuación, lee el elemento actual y devuelve el contenido como un entero con signo de 64 bits.
ReadElementContentAsObject()	Lee el elemento actual y devuelve el contenido como .Object
ReadElementContentAsObject(String, String)	Comprueba que el nombre local especificado y el URI del espacio de nombres coincidan con el del elemento actual y, a continuación, lee el elemento actual y devuelve el contenido como .Object
ReadElementContentAsObjectAsync()	Lee de forma asincrónica el elemento actual y devuelve el contenido como .Object
ReadElementContentAsString()	Lee el elemento actual y devuelve el contenido como un String objeto .
ReadElementContentAsString(String, String)	Comprueba que el nombre local especificado y el URI del espacio de nombres coincidan con el del elemento actual y, a continuación, lee el elemento actual y devuelve el contenido como un String objeto .
ReadElementContentAsStringAsync()	Lee de forma asincrónica el elemento actual y devuelve el contenido como un String objeto .
ReadElementString()	Lee un elemento de solo texto. Sin embargo, se recomienda usar el ReadElementContentAsString() método en su lugar, ya que proporciona una manera más sencilla de controlar esta operación.
ReadElementString(String, String)	Comprueba que las LocalName propiedades y NamespaceURI del elemento encontrado coinciden con las cadenas especificadas antes de leer un elemento de solo texto. Sin embargo, se recomienda usar el ReadElementContentAsString(String, String) método en su lugar, ya que proporciona una manera más sencilla de controlar esta operación.
ReadElementString(String)	Comprueba que la Name propiedad del elemento encontrado coincide con la cadena especificada antes de leer un elemento de solo texto. Sin embargo, se recomienda usar el ReadElementContentAsString() método en su lugar, ya que proporciona una manera más sencilla de controlar esta operación.
ReadEndElement()	Comprueba que el nodo de contenido actual es una etiqueta final y avanza el lector al siguiente nodo.
ReadInnerXml()	Cuando se invalida en una clase derivada, lee todo el contenido, incluido el marcado, como una cadena.
ReadInnerXmlAsync()	Lee de forma asincrónica todo el contenido, incluido el marcado, como una cadena.
ReadOuterXml()	Cuando se reemplaza en una clase derivada, lee el contenido, incluido el marcado, que representa este nodo y todos sus elementos secundarios.
ReadOuterXmlAsync()	Lee de forma asincrónica el contenido, incluido el marcado, que representa este nodo y todos sus elementos secundarios.
ReadStartElement()	Comprueba que el nodo actual es un elemento y hace avanzar el lector al siguiente nodo.
ReadStartElement(String, String)	Comprueba que el nodo de contenido actual es un elemento con el especificado LocalName y avanza NamespaceURI el lector al siguiente nodo.
ReadStartElement(String)	Comprueba que el nodo de contenido actual es un elemento con el especificado Name y avanza el lector al siguiente nodo.
ReadString()	Cuando se reemplaza en una clase derivada, lee el contenido de un elemento o nodo de texto como una cadena. Sin embargo, se recomienda usar el ReadElementContentAsString método en su lugar, ya que proporciona una manera más sencilla de controlar esta operación.
ReadSubtree()	Devuelve una nueva XmlReader instancia que se puede usar para leer el nodo actual y todos sus descendientes.
ReadToDescendant(String, String)	Avanza al XmlReader siguiente elemento descendiente con el nombre local y el URI del espacio de nombres especificados.
ReadToDescendant(String)	Avanza al XmlReader siguiente elemento descendiente con el nombre completo especificado.
ReadToFollowing(String, String)	Lee hasta que se encuentra un elemento con el nombre local y el URI del espacio de nombres especificados.
ReadToFollowing(String)	Lee hasta que se encuentra un elemento con el nombre completo especificado.
ReadToNextSibling(String, String)	Avanza al XmlReader siguiente elemento relacionado con el nombre local y el URI del espacio de nombres especificados.
ReadToNextSibling(String)	Avanza al XmlReader siguiente elemento relacionado con el nombre completo especificado.
ReadValueChunk(Char[], Int32, Int32)	Lee grandes secuencias de texto incrustadas en un documento XML.
ReadValueChunkAsync(Char[], Int32, Int32)	Lee asincrónicamente grandes secuencias de texto incrustadas en un documento XML.
ResolveEntity()	Cuando se invalida en una clase derivada, resuelve la referencia de entidad para EntityReference los nodos.
Skip()	Omite los elementos secundarios del nodo actual.
SkipAsync()	Omite de forma asincrónica los elementos secundarios del nodo actual.
ToString()	Devuelve una cadena que representa el objeto actual. (Heredado de Object)

Consulte también

• Documentos y datos XML