XmlReader.Read Méthode

Définition

Espace de noms:

System.Xml

Assembly:

System.Xml.ReaderWriter.dll

Assembly:

System.Xml.dll

Assembly:

netstandard.dll

En cas de substitution dans une classe dérivée, lit le nœud suivant à partir du flux.

C#

public abstract bool Read ();

Retours

Boolean

true si le nœud suivant est correctement lu ; sinon, false.

Exceptions

XmlException

Une erreur s’est produite lors de l’analyse du XML.

InvalidOperationException

Une méthode XmlReader a été appelée avant la fin d’une opération asynchrone précédente. Dans ce cas, l’exception InvalidOperationException est levée avec le message « Une opération asynchrone est déjà en cours ».

Exemples

L’exemple suivant lit un fichier XML et affiche chacun des nœuds :

C#

XmlReaderSettings settings = new XmlReaderSettings();
settings.DtdProcessing = DtdProcessing.Parse;
XmlReader reader = XmlReader.Create("items.xml", settings);

reader.MoveToContent();
  // Parse the file and display each of the nodes.
  while (reader.Read()) {
    switch (reader.NodeType) {
      case XmlNodeType.Element:
          Console.Write("<{0}>", reader.Name);
          break;
      case XmlNodeType.Text:
          Console.Write(reader.Value);
          break;
       case XmlNodeType.CDATA:
           Console.Write("<![CDATA[{0}]]>", reader.Value);
           break;
       case XmlNodeType.ProcessingInstruction:
           Console.Write("<?{0} {1}?>", reader.Name, reader.Value);
           break;
       case XmlNodeType.Comment:
           Console.Write("<!--{0}-->", reader.Value);
           break;
       case XmlNodeType.XmlDeclaration:
           Console.Write("<?xml version='1.0'?>");
           break;
       case XmlNodeType.Document:
           break;
       case XmlNodeType.DocumentType:
           Console.Write("<!DOCTYPE {0} [{1}]", reader.Name, reader.Value);
           break;
       case XmlNodeType.EntityReference:
           Console.Write(reader.Name);
           break;
       case XmlNodeType.EndElement:
           Console.Write("</{0}>", reader.Name);
           break;
   }
}

L’exemple utilise le items.xml fichier.

XML

<?xml version="1.0"?>
<!-- This is a sample XML document -->
<!DOCTYPE Items [<!ENTITY number "123">]>
<Items>
  <Item>Test with an entity: &number;</Item>
  <Item>Test with a child element <more/> stuff</Item>
  <Item>Test with a CDATA section <![CDATA[<456>]]> def</Item>
  <Item>Test with a char entity: A</Item>
  <!-- Fourteen chars in this element.-->
  <Item>1234567890ABCD</Item>
</Items>

Output:

XML

<Item>Test with an entity: 123</Item><Item>Test with a child element <more> stuff</Item><Item>Test with a CDATA section <![CDATA[<456>]]> def</Item><Item>Test with a char entity: A</Item><!-- Fourteen chars in this element.--><Item>1234567890ABCD</Item></Items>

Remarques

Lorsqu’une première fois est XmlReader créée et initialisée, aucune information n’est disponible. Vous devez appeler Read pour lire le premier nœud. La Read méthode définit l’état du lecteur XML pour lancer ReadState.Initial et parcourir le fichier XML de manière séquentielle jusqu’à ce qu’il atteigne la fin du fichier, à quel point la méthode retourne une valeur .false

Cette méthode nécessite au moins quatre octets du flux de données pour commencer l’analyse. Si moins de quatre octets sont retournés et qu’il n’y a plus de données dans le flux, la méthode retourne false. S’il existe plus de données dans le flux, la méthode bloque l’analyse jusqu’à la réception du quatrième octet.

Pour obtenir la version asynchrone de cette méthode, consultez ReadAsync.

S’applique à