XmlTextReader.ReadString Méthode
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
Lit le contenu d’un élément ou d’un nœud de texte sous forme de chaîne.
public:
override System::String ^ ReadString();
public override string ReadString();
override this.ReadString : unit -> string
Public Overrides Function ReadString () As String
Retours
Contenu du nœud d’élément ou de texte. Il peut s’agir d’une chaîne vide si le lecteur est positionné sur un autre élément ou nœud de texte, ou s’il n’y a plus de contenu de texte à retourner dans le contexte actuel.
Note: Le nœud de texte peut être un élément ou un nœud de texte d’attribut.
Exceptions
Une erreur s’est produite lors de l’analyse du code XML.
Une opération non valide a été tentée.
Exemples
L’exemple suivant affiche le contenu texte de chaque élément.
using System;
using System.IO;
using System.Xml;
public class Sample
{
public static void Main()
{
XmlTextReader reader = null;
try
{
//Load the reader with the XML file.
reader = new XmlTextReader("elems.xml");
//Parse the XML and display the text content of each of the elements.
while (reader.Read()){
if (reader.IsStartElement()){
if (reader.IsEmptyElement)
{
Console.WriteLine("<{0}/>", reader.Name);
}
else
{
Console.Write("<{0}> ", reader.Name);
reader.Read(); //Read the start tag.
if (reader.IsStartElement()) //Handle nested elements.
Console.Write("\r\n<{0}>", reader.Name);
Console.WriteLine(reader.ReadString()); //Read the text content of the element.
}
}
}
}
finally
{
if (reader != null)
reader.Close();
}
}
} // End class
Option Strict
Option Explicit
Imports System.IO
Imports System.Xml
Public Class Sample
Public Shared Sub Main()
Dim reader As XmlTextReader = Nothing
Try
'Load the reader with the XML file.
reader = New XmlTextReader("elems.xml")
'Parse the XML and display the text content of each of the elements.
While reader.Read()
If reader.IsStartElement() Then
If reader.IsEmptyElement Then
Console.WriteLine("<{0}/>", reader.Name)
Else
Console.Write("<{0}>" + " ", reader.Name)
reader.Read() 'Read the start tag.
If (reader.IsStartElement()) 'Handle nested elements.
Console.WriteLine()
Console.Write("<{0}>", reader.Name)
End If
Console.WriteLine(reader.ReadString()) 'Read the text content of the element.
End If
End If
End While
Finally
If Not (reader Is Nothing) Then
reader.Close()
End If
End Try
End Sub
End Class
L’exemple utilise le fichier, elems.xmlcomme entrée.
<book>
<title>Pride And Prejudice</title>
<price>19.95</price>
<misc/>
</book>
Remarques
Note
Nous vous recommandons de créer des instances XmlReader à l’aide de la méthode XmlReader.Create pour tirer parti de nouvelles fonctionnalités.
Si elle est positionnée sur un élément, ReadString concatène tout le texte, l’espace blanc significatif, l’espace blanc et CData les types de nœuds de section ensemble et retourne les données concaténées comme contenu de l’élément. Il s’arrête lorsqu’un balisage est rencontré, y compris les commentaires et les instructions de traitement. Cela peut se produire dans un modèle de contenu mixte ou lorsqu’une balise de fin d’élément est lue.
Si elle est positionnée sur un nœud de texte, ReadString effectue la même concaténation entre le nœud de texte et la balise de fin de l’élément. Si le lecteur est positionné sur un nœud de texte d’attribut, ReadString a la même fonctionnalité que si le lecteur était positionné sur la balise de début de l’élément. Elle retourne tous les nœuds de texte de l’élément concaténé.