Exportar (0) Imprimir
Expandir todo
Este artículo proviene de un motor de traducción automática. Mueva el puntero sobre las frases del artículo para ver el texto original. Más información.
Traducción
Original

XmlReader (Clase)

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

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

public abstract class XmlReader : IDisposable

El tipo XmlReader expone los siguientes miembros.

  NombreDescripción
Método protegidoCompatible con XNA FrameworkCompatible con Biblioteca de clases portableCompatible con .NET para aplicaciones de la Tienda WindowsXmlReaderInicializa una nueva instancia de la clase XmlReader.
Arriba

  NombreDescripción
Propiedad públicaCompatible con XNA FrameworkCompatible con Biblioteca de clases portableCompatible con .NET para aplicaciones de la Tienda WindowsAttributeCountCuando se invalida en una clase derivada, obtiene el número de atributos en el nodo actual.
Propiedad públicaCompatible con XNA FrameworkCompatible con Biblioteca de clases portableCompatible con .NET para aplicaciones de la Tienda WindowsBaseURICuando se invalida en una clase derivada, obtiene el identificador URI base del nodo actual.
Propiedad públicaCompatible con XNA FrameworkCompatible con Biblioteca de clases portableCompatible con .NET para aplicaciones de la Tienda WindowsCanReadBinaryContentObtiene un valor que indica si XmlReader implementa los métodos de lectura de contenido binario.
Propiedad públicaCompatible con XNA FrameworkCompatible con Biblioteca de clases portableCompatible con .NET para aplicaciones de la Tienda WindowsCanReadValueChunkObtiene un valor que indica si XmlReader implementa el método ReadValueChunk.
Propiedad públicaCompatible con XNA FrameworkCompatible con Biblioteca de clases portableCompatible con .NET para aplicaciones de la Tienda WindowsCanResolveEntityObtiene un valor que indica si este lector puede analizar y resolver entidades.
Propiedad públicaCompatible con XNA FrameworkCompatible con Biblioteca de clases portableCompatible con .NET para aplicaciones de la Tienda WindowsDepthCuando se invalida en una clase derivada, obtiene la profundidad del nodo actual en el documento XML.
Propiedad públicaCompatible con XNA FrameworkCompatible con Biblioteca de clases portableCompatible con .NET para aplicaciones de la Tienda WindowsEOFCuando se invalida en una clase derivada, obtiene un valor que indica si el lector está situado al final de la secuencia.
Propiedad públicaCompatible con XNA FrameworkCompatible con Biblioteca de clases portableCompatible con .NET para aplicaciones de la Tienda WindowsHasAttributesObtiene un valor que indica si el nodo actual tiene atributos.
Propiedad públicaCompatible con XNA FrameworkCompatible con Biblioteca de clases portableCompatible con .NET para aplicaciones de la Tienda WindowsHasValueCuando se invalida en una clase derivada, obtiene un valor que indica si el nodo actual puede tener una propiedad Value.
Propiedad públicaCompatible con XNA FrameworkCompatible con Biblioteca de clases portableCompatible con .NET para aplicaciones de la Tienda WindowsIsDefaultCuando se reemplaza en una clase derivada, obtiene un valor que indica si el nodo actual es un atributo generado a partir del valor predeterminado definido en la DTD o el esquema.
Propiedad públicaCompatible con XNA FrameworkCompatible con Biblioteca de clases portableCompatible con .NET para aplicaciones de la Tienda WindowsIsEmptyElementCuando se invalida en una clase derivada, obtiene un valor que indica si el nodo actual es un elemento vacío (por ejemplo, <MyElement/>).
Propiedad públicaCompatible con XNA FrameworkCompatible con Biblioteca de clases portableCompatible con .NET para aplicaciones de la Tienda WindowsItem[Int32]Cuando se invalida en una clase derivada, obtiene el valor del atributo con el índice especificado.
Propiedad públicaCompatible con XNA FrameworkCompatible con Biblioteca de clases portableCompatible con .NET para aplicaciones de la Tienda WindowsItem[String]Cuando se invalida en una clase derivada, obtiene el valor del atributo con la propiedad Name especificada.
Propiedad públicaCompatible con XNA FrameworkCompatible con Biblioteca de clases portableCompatible con .NET para aplicaciones de la Tienda WindowsItem[String, String]Cuando se invalida en una clase derivada, obtiene el valor del atributo con las propiedades LocalName y NamespaceURI especificadas.
Propiedad públicaCompatible con XNA FrameworkCompatible con Biblioteca de clases portableCompatible con .NET para aplicaciones de la Tienda WindowsLocalNameCuando se invalida en una clase derivada, obtiene el nombre local del nodo actual.
Propiedad públicaCompatible con XNA FrameworkCompatible con Biblioteca de clases portableCompatible con .NET para aplicaciones de la Tienda WindowsNameCuando se invalida en una clase derivada, obtiene el nombre completo del nodo actual.
Propiedad públicaCompatible con XNA FrameworkCompatible con Biblioteca de clases portableCompatible con .NET para aplicaciones de la Tienda WindowsNamespaceURICuando se invalida en una clase derivada, obtiene el identificador 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.
Propiedad públicaCompatible con XNA FrameworkCompatible con Biblioteca de clases portableCompatible con .NET para aplicaciones de la Tienda WindowsNameTableCuando se invalida en una clase derivada, obtiene el objeto XmlNameTable que está asociado a esta implementación.
Propiedad públicaCompatible con XNA FrameworkCompatible con Biblioteca de clases portableCompatible con .NET para aplicaciones de la Tienda WindowsNodeTypeCuando se invalida en una clase derivada, obtiene el tipo del nodo actual.
Propiedad públicaCompatible con XNA FrameworkCompatible con Biblioteca de clases portableCompatible con .NET para aplicaciones de la Tienda WindowsPrefixCuando se invalida en una clase derivada, obtiene el prefijo de espacio de nombres asociado al nodo actual.
Propiedad públicaCompatible con XNA FrameworkQuoteCharCuando se reemplaza en una clase derivada, obtiene el carácter de comillas entre las que se encierra el valor de un nodo de atributo.
Propiedad públicaCompatible con XNA FrameworkCompatible con Biblioteca de clases portableCompatible con .NET para aplicaciones de la Tienda WindowsReadStateCuando se invalida en una clase derivada, obtiene el estado del lector.
Propiedad públicaCompatible con XNA FrameworkSchemaInfoObtiene la información de esquema asignada al nodo actual como resultado de la validación del esquema.
Propiedad públicaCompatible con XNA FrameworkCompatible con Biblioteca de clases portableCompatible con .NET para aplicaciones de la Tienda WindowsSettingsObtiene el objeto XmlReaderSettings utilizado para crear esta instancia de XmlReader.
Propiedad públicaCompatible con XNA FrameworkCompatible con Biblioteca de clases portableCompatible con .NET para aplicaciones de la Tienda WindowsValueCuando se invalida en una clase derivada, obtiene el valor de texto del nodo actual.
Propiedad públicaCompatible con XNA FrameworkCompatible con Biblioteca de clases portableCompatible con .NET para aplicaciones de la Tienda WindowsValueTypeObtiene el tipo de Common Language Runtime (CLR) del nodo actual.
Propiedad públicaCompatible con XNA FrameworkCompatible con Biblioteca de clases portableCompatible con .NET para aplicaciones de la Tienda WindowsXmlLangCuando se invalida en una clase derivada, obtiene el ámbito de xml:lang actual.
Propiedad públicaCompatible con XNA FrameworkCompatible con Biblioteca de clases portableCompatible con .NET para aplicaciones de la Tienda WindowsXmlSpaceCuando se invalida en una clase derivada, obtiene el ámbito de xml:space actual.
Arriba

  NombreDescripción
Método públicoCompatible con XNA FrameworkCloseCuando se invalida en una clase derivada, cambia ReadState a Closed.
Método públicoMiembro estáticoCompatible con XNA FrameworkCompatible con Biblioteca de clases portableCompatible con .NET para aplicaciones de la Tienda WindowsCreate(Stream)Crea una nueva instancia de XmlReader mediante la secuencia especificada.
Método públicoMiembro estáticoCompatible con XNA FrameworkCompatible con .NET para aplicaciones de la Tienda WindowsCreate(String)Crea una nueva instancia de XmlReader con el URI especificado.
Método públicoMiembro estáticoCompatible con XNA FrameworkCompatible con Biblioteca de clases portableCompatible con .NET para aplicaciones de la Tienda WindowsCreate(TextReader)Crea una nueva instancia de XmlReader con el objeto TextReader especificado.
Método públicoMiembro estáticoCompatible con XNA FrameworkCompatible con Biblioteca de clases portableCompatible con .NET para aplicaciones de la Tienda WindowsCreate(Stream, XmlReaderSettings)Crea una nueva instancia de XmlReader con la secuencia y el objeto XmlReaderSettings especificados.
Método públicoMiembro estáticoCompatible con XNA FrameworkCompatible con .NET para aplicaciones de la Tienda WindowsCreate(String, XmlReaderSettings)Crea una nueva instancia con el URI y XmlReaderSettings especificados.
Método públicoMiembro estáticoCompatible con XNA FrameworkCompatible con Biblioteca de clases portableCompatible con .NET para aplicaciones de la Tienda WindowsCreate(TextReader, XmlReaderSettings)Crea una nueva instancia de XmlReader mediante los objetos TextReader y XmlReaderSettings especificados.
Método públicoMiembro estáticoCompatible con XNA FrameworkCompatible con Biblioteca de clases portableCompatible con .NET para aplicaciones de la Tienda WindowsCreate(XmlReader, XmlReaderSettings)Crea una nueva instancia de XmlReader con los objetos XmlReader y XmlReaderSettings especificados.
Método públicoMiembro estáticoCompatible con XNA FrameworkCreate(Stream, XmlReaderSettings, String)Crea una nueva instancia de XmlReader utilizando la secuencia, el URI base y el objeto XmlReaderSettings especificados.
Método públicoMiembro estáticoCompatible con XNA FrameworkCompatible con Biblioteca de clases portableCompatible con .NET para aplicaciones de la Tienda WindowsCreate(Stream, XmlReaderSettings, XmlParserContext)Crea una nueva instancia de XmlReader utilizando la secuencia y los objetos XmlReaderSettings y XmlParserContext especificados.
Método públicoMiembro estáticoCompatible con XNA FrameworkCreate(String, XmlReaderSettings, XmlParserContext)Crea una nueva instancia de XmlReader mediante el URI y los objetos XmlReaderSettings y XmlParserContext especificados.
Método públicoMiembro estáticoCompatible con XNA FrameworkCreate(TextReader, XmlReaderSettings, String)Crea una nueva instancia de XmlReader mediante los objetos TextReader y XmlReaderSettings especificados y el URI base.
Método públicoMiembro estáticoCompatible con XNA FrameworkCompatible con Biblioteca de clases portableCompatible con .NET para aplicaciones de la Tienda WindowsCreate(TextReader, XmlReaderSettings, XmlParserContext)Crea una nueva instancia de XmlReader mediante los objetos TextReader, XmlReaderSettings y XmlParserContext especificados.
Método públicoCompatible con Biblioteca de clases portableCompatible con .NET para aplicaciones de la Tienda WindowsDispose()Libera todos los recursos usados por la instancia actual de la clase XmlReader.
Método protegidoCompatible con XNA FrameworkCompatible con Biblioteca de clases portableCompatible con .NET para aplicaciones de la Tienda WindowsDispose(Boolean)Libera los recursos no administrados que utiliza el objeto XmlReader y, opcionalmente, los recursos administrados.
Método públicoCompatible con XNA FrameworkCompatible con Biblioteca de clases portableCompatible con .NET para aplicaciones de la Tienda WindowsEquals(Object)Determina si el objeto especificado es igual al objeto actual. (Se hereda de Object).
Método protegidoCompatible con XNA FrameworkCompatible con Biblioteca de clases portableCompatible con .NET para aplicaciones de la Tienda WindowsFinalize 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).
Método públicoCompatible con XNA FrameworkCompatible con Biblioteca de clases portableCompatible con .NET para aplicaciones de la Tienda WindowsGetAttribute(Int32)Cuando se invalida en una clase derivada, obtiene el valor del atributo con el índice especificado.
Método públicoCompatible con XNA FrameworkCompatible con Biblioteca de clases portableCompatible con .NET para aplicaciones de la Tienda WindowsGetAttribute(String)Cuando se invalida en una clase derivada, obtiene el valor del atributo con la propiedad Name especificada.
Método públicoCompatible con XNA FrameworkCompatible con Biblioteca de clases portableCompatible con .NET para aplicaciones de la Tienda WindowsGetAttribute(String, String)Cuando se invalida en una clase derivada, obtiene el valor del atributo con las propiedades LocalName y NamespaceURI especificadas.
Método públicoCompatible con XNA FrameworkCompatible con Biblioteca de clases portableCompatible con .NET para aplicaciones de la Tienda WindowsGetHashCode Sirve como una función hash para un tipo en particular. (Se hereda de Object).
Método públicoCompatible con XNA FrameworkCompatible con Biblioteca de clases portableCompatible con .NET para aplicaciones de la Tienda WindowsGetType Obtiene el Type de la instancia actual. (Se hereda de Object).
Método públicoCompatible con .NET para aplicaciones de la Tienda WindowsGetValueAsyncObtiene de forma asincrónica el valor del nodo actual.
Método públicoMiembro estáticoCompatible con XNA FrameworkCompatible con Biblioteca de clases portableCompatible con .NET para aplicaciones de la Tienda WindowsIsNameDevuelve un valor que indica si el argumento de cadena es un nombre XML válido.
Método públicoMiembro estáticoCompatible con XNA FrameworkCompatible con Biblioteca de clases portableCompatible con .NET para aplicaciones de la Tienda WindowsIsNameTokenDevuelve un valor que indica si el argumento de cadena es un token de nombre XML válido.
Método públicoCompatible con XNA FrameworkCompatible con Biblioteca de clases portableCompatible con .NET para aplicaciones de la Tienda WindowsIsStartElement()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.
Método públicoCompatible con XNA FrameworkCompatible con Biblioteca de clases portableCompatible con .NET para aplicaciones de la Tienda WindowsIsStartElement(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.
Método públicoCompatible con XNA FrameworkCompatible con Biblioteca de clases portableCompatible con .NET para aplicaciones de la Tienda WindowsIsStartElement(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.
Método públicoCompatible con XNA FrameworkCompatible con Biblioteca de clases portableCompatible con .NET para aplicaciones de la Tienda WindowsLookupNamespaceCuando se invalida en una clase derivada, resuelve un prefijo de espacio de nombres en el ámbito del elemento actual.
Método protegidoCompatible con XNA FrameworkCompatible con Biblioteca de clases portableCompatible con .NET para aplicaciones de la Tienda WindowsMemberwiseClone Crea una copia superficial del Object actual. (Se hereda de Object).
Método públicoCompatible con XNA FrameworkCompatible con Biblioteca de clases portableCompatible con .NET para aplicaciones de la Tienda WindowsMoveToAttribute(Int32)Cuando se invalida en una clase derivada, se desplaza al atributo con el índice especificado.
Método públicoCompatible con XNA FrameworkCompatible con Biblioteca de clases portableCompatible con .NET para aplicaciones de la Tienda WindowsMoveToAttribute(String)Cuando se invalida en una clase derivada, se desplaza al atributo con la propiedad Name especificada.
Método públicoCompatible con XNA FrameworkCompatible con Biblioteca de clases portableCompatible con .NET para aplicaciones de la Tienda WindowsMoveToAttribute(String, String)Cuando se invalida en una clase derivada, se desplaza al atributo con las propiedades LocalName y NamespaceURI especificadas.
Método públicoCompatible con XNA FrameworkCompatible con Biblioteca de clases portableCompatible con .NET para aplicaciones de la Tienda WindowsMoveToContentComprueba 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.
Método públicoCompatible con .NET para aplicaciones de la Tienda WindowsMoveToContentAsyncDe 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.
Método públicoCompatible con XNA FrameworkCompatible con Biblioteca de clases portableCompatible con .NET para aplicaciones de la Tienda WindowsMoveToElementCuando se invalida en una clase derivada, se desplaza al elemento que contiene el nodo de atributo actual.
Método públicoCompatible con XNA FrameworkCompatible con Biblioteca de clases portableCompatible con .NET para aplicaciones de la Tienda WindowsMoveToFirstAttributeCuando se invalida en una clase derivada, se desplaza hasta el primer atributo.
Método públicoCompatible con XNA FrameworkCompatible con Biblioteca de clases portableCompatible con .NET para aplicaciones de la Tienda WindowsMoveToNextAttributeCuando se invalida en una clase derivada, se desplaza hasta el siguiente atributo.
Método públicoCompatible con XNA FrameworkCompatible con Biblioteca de clases portableCompatible con .NET para aplicaciones de la Tienda WindowsReadCuando se invalida en una clase derivada, lee el siguiente nodo de la secuencia.
Método públicoCompatible con .NET para aplicaciones de la Tienda WindowsReadAsyncDe forma asincrónica lee el nodo siguiente del flujo.
Método públicoCompatible con XNA FrameworkCompatible con Biblioteca de clases portableCompatible con .NET para aplicaciones de la Tienda WindowsReadAttributeValueCuando se invalida en una clase derivada, analiza el valor de atributo en uno o varios nodos Text, EntityReference o EndEntity.
Método públicoCompatible con XNA FrameworkCompatible con Biblioteca de clases portableCompatible con .NET para aplicaciones de la Tienda WindowsReadContentAsLee el contenido como objeto del tipo especificado.
Método públicoCompatible con .NET para aplicaciones de la Tienda WindowsReadContentAsAsyncLee asincrónicamente el contenido como objeto del tipo especificado.
Método públicoCompatible con XNA FrameworkCompatible con Biblioteca de clases portableCompatible con .NET para aplicaciones de la Tienda WindowsReadContentAsBase64Lee el contenido y devuelve los bytes binarios descodificados en Base64.
Método públicoCompatible con .NET para aplicaciones de la Tienda WindowsReadContentAsBase64AsyncLee asincrónicamente el contenido y devuelve los bytes binarios descodificados en Base64.
Método públicoCompatible con XNA FrameworkCompatible con Biblioteca de clases portableCompatible con .NET para aplicaciones de la Tienda WindowsReadContentAsBinHexLee el contenido y devuelve los bytes binarios descodificados de BinHex.
Método públicoCompatible con .NET para aplicaciones de la Tienda WindowsReadContentAsBinHexAsyncLee asincrónicamente el contenido y devuelve los bytes binarios descodificados de BinHex.
Método públicoCompatible con XNA FrameworkCompatible con Biblioteca de clases portableCompatible con .NET para aplicaciones de la Tienda WindowsReadContentAsBooleanLee el contenido de texto en la posición actual como valor Boolean.
Método públicoCompatible con XNA FrameworkReadContentAsDateTimeLee el contenido de texto en la posición actual como un objeto DateTime.
Método públicoCompatible con .NET para aplicaciones de la Tienda WindowsReadContentAsDateTimeOffsetLee el contenido de texto en la posición actual como un objeto DateTimeOffset.
Método públicoCompatible con XNA FrameworkCompatible con Biblioteca de clases portableCompatible con .NET para aplicaciones de la Tienda WindowsReadContentAsDecimalLee el contenido de texto en la posición actual como un objeto Decimal.
Método públicoCompatible con XNA FrameworkCompatible con Biblioteca de clases portableCompatible con .NET para aplicaciones de la Tienda WindowsReadContentAsDoubleLee el contenido de texto en la posición actual como número de punto flotante de precisión doble.
Método públicoCompatible con XNA FrameworkCompatible con Biblioteca de clases portableCompatible con .NET para aplicaciones de la Tienda WindowsReadContentAsFloatLee el contenido de texto en la posición actual como número de punto flotante de precisión sencilla.
Método públicoCompatible con XNA FrameworkCompatible con Biblioteca de clases portableCompatible con .NET para aplicaciones de la Tienda WindowsReadContentAsIntLee el contenido de texto en la posición actual como un entero de 32 bits con signo.
Método públicoCompatible con XNA FrameworkCompatible con Biblioteca de clases portableCompatible con .NET para aplicaciones de la Tienda WindowsReadContentAsLongLee el contenido de texto en la posición actual como un entero de 64 bits con signo.
Método públicoCompatible con XNA FrameworkCompatible con Biblioteca de clases portableCompatible con .NET para aplicaciones de la Tienda WindowsReadContentAsObjectLee el contenido de texto en la posición actual como Object.
Método públicoCompatible con .NET para aplicaciones de la Tienda WindowsReadContentAsObjectAsyncLee asincrónicamente el contenido de texto en la posición actual como un objeto Object.
Método públicoCompatible con XNA FrameworkCompatible con Biblioteca de clases portableCompatible con .NET para aplicaciones de la Tienda WindowsReadContentAsStringLee el contenido de texto en la posición actual como un objeto String.
Método públicoCompatible con .NET para aplicaciones de la Tienda WindowsReadContentAsStringAsyncLee asincrónicamente el contenido de texto en la posición actual como un objeto String.
Método públicoCompatible con XNA FrameworkCompatible con Biblioteca de clases portableCompatible con .NET para aplicaciones de la Tienda WindowsReadElementContentAs(Type, IXmlNamespaceResolver)Lee el contenido de los elementos como el tipo solicitado.
Método públicoCompatible con XNA FrameworkCompatible con Biblioteca de clases portableCompatible con .NET para aplicaciones de la Tienda WindowsReadElementContentAs(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.
Método públicoCompatible con .NET para aplicaciones de la Tienda WindowsReadElementContentAsAsyncLee asincrónicamente el contenido del elemento como el tipo solicitado.
Método públicoCompatible con XNA FrameworkCompatible con Biblioteca de clases portableCompatible con .NET para aplicaciones de la Tienda WindowsReadElementContentAsBase64Lee el elemento y descodifica el contenido de Base64.
Método públicoCompatible con .NET para aplicaciones de la Tienda WindowsReadElementContentAsBase64AsyncLee asincrónicamente el elemento y descodifica el contenido de Base64.
Método públicoCompatible con XNA FrameworkCompatible con Biblioteca de clases portableCompatible con .NET para aplicaciones de la Tienda WindowsReadElementContentAsBinHexLee el elemento y descodifica el contenido de BinHex.
Método públicoCompatible con .NET para aplicaciones de la Tienda WindowsReadElementContentAsBinHexAsyncLee asincrónicamente el elemento y descodifica el contenido de BinHex.
Método públicoCompatible con XNA FrameworkCompatible con Biblioteca de clases portableCompatible con .NET para aplicaciones de la Tienda WindowsReadElementContentAsBoolean()Lee el elemento actual y devuelve el contenido como un objeto Boolean.
Método públicoCompatible con XNA FrameworkCompatible con Biblioteca de clases portableCompatible con .NET para aplicaciones de la Tienda WindowsReadElementContentAsBoolean(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.
Método públicoCompatible con XNA FrameworkReadElementContentAsDateTime()Lee el elemento actual y devuelve el contenido como un objeto DateTime.
Método públicoCompatible con XNA FrameworkReadElementContentAsDateTime(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.
Método públicoCompatible con XNA FrameworkCompatible con Biblioteca de clases portableCompatible con .NET para aplicaciones de la Tienda WindowsReadElementContentAsDecimal()Lee el elemento actual y devuelve el contenido como un objeto Decimal.
Método públicoCompatible con XNA FrameworkCompatible con Biblioteca de clases portableCompatible con .NET para aplicaciones de la Tienda WindowsReadElementContentAsDecimal(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.
Método públicoCompatible con XNA FrameworkCompatible con Biblioteca de clases portableCompatible con .NET para aplicaciones de la Tienda WindowsReadElementContentAsDouble()Lee el elemento actual y devuelve el contenido como número de punto flotante de precisión doble.
Método públicoCompatible con XNA FrameworkCompatible con Biblioteca de clases portableCompatible con .NET para aplicaciones de la Tienda WindowsReadElementContentAsDouble(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.
Método públicoCompatible con XNA FrameworkCompatible con Biblioteca de clases portableCompatible con .NET para aplicaciones de la Tienda WindowsReadElementContentAsFloat()Lee el elemento actual y devuelve el contenido como número de punto flotante de precisión sencilla.
Método públicoCompatible con XNA FrameworkCompatible con Biblioteca de clases portableCompatible con .NET para aplicaciones de la Tienda WindowsReadElementContentAsFloat(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.
Método públicoCompatible con XNA FrameworkCompatible con Biblioteca de clases portableCompatible con .NET para aplicaciones de la Tienda WindowsReadElementContentAsInt()Lee el elemento actual y devuelve el contenido como un entero de 32 bits con signo.
Método públicoCompatible con XNA FrameworkCompatible con Biblioteca de clases portableCompatible con .NET para aplicaciones de la Tienda WindowsReadElementContentAsInt(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.
Método públicoCompatible con XNA FrameworkCompatible con Biblioteca de clases portableCompatible con .NET para aplicaciones de la Tienda WindowsReadElementContentAsLong()Lee el elemento actual y devuelve el contenido como un entero de 64 bits con signo.
Método públicoCompatible con XNA FrameworkCompatible con Biblioteca de clases portableCompatible con .NET para aplicaciones de la Tienda WindowsReadElementContentAsLong(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.
Método públicoCompatible con XNA FrameworkCompatible con Biblioteca de clases portableCompatible con .NET para aplicaciones de la Tienda WindowsReadElementContentAsObject()Lee el elemento actual y devuelve el contenido como objeto Object.
Método públicoCompatible con XNA FrameworkCompatible con Biblioteca de clases portableCompatible con .NET para aplicaciones de la Tienda WindowsReadElementContentAsObject(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.
Método públicoCompatible con .NET para aplicaciones de la Tienda WindowsReadElementContentAsObjectAsyncLee asincrónicamente el elemento actual y devuelve el contenido como objeto Object.
Método públicoCompatible con XNA FrameworkCompatible con Biblioteca de clases portableCompatible con .NET para aplicaciones de la Tienda WindowsReadElementContentAsString()Lee el elemento actual y devuelve el contenido como un objeto String.
Método públicoCompatible con XNA FrameworkCompatible con Biblioteca de clases portableCompatible con .NET para aplicaciones de la Tienda WindowsReadElementContentAsString(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.
Método públicoCompatible con .NET para aplicaciones de la Tienda WindowsReadElementContentAsStringAsyncLee asincrónicamente el elemento actual y devuelve el contenido como un objeto String.
Método públicoCompatible con XNA FrameworkReadElementString()Lee un elemento de sólo texto.
Método públicoCompatible con XNA FrameworkReadElementString(String)Comprueba si la propiedad Name del elemento encontrado coincide con la cadena especificada antes de leer un elemento de sólo texto.
Método públicoCompatible con XNA FrameworkReadElementString(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.
Método públicoCompatible con XNA FrameworkCompatible con Biblioteca de clases portableCompatible con .NET para aplicaciones de la Tienda WindowsReadEndElementComprueba si el nodo de contenido actual es una etiqueta de cierre y desplaza el lector hasta el siguiente nodo.
Método públicoCompatible con XNA FrameworkCompatible con Biblioteca de clases portableCompatible con .NET para aplicaciones de la Tienda WindowsReadInnerXmlCuando se invalida en una clase derivada, lee todo el contenido, incluido el marcado, como una cadena.
Método públicoCompatible con .NET para aplicaciones de la Tienda WindowsReadInnerXmlAsyncDe forma asincrónica lee todo el contenido, incluido el marcado, como una cadena.
Método públicoCompatible con XNA FrameworkCompatible con Biblioteca de clases portableCompatible con .NET para aplicaciones de la Tienda WindowsReadOuterXmlCuando se invalida en una clase derivada, lee el contenido, incluido el marcado, que representa este nodo y todos sus nodos secundarios.
Método públicoCompatible con .NET para aplicaciones de la Tienda WindowsReadOuterXmlAsyncDe forma asincrónica lee el contenido, incluido el marcado, que representa este nodo y todos sus elementos secundarios.
Método públicoCompatible con XNA FrameworkCompatible con Biblioteca de clases portableCompatible con .NET para aplicaciones de la Tienda WindowsReadStartElement()Comprueba si el nodo actual es un elemento y desplaza el lector hasta el siguiente nodo.
Método públicoCompatible con XNA FrameworkCompatible con Biblioteca de clases portableCompatible con .NET para aplicaciones de la Tienda WindowsReadStartElement(String)Comprueba si el nodo de contenido actual es un elemento con la propiedad Name especificada y desplaza el lector hasta el siguiente nodo.
Método públicoCompatible con XNA FrameworkCompatible con Biblioteca de clases portableCompatible con .NET para aplicaciones de la Tienda WindowsReadStartElement(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.
Método públicoCompatible con XNA FrameworkReadStringCuando se reemplaza en una clase derivada, lee el contenido de un nodo de elemento o de texto como una cadena.
Método públicoCompatible con XNA FrameworkCompatible con Biblioteca de clases portableCompatible con .NET para aplicaciones de la Tienda WindowsReadSubtreeDevuelve una nueva instancia de XmlReader que se puede utilizar para leer el nodo actual y todos sus descendientes.
Método públicoCompatible con XNA FrameworkCompatible con Biblioteca de clases portableCompatible con .NET para aplicaciones de la Tienda WindowsReadToDescendant(String)Hace avanzar el objeto XmlReader hasta al siguiente elemento descendiente con el nombre completo especificado.
Método públicoCompatible con XNA FrameworkCompatible con Biblioteca de clases portableCompatible con .NET para aplicaciones de la Tienda WindowsReadToDescendant(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.
Método públicoCompatible con XNA FrameworkCompatible con Biblioteca de clases portableCompatible con .NET para aplicaciones de la Tienda WindowsReadToFollowing(String)Lee hasta que encuentra un elemento con el nombre completo especificado.
Método públicoCompatible con XNA FrameworkCompatible con Biblioteca de clases portableCompatible con .NET para aplicaciones de la Tienda WindowsReadToFollowing(String, String)Lee hasta que encuentra un elemento con el nombre local y el URI de espacio de nombres especificados.
Método públicoCompatible con XNA FrameworkCompatible con Biblioteca de clases portableCompatible con .NET para aplicaciones de la Tienda WindowsReadToNextSibling(String)Hace avanzar el objeto XmlReader hasta al siguiente elemento relacionado con el nombre completo especificado.
Método públicoCompatible con XNA FrameworkCompatible con Biblioteca de clases portableCompatible con .NET para aplicaciones de la Tienda WindowsReadToNextSibling(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.
Método públicoCompatible con XNA FrameworkCompatible con Biblioteca de clases portableCompatible con .NET para aplicaciones de la Tienda WindowsReadValueChunkLee grandes secuencias de texto incrustadas en un documento XML.
Método públicoCompatible con .NET para aplicaciones de la Tienda WindowsReadValueChunkAsyncLee asincrónicamente grandes secuencias de texto incrustadas en un documento XML.
Método públicoCompatible con XNA FrameworkCompatible con Biblioteca de clases portableCompatible con .NET para aplicaciones de la Tienda WindowsResolveEntityCuando se invalida en una clase derivada, resuelve la referencia a entidad para los nodos EntityReference.
Método públicoCompatible con XNA FrameworkCompatible con Biblioteca de clases portableCompatible con .NET para aplicaciones de la Tienda WindowsSkipOmite los nodos secundarios del nodo actual.
Método públicoCompatible con .NET para aplicaciones de la Tienda WindowsSkipAsyncOmite de forma asincrónica los elementos secundarios del valor del nodo actual.
Método públicoCompatible con XNA FrameworkCompatible con Biblioteca de clases portableCompatible con .NET para aplicaciones de la Tienda WindowsToString Retorna una cadena que representa al objeto actual. (Se hereda de Object).
Arriba

  NombreDescripción
Implementación explícita de interfacesMétodo privadoCompatible con XNA FrameworkIDisposable.DisposePara obtener una descripción de este miembro, vea IDisposable.Dispose.
Arriba

XmlReader proporciona acceso de solo lectura y con desplazamiento sólo hacia delante a un flujo de datos XML. La clase XmlReader se ajusta al lenguaje de marcado extensible 1.0 (XML) y a los espacios de nombres de las recomendaciones de XML del Consorcio W3C.

El nodo actual hace referencia al nodo en el que está situado el lector. Avanzan el lector mediante cualquiera de los métodos read, y las propiedades reflejan el valor del nodo actual.

Nota importanteImportante

Aunque .NET Framework incluye implementaciones concretas de la clase de XmlReader , como XmlTextReader, XmlNodeReader, y las clases de XmlValidatingReader , en la versión 2.0 la práctica recomendada es crear instancias de XmlReader utilizando el método de Create . Para obtener más información, vea Creación de sistemas de lectura XML.

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

Para obtener más información sobre la clase XmlReader, vea Leer fragmentos de XML con XmlReader.

Los métodos siguientes se pueden utilizar con llamadas de método asincrónico:

Algunos métodos sincrónicos tienen homólogos asincrónicos que incluyen “Async” al final del nombre del método. Por ejemplo, equivalentes asincrónicos para ReadContentAsXxx y los métodos de ReadElementContentAsXxx son:

Las secciones siguientes describen el uso asincrónico para los métodos que no tienen homólogos asincrónicos.

método ReadStartElement

public static async Task ReadStartElementAsync(this XmlReader reader, string localname, string ns) {
 if (await 
   reader.MoveToContentAsync() != 
   XmlNodeType.Element) {
 throw new 
InvalidOperationException(
reader.NodeType.ToString() + " is an invalid XmlNodeType");
   }
 if (reader.LocalName == 
     localname && 
     reader.NamespaceURI == ns) {
 await reader.ReadAsync();
   }
 else {
 throw new InvalidOperationException("localName or namespace doesn’t match");
    }
}

Método de ReadEndElement

Función de extensión:

public static async Task ReadEndElementAsync(this XmlReader reader) {
if (await reader.MoveToContentAsync() != XmlNodeType.EndElement) {
    throw new InvalidOperationException();
   }
 await reader.ReadAsync();
}

Método de ReadToNextSibling

public static async Task<bool> ReadToNextSiblingAsync(this XmlReader reader, string localName, string namespaceURI) {
 if (localName == null || 
    localName.Length == 0) {
 throw new ArgumentException ("localName is empty or null");
   }
 if (namespaceURI == null) {
 throw new ArgumentNullException("namespaceURI");
   }

// atomize local name and namespace
   localName = 
    reader.NameTable.Add(localName);
   namespaceURI = 
   reader.NameTable.Add(namespaceURI);

// find the next sibling
 XmlNodeType nt;
 do {
 await reader.SkipAsync();
 if (reader.ReadState !=
 ReadState.Interactive)
 break;
      nt = reader.NodeType;
 if (nt == XmlNodeType.Element &&
      ((object)localName == 
      (object)reader.LocalName) && 
      ((object)namespaceURI == 
      (object)reader.NamespaceURI)) {
 return true;
       }
   }while(nt != XmlNodeType.EndElement 

   && !reader.EOF);
 return false;
}

Método de ReadToFollowing

public static async Task<bool> ReadToFollowingAsync(this XmlReader reader, string localName, string namespaceURI) 
{
 if (localName == null || 
     localName.Length == 0) {
 throw new 
     ArgumentException(
     "localName is empty or null");
   }
 if (namespaceURI == null) {
 throw new 
      ArgumentNullException(
     "namespaceURI");
}

// atomize local name and namespace
   localName = 
    reader.NameTable.Add(localName);
   namespaceURI = 
   reader.NameTable.Add(namespaceURI);

// find element with that name
 while (await reader.ReadAsync()) {
 if (reader.NodeType == XmlNodeType.Element && ((object)localName == (object)reader.LocalName) && ((object)namespaceURI == (object)reader.NamespaceURI)) {
 return true;
      }
   }
 return false;
}

Método de ReadToDescendant

public static async Task<bool> ReadToDescendantAsync(this XmlReader reader, string localName, string namespaceURI) {
 if (localName == null || localName.Length == 0) {
 throw new ArgumentException("localName is empty or null");
   }
 if (namespaceURI == null) {
 throw new ArgumentNullException("namespaceURI");
   }
 // save the element or root depth
 int parentDepth = reader.Depth;
 if (reader.NodeType != XmlNodeType.Element) {
 // adjust the depth if we are on root node
if (reader.ReadState == ReadState.Initial) {
    parentDepth--;
   }
else {
     return false;
       }
   }
else if (reader.IsEmptyElement) {
   return false;
}

// atomize local name and namespace
localName = reader.NameTable.Add(localName);
namespaceURI = reader.NameTable.Add(namespaceURI);

// find the descendant
while (await reader.ReadAsync() && reader.Depth > parentDepth) {
if (reader.NodeType == XmlNodeType.Element && ((object)localName == (object)reader.LocalName) && ((object)namespaceURI == (object)reader.NamespaceURI)) {
 return true;
}
}
return false;
}

Consideraciones de seguridad

Debe tener en cuenta los elementos siguientes a la hora de trabajar con la clase XmlReader.

  • Las excepciones iniciadas desde XmlReader pueden revelar información de ruta de acceso que no desea burbujeado hasta la aplicación. Las aplicaciones deben detectar las excepciones y procesarlas correctamente.

  • No habilite el procesamiento de DTD si le preocupan los problemas de Denegación de servicio o si está tratando con orígenes que no son de confíanza. El procesamiento de DTD está deshabilitado de forma predeterminada para los objetos XmlReader creados por el método Create.

    Si tiene el procesamiento de DTD habilitado, puede utilizar XmlSecureResolver para restringir los recursos a los que XmlReader puede tener acceso. También puede diseñar su aplicación para que el procesamiento XML se realice con restricciones de memoria y tiempo. Por ejemplo, puede configurar límites del tiempo de espera en su aplicación ASP.NET

  • Los datos XML pueden incluir referencias a recursos externos como un archivo de esquema. De manera predeterminada, los recursos externos se resuelven utilizando un objeto XmlUrlResolver sin credenciales de usuario. Puede protegerse aún más si realiza una de las acciones siguientes:

  • Las marcas de validación de los campos ProcessInlineSchema y ProcessSchemaLocation de un objeto XmlReaderSettings no se establecen de forma predeterminada. Esto ayuda a proteger el XmlReader contra ataques basados en esquemas cuando está procesando datos XML de un origen que no es de confianza. Cuando se establecen estas marcas, la propiedad XmlResolver del objeto XmlReaderSettings se utiliza para resolver las ubicaciones de esquema encontradas en el documento de instancia del objeto XmlReader. Si se establece la propiedad XmlResolver en null, las ubicaciones de esquemas no se resuelven aunque se establezcan las marcas de validación ProcessInlineSchema y ProcessSchemaLocation.

    Los esquemas agregados durante la validación agregan nuevos tipos y pueden cambiar el resultado de la validación del documento. Por consiguiente, sólo se deben resolver los esquemas externos procedentes de orígenes de confianza.

    Se recomienda deshabilitar la marca ProcessIdentityConstraints (que está habilitado de manera predeterminada) cuando valide documentos XML de gran tamaño que no sean de confianza en situaciones de alta disponibilidad con un esquema que tiene restricciones de identidad en una gran parte del documento.

  • Los datos XML pueden contener un gran número de atributos, declaraciones de espacios de nombres, elementos anidados, etc. que requieren mucho tiempo para su procesamiento. Para limitar el tamaño de la entrada que se envía a XmlReader, puede:

    • Limitar el tamaño del documento estableciendo la propiedad de MaxCharactersInDocument .

    • Limite el número de caracteres ese resultado de entidades que se expanden estableciendo la propiedad de MaxCharactersFromEntities .

    • Cree una implementación personalizada de IStream y suminístrela XmlReader.

  • El método ReadValueChunk puede utilizarse para tratar flujos grandes de datos. Este método lee un número reducido de caracteres cada vez en lugar de asignar una única cadena para todo el valor.

  • Al leer un documento XML con numerosos nombres locales, espacios de nombres o prefijos únicos, puede producirse un problema. Si está utilizando una clase que deriva de XmlReader y llama a la propiedad LocalName, Prefix o NamespaceURI para cada elemento, la cadena devuelta se agrega a una NameTable. La colección contenida por NameTable nunca disminuye de tamaño, creando una "pérdida de memoria" virtual de los identificadores de cadena. Una forma de mitigación es derivar de la clase NameTable y exigir una cuota de tamaño máximo. (No hay ninguna manera de evitar el uso de un NameTable o de cambiar de NameTable cuando está lleno.) Otra solución de mitigación es evitar el uso de las propiedades mencionadas y utilizar en su lugar el método MoveToAttribute con el método IsStartElement cuando sea posible; estos métodos no devuelven cadenas y, por tanto, evitan el problema de llenar demasiado la colección NameTable.

  • Los objetos XmlReaderSettings pueden contener información confidencial, como las credenciales de los usuarios. Un componente que no sea de confianza podría utilizar el objeto XmlReaderSettings y sus credenciales de usuario para crear objetos XmlReader para leer datos. Debe tener cuidado al almacenar objetos XmlReaderSettings en la memoria caché y al pasar el objeto XmlReaderSettings de un componente a otro.

  • No acepte componentes auxiliares, como objetos NameTable, XmlNamespaceManager y XmlResolver, de un origen que no sea de confíanza.

El siguiente código de ejemplo muestra cómo utilizar el asincrónico API para analizar XML.

async Task TestReader(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;
         }
      }
   }
}

.NET Framework

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

.NET Framework Client Profile

Compatible con: 4, 3.5 SP1

Biblioteca de clases portable

Compatible con: Biblioteca de clases portable

.NET para aplicaciones de la Tienda Windows

Compatible con: Windows 8

.NET para aplicaciones de Windows Phone

Compatible con: Windows Phone 8, Silverlight 8.1

Windows Phone 8.1, Windows Phone 8, Windows 8.1, Windows Server 2012 R2, Windows 8, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008 (no se admite el rol Server Core), Windows Server 2008 R2 (se admite el rol Server Core con SP1 o versiones posteriores; no se admite Itanium)

.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.

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.

Adiciones de comunidad

AGREGAR
Mostrar:
© 2014 Microsoft