Cet article a fait l’objet d’une traduction automatique. Pour afficher l’article en anglais, activez la case d’option Anglais. Vous pouvez également afficher le texte anglais dans une fenêtre contextuelle en faisant glisser le pointeur de la souris sur le texte traduit.
Traduction
Anglais

XmlReader.ReadElementContentAsString méthode ()

 

Date de publication : novembre 2016

Lit l’élément actuel et retourne le contenu comme un String objet.

Espace de noms:   System.Xml
Assembly:  System.Xml (dans System.Xml.dll)

public virtual string ReadElementContentAsString()

Valeur de retour

Type: System.String

L’élément de contenu comme un String objet.

Exception Condition
InvalidOperationException

Le XmlReader n’est pas positionné sur un élément.

XmlException

L’élément actuel contienne des éléments enfants.

ou

Le contenu de l’élément ne peut pas être converti en un String objet.

ArgumentNullException

La méthode est appelée avec null arguments.

InvalidOperationException

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

Cette méthode lit la balise de début, le contenu de l’élément, puis déplace le lecteur après la balise d’élément de fin. Il développe des entités et ignore les commentaires et instructions de traitement. L’élément ne peut contenir un contenu simple. Autrement dit, il ne peut pas avoir d’éléments enfants.

Pour plus d’informations, consultez la section Notes de la XmlReader page de référence et le W3C XML Schema Part 2: Datatypes recommandation.

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

L’exemple suivant lit le stringValue élément et retourne le contenu de texte (en ignorant le commentaire et l’instruction de traitement).

using (XmlReader reader = XmlReader.Create("dataFile.xml")) {
     reader.ReadToFollowing("stringValue");
     Console.WriteLine(reader.ReadElementContentAsString());			
}

L'exemple prend le fichier dataFile.xml comme entrée.

<root>
  <stringValue>
     <!--comment-->
     <?some pi?>
      text value of the element.
  </stringValue>
  <longValue>270000000000001</longValue>
  <number>0</number>
  <double>2E10</double>
  <date>2003-01-08T15:00:00-00:00</date>
</root>

Plateforme Windows universelle
Disponible depuis 8
.NET Framework
Disponible depuis 2.0
Bibliothèque de classes portable
Pris en charge dans : plateformes .NET portables
Silverlight
Disponible depuis 2.0
Silverlight pour Windows Phone
Disponible depuis 7.0
Windows Phone
Disponible depuis 8.1
Retour au début
Afficher: