XmlNodeReader Classe

Définition

Espace de noms:

System.Xml

Assembly:

System.Xml.ReaderWriter.dll

Source:

XmlNodeReader.cs

Représente un lecteur fournissant un accès aux données XML par un flux rapide, non mis en cache et avant uniquement dans 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

Héritage

Object

XmlReader

XmlNodeReader

Implémente

IXmlNamespaceResolver

Exemples

Dans l'exemple suivant, un fichier XML est chargé dans un document XML et modifié. Le document XML est transmis à un objet XmlNodeReader, qui est ensuite transmis à la méthode XmlReader.Create. Lorsque le lecteur de validation analyse le fichier, il peut valider tous les changements apportés au fichier 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

Les deux fichiers XML suivants sont utilisés comme entrée.

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

Sortie :

Erreur de validation : l’attribut « publisher » n’est pas déclaré.

Remarques

Notes

Au lieu d’utiliser , XmlNodeReadernous vous recommandons de créer XmlReader des instances à l’aide de la XmlReaderSettings classe et de la Create méthode . Cela vous permet de tirer parti de la vérification de la conformité et de la conformité à la recommandation XML 1.0.

XmlNodeReader a la possibilité de lire une sous-arborescence DOM XML. Cette classe ne prend pas en charge la définition de type document (DTD) ou la validation de schéma. Toutefois, vous pouvez créer un XmlReader objet qui encapsule l’objet XmlNodeReader pour valider les données stockées dans l’objet, comme indiqué dans la XmlNodeReader section Exemples.

Constructeurs

XmlNodeReader(XmlNode)

Crée une instance de la classe XmlNodeReader à l'aide du XmlNode spécifié.

Propriétés

AttributeCount	Obtient le nombre d'attributs du nœud actuel.
BaseURI	Obtient l'URI de base du nœud actuel.
CanReadBinaryContent	Obtient une valeur indiquant si XmlNodeReader implémente les méthodes de lecture de contenu binaire.
CanReadValueChunk	Obtient une valeur indiquant si XmlReader implémente la méthode ReadValueChunk(Char[], Int32, Int32). (Hérité de XmlReader)
CanResolveEntity	Obtient une valeur indiquant si ce lecteur peut analyser et résoudre les entités.
Depth	Obtient la profondeur du nœud actuel dans le document XML.
EOF	Obtient une valeur indiquant si le lecteur est placé à la fin du flux.
HasAttributes	Obtient une valeur indiquant si le nœud actuel a des attributs.
HasValue	Obtient une valeur indiquant si le nœud actuel possède Value.
IsDefault	Obtient une valeur indiquant si le nœud actuel est un attribut généré à partir de la valeur par défaut définie dans la définition de type de document (DTD) ou le schéma.
IsEmptyElement	Obtient une valeur indiquant si le nœud actuel est un élément vide (par exemple, <MyElement/>).
Item[Int32]	En cas de substitution dans une classe dérivée, obtient la valeur de l'attribut avec l'index spécifié. (Hérité de XmlReader)
Item[String, String]	En cas de substitution dans une classe dérivée, obtient la valeur de l'attribut avec le LocalName et le NamespaceURI spécifiés. (Hérité de XmlReader)
Item[String]	En cas de substitution dans une classe dérivée, obtient la valeur de l'attribut avec le Name spécifié. (Hérité de XmlReader)
LocalName	Obtient le nom local du nœud actuel.
Name	Obtient le nom qualifié du nœud actuel.
NamespaceURI	Obtient l'URI d'espace de noms (tel qu'il est défini dans la spécification relative aux espaces de noms du W3C) du nœud sur lequel le lecteur est placé.
NameTable	Obtient l'élément XmlNameTable associé à cette implémentation.
NodeType	Obtient le type du nœud actuel.
Prefix	Obtient le préfixe de l'espace de noms associé au nœud actuel.
QuoteChar	En cas de substitution dans une classe dérivée, obtient le caractère guillemet permettant de délimiter la valeur d'un nœud d'attribut. (Hérité de XmlReader)
ReadState	Obtient l'état du lecteur.
SchemaInfo	Obtient les informations de schéma qui ont été assignées au nœud actuel.
Settings	Obtient l'objet XmlReaderSettings permettant de créer cette instance de XmlReader. (Hérité de XmlReader)
Value	Obtient le texte du nœud actuel.
ValueType	Obtient le type de CLR du nœud actuel. (Hérité de XmlReader)
XmlLang	Obtient la portée de xml:lang actuelle.
XmlSpace	Obtient la portée de xml:space actuelle.

Méthodes

Close()	Modifie ReadState en lui attribuant la valeur Closed.
Dispose()	Libère toutes les ressources utilisées par l'instance actuelle de la classe XmlReader. (Hérité de XmlReader)
Dispose(Boolean)	Libère les ressources non managées utilisées par XmlReader et libère éventuellement les ressources managées. (Hérité de XmlReader)
Equals(Object)	Détermine si l'objet spécifié est égal à l'objet actuel. (Hérité de Object)
GetAttribute(Int32)	Obtient la valeur de l'attribut avec l'index spécifié.
GetAttribute(String)	Obtient la valeur de l'attribut avec le nom spécifié.
GetAttribute(String, String)	Obtient la valeur de l'attribut avec le nom local et l'URI de l'espace de noms spécifiés.
GetHashCode()	Fait office de fonction de hachage par défaut. (Hérité de Object)
GetType()	Obtient le Type de l'instance actuelle. (Hérité de Object)
GetValueAsync()	Obtient de façon asynchrone la valeur du nœud actuel. (Hérité de XmlReader)
IsStartElement()	Appelle MoveToContent() et vérifie si le nœud de contenu actuel est une balise de début ou une balise d'élément vide. (Hérité de XmlReader)
IsStartElement(String)	Appelle MoveToContent(), vérifie si le nœud de contenu actuel est une balise de début ou une balise d'élément vide, puis vérifie également si la propriété Name de l'élément trouvé correspond à l'argument spécifié. (Hérité de XmlReader)
IsStartElement(String, String)	Appelle MoveToContent(), vérifie si le nœud de contenu actuel est une balise de début ou une balise d'élément vide, puis vérifie également si les propriétés LocalName et NamespaceURI de l'élément trouvé correspondent aux chaînes spécifiées. (Hérité de XmlReader)
LookupNamespace(String)	Résout un préfixe de l'espace de noms dans la portée de l'élément actuel.
MemberwiseClone()	Crée une copie superficielle du Object actuel. (Hérité de Object)
MoveToAttribute(Int32)	Se déplace vers l'attribut avec l'index spécifié.
MoveToAttribute(String)	Se déplace vers l'attribut avec le nom spécifié.
MoveToAttribute(String, String)	Se déplace vers l'attribut avec le nom local et l'URI d'espace de noms spécifiés.
MoveToContent()	Vérifie si le nœud actuel est un nœud de contenu (texte non constitué d'espaces blancs, CDATA, Element, EndElement, EntityReference ou EndEntity). Si le nœud n'est pas un nœud de contenu, le lecteur avance jusqu'au nœud de contenu suivant ou jusqu'à la fin du fichier. Il ignore les nœuds possédant les types suivants : ProcessingInstruction, DocumentType, Comment, Whitespace ou SignificantWhitespace. (Hérité de XmlReader)
MoveToContentAsync()	Vérifie de façon asynchrone si le nœud actuel est un nœud de contenu. Si le nœud n'est pas un nœud de contenu, le lecteur avance jusqu'au nœud de contenu suivant ou jusqu'à la fin du fichier. (Hérité de XmlReader)
MoveToElement()	Se déplace vers l'élément contenant le nœud d'attribut actuel.
MoveToFirstAttribute()	Effectue un déplacement vers le premier attribut.
MoveToNextAttribute()	Effectue un déplacement vers l'attribut suivant.
Read()	Lit le nœud suivant du flux.
ReadAsync()	Lit de façon asynchrone le nœud suivant à partir du flux de données. (Hérité de XmlReader)
ReadAttributeValue()	Analyse la valeur d'attribut selon un ou plusieurs nœuds Text, EntityReference ou EndEntity.
ReadContentAs(Type, IXmlNamespaceResolver)	Lit le contenu en tant qu'objet du type spécifié. (Hérité de XmlReader)
ReadContentAsAsync(Type, IXmlNamespaceResolver)	Lit de façon asynchrone le contenu en tant qu'objet du type spécifié. (Hérité de XmlReader)
ReadContentAsBase64(Byte[], Int32, Int32)	Lit le contenu et retourne les octets binaires décodés au format Base64.
ReadContentAsBase64Async(Byte[], Int32, Int32)	Lit de façon asynchrone le contenu et retourne les octets binaires décodés au format Base64. (Hérité de XmlReader)
ReadContentAsBinHex(Byte[], Int32, Int32)	Lit le contenu et retourne les octets binaires décodés au format BinHex.
ReadContentAsBinHexAsync(Byte[], Int32, Int32)	Lit de façon asynchrone le contenu et retourne les octets binaires décodés au format BinHex. (Hérité de XmlReader)
ReadContentAsBoolean()	Lit le contenu de texte à la position actuelle comme un Boolean. (Hérité de XmlReader)
ReadContentAsDateTime()	Lit le contenu de texte à la position actuelle comme un objet DateTime. (Hérité de XmlReader)
ReadContentAsDateTimeOffset()	Lit le contenu de texte à la position actuelle comme un objet DateTimeOffset. (Hérité de XmlReader)
ReadContentAsDecimal()	Lit le contenu de texte à la position actuelle comme un objet Decimal. (Hérité de XmlReader)
ReadContentAsDouble()	Lit le contenu de texte à la position actuelle en tant que nombre à virgule flottante double précision. (Hérité de XmlReader)
ReadContentAsFloat()	Lit le contenu de texte à la position actuelle en tant que nombre à virgule flottante simple précision. (Hérité de XmlReader)
ReadContentAsInt()	Lit le contenu de texte à la position actuelle comme un entier signé de 32 bits. (Hérité de XmlReader)
ReadContentAsLong()	Lit le contenu de texte à la position actuelle comme un entier signé de 64 bits. (Hérité de XmlReader)
ReadContentAsObject()	Lit le contenu de texte à la position actuelle comme un Object. (Hérité de XmlReader)
ReadContentAsObjectAsync()	Lit de façon asynchrone le contenu de texte à la position actuelle comme un objet Object. (Hérité de XmlReader)
ReadContentAsString()	Lit le contenu de texte à la position actuelle comme un objet String. (Hérité de XmlReader)
ReadContentAsStringAsync()	Lit de façon asynchrone le contenu de texte à la position actuelle comme un objet String. (Hérité de XmlReader)
ReadElementContentAs(Type, IXmlNamespaceResolver)	Lit le contenu de l'élément en tant que type demandé. (Hérité de XmlReader)
ReadElementContentAs(Type, IXmlNamespaceResolver, String, String)	Vérifie que le nom local spécifié et l'URI de l'espace de noms correspondent à ceux de l'élément actuel, puis lit le contenu d'élément en tant que type demandé. (Hérité de XmlReader)
ReadElementContentAsAsync(Type, IXmlNamespaceResolver)	Lit de façon asynchrone le contenu de l'élément en tant que type demandé. (Hérité de XmlReader)
ReadElementContentAsBase64(Byte[], Int32, Int32)	Lit l'élément et décode le contenu Base64.
ReadElementContentAsBase64Async(Byte[], Int32, Int32)	Lit de façon asynchrone l'élément et décode le contenu au format Base64. (Hérité de XmlReader)
ReadElementContentAsBinHex(Byte[], Int32, Int32)	Lit l'élément et décode le contenu BinHex.
ReadElementContentAsBinHexAsync(Byte[], Int32, Int32)	Lit de façon asynchrone l'élément et décode le contenu au format BinHex. (Hérité de XmlReader)
ReadElementContentAsBoolean()	Lit l'élément actuel et retourne le contenu en tant qu'objet Boolean. (Hérité de XmlReader)
ReadElementContentAsBoolean(String, String)	Vérifie que le nom local spécifié et l'URI de l'espace de noms correspondent à ceux de l'élément actuel, puis lit l'élément actuel et retourne le contenu en tant qu'objet Boolean. (Hérité de XmlReader)
ReadElementContentAsDateTime()	Lit l'élément actuel et retourne le contenu en tant qu'objet DateTime. (Hérité de XmlReader)
ReadElementContentAsDateTime(String, String)	Vérifie que le nom local spécifié et l'URI de l'espace de noms correspondent à ceux de l'élément actuel, puis lit l'élément actuel et retourne le contenu en tant qu'objet DateTime. (Hérité de XmlReader)
ReadElementContentAsDecimal()	Lit l'élément actuel et retourne le contenu en tant qu'objet Decimal. (Hérité de XmlReader)
ReadElementContentAsDecimal(String, String)	Vérifie que le nom local spécifié et l'URI de l'espace de noms correspondent à ceux de l'élément actuel, puis lit l'élément actuel et retourne le contenu en tant qu'objet Decimal. (Hérité de XmlReader)
ReadElementContentAsDouble()	Lit l'élément actuel et retourne le contenu en tant que nombre à virgule flottante double précision. (Hérité de XmlReader)
ReadElementContentAsDouble(String, String)	Vérifie que le nom local et l'URI de l'espace de noms spécifiés correspondent à ceux de l'élément actuel, puis lit l'élément actuel et retourne le contenu sous la forme d'un nombre à virgule flottante double précision. (Hérité de XmlReader)
ReadElementContentAsFloat()	Lit l'élément actuel et retourne le contenu en tant que nombre à virgule flottante simple précision. (Hérité de XmlReader)
ReadElementContentAsFloat(String, String)	Vérifie que le nom local et l'URI de l'espace de noms spécifiés correspondent à ceux de l'élément actuel, puis lit l'élément actuel et retourne le contenu sous la forme d'un nombre à virgule flottante simple précision. (Hérité de XmlReader)
ReadElementContentAsInt()	Lit l'élément actuel et retourne le contenu comme un entier signé de 32 bits. (Hérité de XmlReader)
ReadElementContentAsInt(String, String)	Vérifie que le nom local spécifié et l'URI de l'espace de noms correspondent à ceux de l'élément actuel, puis lit l'élément actuel et retourne le contenu en tant qu'entier signé de 32 bits. (Hérité de XmlReader)
ReadElementContentAsLong()	Lit l’élément actuel et retourne le contenu comme un entier signé de 64 bits. (Hérité de XmlReader)
ReadElementContentAsLong(String, String)	Vérifie que le nom local spécifié et l’URI de l’espace de noms correspondent à ceux de l’élément actuel, puis lit l’élément actuel et retourne le contenu en tant qu’entier signé de 64 bits. (Hérité de XmlReader)
ReadElementContentAsObject()	Lit l'élément actuel et retourne le contenu en tant que Object. (Hérité de XmlReader)
ReadElementContentAsObject(String, String)	Vérifie que le nom local et l'URI de l'espace de noms spécifiés correspondent à ceux de l'élément actuel, puis lit l'élément actuel et retourne le contenu en tant qu'objet Object. (Hérité de XmlReader)
ReadElementContentAsObjectAsync()	Lit de façon asynchrone l'élément actuel et retourne le contenu en tant que Object. (Hérité de XmlReader)
ReadElementContentAsString()	Lit l'élément actuel et retourne le contenu en tant qu'objet String. (Hérité de XmlReader)
ReadElementContentAsString(String, String)	Vérifie que le nom local spécifié et l'URI de l'espace de noms correspondent à ceux de l'élément actuel, puis lit l'élément actuel et retourne le contenu en tant qu'objet String. (Hérité de XmlReader)
ReadElementContentAsStringAsync()	Lit de façon asynchrone l'élément actuel et retourne le contenu en tant qu'objet String. (Hérité de XmlReader)
ReadElementString()	Lit un élément texte uniquement. Toutefois, nous vous recommandons d’utiliser plutôt la méthode ReadElementContentAsString(), car elle permet de gérer cette opération de façon plus directe. (Hérité de XmlReader)
ReadElementString(String)	Vérifie que la propriété Name de l'élément trouvé correspond à la chaîne spécifiée avant de lire un élément de texte brut. Toutefois, nous vous recommandons d’utiliser plutôt la méthode ReadElementContentAsString(), car elle permet de gérer cette opération de façon plus directe. (Hérité de XmlReader)
ReadElementString(String, String)	Vérifie que les propriétés LocalName et NamespaceURI de l'élément trouvé correspondent aux chaînes spécifiées avant de lire un élément de texte brut. Toutefois, nous vous recommandons d’utiliser plutôt la méthode ReadElementContentAsString(String, String), car elle permet de gérer cette opération de façon plus directe. (Hérité de XmlReader)
ReadEndElement()	Vérifie que le nœud de contenu actuel est une étiquette de fin et avance le lecteur jusqu’au nœud suivant. (Hérité de XmlReader)
ReadInnerXml()	En cas de substitution dans une classe dérivée, lit tout le contenu, y compris le balisage, sous forme de chaîne. (Hérité de XmlReader)
ReadInnerXmlAsync()	Lit de façon asynchrone tout le contenu, notamment le balisage, en tant que chaîne. (Hérité de XmlReader)
ReadOuterXml()	En cas de substitution dans une classe dérivée, lit le contenu, y compris le balisage, représentant ce nœud et tous ses enfants. (Hérité de XmlReader)
ReadOuterXmlAsync()	Lit de façon asynchrone le contenu, notamment le balisage, qui représente ce nœud et tous ses enfants. (Hérité de XmlReader)
ReadStartElement()	Vérifie que le nœud actuel est un élément et avance le lecteur jusqu'au nœud suivant. (Hérité de XmlReader)
ReadStartElement(String)	Vérifie que le nœud de contenu actuel est un élément avec le Name spécifié, puis avance le lecteur jusqu'au nœud suivant. (Hérité de XmlReader)
ReadStartElement(String, String)	Vérifie que le nœud de contenu actuel est un élément avec le LocalName et le NamespaceURI spécifiés, puis avance le lecteur jusqu'au nœud suivant. (Hérité de XmlReader)
ReadString()	Lit le contenu d'un nœud d'élément ou de texte sous forme de chaîne.
ReadSubtree()	Retourne une nouvelle instance de XmlReader qui permet de lire le nœud actuel, ainsi que tous ses descendants. (Hérité de XmlReader)
ReadToDescendant(String)	Avance le XmlReader vers l'élément descendant suivant portant le nom qualifié spécifié. (Hérité de XmlReader)
ReadToDescendant(String, String)	Avance XmlReader vers le nœud descendant suivant doté du nom local et de l'URI de l'espace de noms spécifiés. (Hérité de XmlReader)
ReadToFollowing(String)	Lit jusqu'à trouver un élément avec le nom qualifié spécifié. (Hérité de XmlReader)
ReadToFollowing(String, String)	Lit jusqu'à trouver un élément avec le nom local et l'URI de l'espace de noms spécifiés. (Hérité de XmlReader)
ReadToNextSibling(String)	Avance le XmlReader vers l'élément frère suivant portant le nom qualifié spécifié. (Hérité de XmlReader)
ReadToNextSibling(String, String)	Avance XmlReader vers l’élément frère suivant doté du nom local et de l’URI de l’espace de noms spécifiés. (Hérité de XmlReader)
ReadValueChunk(Char[], Int32, Int32)	Lit des flux de texte volumineux incorporés dans un document XML. (Hérité de XmlReader)
ReadValueChunkAsync(Char[], Int32, Int32)	Lit de façon asynchrone des flux de texte volumineux incorporés dans un document XML. (Hérité de XmlReader)
ResolveEntity()	Résout la référence d'entité pour les nœuds EntityReference.
Skip()	Ignore les enfants du nœud actuel.
SkipAsync()	Ignore de façon asynchrone les enfants du nœud actuel. (Hérité de XmlReader)
ToString()	Retourne une chaîne qui représente l'objet actuel. (Hérité de Object)

Implémentations d’interfaces explicites

IXmlNamespaceResolver.GetNamespacesInScope(XmlNamespaceScope)	Pour obtenir une description de ce membre, consultez GetNamespacesInScope(XmlNamespaceScope).
IXmlNamespaceResolver.LookupNamespace(String)	Pour obtenir une description de ce membre, consultez LookupNamespace(String).
IXmlNamespaceResolver.LookupPrefix(String)	Pour obtenir une description de ce membre, consultez LookupPrefix(String).