XmlNodeReader Clase

Definición

Espacio de nombres:

System.Xml

Ensamblado:

System.Xml.ReaderWriter.dll

Source:

XmlNodeReader.cs

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

public ref class XmlNodeReader : System::Xml::XmlReader, System::Xml::IXmlNamespaceResolver

public class XmlNodeReader : System.Xml.XmlReader, System.Xml.IXmlNamespaceResolver

type XmlNodeReader = class
    inherit XmlReader
    interface IXmlNamespaceResolver

Public Class XmlNodeReader
Inherits XmlReader
Implements IXmlNamespaceResolver

Herencia

Object

XmlReader

XmlNodeReader

Implementaciones

IXmlNamespaceResolver

Ejemplos

En el siguiente ejemplo se carga y se modifica un archivo XML en un documento XML. El documento XML se pasa a un XmlNodeReader, que luego se pasa al método XmlReader.Create. Cuando el sistema de lectura de validación analiza el archivo, puede validar cualquier cambio realizado en el archivo XML.

using System;
using System.Xml;
using System.Xml.Schema;
using System.IO;

public class Sample {

  public static void Main() {

    // Create and load the XML document.
    XmlDocument doc = new XmlDocument();
    doc.Load("booksSchema.xml");

    // Make changes to the document.
    XmlElement book = (XmlElement) doc.DocumentElement.FirstChild;
    book.SetAttribute("publisher", "Worldwide Publishing");

    // Create an XmlNodeReader using the XML document.
    XmlNodeReader nodeReader = new XmlNodeReader(doc);

    // Set the validation settings on the XmlReaderSettings object.
    XmlReaderSettings settings = new XmlReaderSettings();
    settings.ValidationType = ValidationType.Schema;
    settings.Schemas.Add("urn:bookstore-schema", "books.xsd");
    settings.ValidationEventHandler += new ValidationEventHandler (ValidationCallBack);

   // Create a validating reader that wraps the XmlNodeReader object.
   XmlReader reader = XmlReader.Create(nodeReader, settings);

   // Parse the XML file.
   while (reader.Read());
  }

  // Display any validation errors.
  private static void ValidationCallBack(object sender, ValidationEventArgs e) {
    Console.WriteLine("Validation Error: {0}", e.Message);
  }
}

Imports System.Xml
Imports System.Xml.Schema
Imports System.IO

public class Sample 

  public shared sub Main() 

    ' Create and load the XML document.
    Dim doc as XmlDocument = new XmlDocument()
    doc.Load("booksSchema.xml")

    ' Make changes to the document.
    Dim book as XmlElement
    book = CType(doc.DocumentElement.FirstChild, XmlElement)
    book.SetAttribute("publisher", "Worldwide Publishing")

    ' Create an XmlNodeReader using the XML document.
    Dim nodeReader as XmlNodeReader = new XmlNodeReader(doc)

    ' Set the validation settings on the XmlReaderSettings object.
    Dim settings as XmlReaderSettings = new XmlReaderSettings()
    settings.ValidationType = ValidationType.Schema
    settings.Schemas.Add("urn:bookstore-schema", "books.xsd")
    AddHandler settings.ValidationEventHandler, AddressOf ValidationCallBack

    ' Create a validating reader that wraps the XmlNodeReader object.
    Dim reader as XmlReader = XmlReader.Create(nodeReader,settings)
    
    ' Parse the XML file.
    while (reader.Read())
    end while
  end sub

  ' Display any validation errors.
  private shared sub ValidationCallBack(sender as object, e as ValidationEventArgs)
    Console.WriteLine("Validation Error: {0}", e.Message)
  end sub

end class

Los dos archivos XML siguientes se usan como entrada.

<?xml version='1.0'?>
<bookstore xmlns="urn:bookstore-schema">
  <book genre="autobiography">
    <title>The Autobiography of Benjamin Franklin</title>
    <author>
      <first-name>Benjamin</first-name>
      <last-name>Franklin</last-name>
    </author>
    <price>8.99</price>
  </book>
  <book genre="novel">
    <title>The Confidence Man</title>
    <author>
      <first-name>Herman</first-name>
      <last-name>Melville</last-name>
    </author>
    <price>11.99</price>
  </book>
</bookstore>

<xsd:schema xmlns:xsd="http://www.w3.org/2001/XMLSchema"
    xmlns="urn:bookstore-schema"
    elementFormDefault="qualified"
    targetNamespace="urn:bookstore-schema">

 <xsd:element name="bookstore" type="bookstoreType"/>

 <xsd:complexType name="bookstoreType">
  <xsd:sequence maxOccurs="unbounded">
   <xsd:element name="book"  type="bookType"/>
  </xsd:sequence>
 </xsd:complexType>

 <xsd:complexType name="bookType">
  <xsd:sequence>
   <xsd:element name="title" type="xsd:string"/>
   <xsd:element name="author" type="authorName"/>
   <xsd:element name="price"  type="xsd:decimal"/>
  </xsd:sequence>
  <xsd:attribute name="genre" type="xsd:string"/>
 </xsd:complexType>

 <xsd:complexType name="authorName">
  <xsd:sequence>
   <xsd:element name="first-name"  type="xsd:string"/>
   <xsd:element name="last-name" type="xsd:string"/>
  </xsd:sequence>
 </xsd:complexType>

</xsd:schema>

Salida:

Error de validación: no se ha declarado el atributo 'publisher'.

Comentarios

Nota

En lugar de usar XmlNodeReader, se recomienda crear XmlReader instancias mediante la XmlReaderSettings clase y el Create método . Esto le permite aprovechar la comprobación de conformidad y el cumplimiento de la recomendación XML 1.0.

XmlNodeReader tiene la capacidad de leer un subárbol XML DOM. Esta clase no admite la definición de tipo de documento (DTD) ni la validación del esquema. Sin embargo, puede crear un XmlReader objeto que se ajuste alrededor del XmlNodeReader objeto para validar los datos almacenados en el XmlNodeReader objeto, como se muestra en la sección Ejemplos.

Constructores

XmlNodeReader(XmlNode)

Crea una instancia de la clase XmlNodeReader mediante el objeto XmlNode especificado.

Propiedades

AttributeCount	Obtiene el número de atributos del nodo actual.
BaseURI	Obtiene el identificador URI base del nodo actual.
CanReadBinaryContent	Obtiene un valor que indica si XmlNodeReader implementa los métodos de lectura de contenido binario.
CanReadValueChunk	Obtiene un valor que indica si XmlReader implementa el método ReadValueChunk(Char[], Int32, Int32). (Heredado de XmlReader)
CanResolveEntity	Obtiene un valor que indica si este lector puede analizar y resolver entidades.
Depth	Obtiene la profundidad del nodo actual en el documento XML.
EOF	Obtiene un valor que indica si el lector está situado al final del flujo.
HasAttributes	Obtiene un valor que indica si el nodo actual tiene algún atributo.
HasValue	Obtiene un valor que indica si el nodo actual puede tener una propiedad Value.
IsDefault	Obtiene un valor que indica si el nodo actual es un atributo generado a partir del valor predeterminado definido en la definición de tipo de documento (DTD) o en el esquema.
IsEmptyElement	Obtiene un valor que indica si el nodo actual es un elemento vacío (por ejemplo, <MyElement/>).
Item[Int32]	Cuando se invalida en una clase derivada, obtiene el valor del atributo con el índice especificado. (Heredado de XmlReader)
Item[String, String]	Cuando se invalida en una clase derivada, obtiene el valor del atributo con las propiedades LocalName y NamespaceURI especificadas. (Heredado de XmlReader)
Item[String]	Cuando se invalida en una clase derivada, obtiene el valor del atributo con la propiedad Name especificada. (Heredado de XmlReader)
LocalName	Obtiene el nombre local del nodo actual.
Name	Obtiene el nombre completo del nodo actual.
NamespaceURI	Obtiene el URI de espacio de nombres (según se define en la especificación relativa a espacios de nombres del Consorcio W3C) del nodo en el que está situado el lector.
NameTable	Obtiene el XmlNameTable asociado a esta implementación.
NodeType	Obtiene el tipo del nodo actual.
Prefix	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 entre las que se encierra el valor de un nodo de atributo. (Heredado de XmlReader)
ReadState	Obtiene el estado del lector.
SchemaInfo	Obtiene la información de esquema que se ha asignado al nodo actual.
Settings	Obtiene el objeto XmlReaderSettings que se usa para crear esta instancia de XmlReader. (Heredado de XmlReader)
Value	Obtiene el valor de texto del nodo actual.
ValueType	Obtiene el tipo de Common Language Runtime (CLR) del nodo actual. (Heredado de XmlReader)
XmlLang	Obtiene el ámbito de xml:lang actual.
XmlSpace	Obtiene el ámbito de xml:space actual.

Métodos

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

Implementaciones de interfaz explícitas

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