XmlReader.ReadElementContentAsString Méthode

Définition

Espace de noms:

System.Xml

Assemblys:

netstandard.dll, System.Xml.ReaderWriter.dll

Lit l’élément actuel et retourne le contenu en tant qu’objet String .

Surcharges

Nom	Description
ReadElementContentAsString(String, String)	Vérifie que le nom local et l’URI d’espace de noms spécifiés correspondent à celui de l’élément actuel, puis lit l’élément actuel et retourne le contenu en tant qu’objet String .
ReadElementContentAsString()	Lit l’élément actuel et retourne le contenu en tant qu’objet String .

ReadElementContentAsString(String, String)

Source:

XmlReader.cs

Vérifie que le nom local et l’URI d’espace de noms spécifiés correspondent à celui de l’élément actuel, puis lit l’élément actuel et retourne le contenu en tant qu’objet String .

public:
 virtual System::String ^ ReadElementContentAsString(System::String ^ localName, System::String ^ namespaceURI);

public virtual string ReadElementContentAsString(string localName, string namespaceURI);

abstract member ReadElementContentAsString : string * string -> string
override this.ReadElementContentAsString : string * string -> string

Public Overridable Function ReadElementContentAsString (localName As String, namespaceURI As String) As String

Paramètres

localName

String

Nom local de l’élément.

namespaceURI

String

URI d’espace de noms de l’élément.

Retours

String

Contenu de l’élément en tant qu’objet String .

Exceptions

InvalidOperationException

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

- ou -

Une 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 ».

XmlException

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

- ou -

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

ArgumentNullException

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

ArgumentException

Le nom local et l’URI d’espace de noms spécifiés ne correspondent pas à celui de l’élément actuel lu.

Exemples

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

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

Using reader As XmlReader = XmlReader.Create("dataFile.xml")
  reader.ReadToFollowing("stringValue")
  Console.WriteLine(reader.ReadElementContentAsString("stringValue", ""))
End Using

L’exemple utilise le dataFile.xml fichier 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>

Remarques

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

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

ReadElementContentAsString()

Source:

XmlReader.cs

Lit l’élément actuel et retourne le contenu en tant qu’objet String .

public:
 virtual System::String ^ ReadElementContentAsString();

public virtual string ReadElementContentAsString();

abstract member ReadElementContentAsString : unit -> string
override this.ReadElementContentAsString : unit -> string

Public Overridable Function ReadElementContentAsString () As String

Retours

String

Contenu de l’élément en tant qu’objet String .

Exceptions

InvalidOperationException

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

- ou -

Une 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 ».

XmlException

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

- ou -

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

ArgumentNullException

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

Exemples

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

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

Using reader As XmlReader = XmlReader.Create("dataFile.xml")
  reader.ReadToFollowing("stringValue")
  Console.WriteLine(reader.ReadElementContentAsString())
End Using

L’exemple utilise le dataFile.xml fichier 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>

Remarques

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

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

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