XmlReader.ReadElementString Méthode

Définition

Espace de noms:
System.Xml
Assembly:
System.Xml.dll
Assembly:
netstandard.dll

Lit les éléments texte uniquement simples. Toutefois, nous vous recommandons d’utiliser la méthode à la ReadElementContentAsString place, car elle offre un moyen plus simple de gérer cette opération.

Surcharges

Nom Description
ReadElementString()

Lit un élément texte uniquement. Toutefois, nous vous recommandons d’utiliser la méthode à la ReadElementContentAsString() place, car elle offre un moyen plus simple de gérer cette opération.
ReadElementString(String)

Vérifie que la Name propriété de l’élément trouvée correspond à la chaîne donnée avant de lire un élément texte uniquement. Toutefois, nous vous recommandons d’utiliser la méthode à la ReadElementContentAsString() place, car elle offre un moyen plus simple de gérer cette opération.
ReadElementString(String, String)

Vérifie que les propriétés et LocalName les NamespaceURI propriétés de l’élément trouvées correspondent aux chaînes données avant de lire un élément texte uniquement. Toutefois, nous vous recommandons d’utiliser la méthode à la ReadElementContentAsString(String, String) place, car elle offre un moyen plus simple de gérer cette opération.

Remarques

Nous vous recommandons d’utiliser la ReadElementContentAsString méthode pour lire un élément de texte.

ReadElementString()

Lit un élément texte uniquement. Toutefois, nous vous recommandons d’utiliser la méthode à la ReadElementContentAsString() place, car elle offre un moyen plus simple de gérer cette opération.

public:
 virtual System::String ^ ReadElementString();
public virtual string ReadElementString();
abstract member ReadElementString : unit -> string
override this.ReadElementString : unit -> string
Public Overridable Function ReadElementString () As String

Retours

String

Texte contenu dans l’élément lu. Chaîne vide si l’élément est vide.

Exceptions

XmlException

Le nœud de contenu suivant n’est pas une balise de début ; ou l’élément trouvé ne contient pas de valeur de texte simple.

InvalidOperationException

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

Remarques

Nous vous recommandons d’utiliser la ReadElementContentAsString() méthode pour lire un élément de texte.

S’applique à

ReadElementString(String)

Vérifie que la Name propriété de l’élément trouvée correspond à la chaîne donnée avant de lire un élément texte uniquement. Toutefois, nous vous recommandons d’utiliser la méthode à la ReadElementContentAsString() place, car elle offre un moyen plus simple de gérer cette opération.

public:
 virtual System::String ^ ReadElementString(System::String ^ name);
public virtual string ReadElementString(string name);
abstract member ReadElementString : string -> string
override this.ReadElementString : string -> string
Public Overridable Function ReadElementString (name As String) As String

Paramètres

name
String

Nom à vérifier.

Retours

String

Texte contenu dans l’élément lu. Chaîne vide si l’élément est vide.

Exceptions

XmlException

Si le nœud de contenu suivant n’est pas une balise de début ; si l’élément Name ne correspond pas à l’argument donné ; ou si l’élément trouvé ne contient pas de valeur de texte simple.

InvalidOperationException

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

Remarques

Nous vous recommandons d’utiliser la ReadElementContentAsString() méthode pour lire un élément de texte.

S’applique à

ReadElementString(String, String)

Vérifie que les propriétés et LocalName les NamespaceURI propriétés de l’élément trouvées correspondent aux chaînes données avant de lire un élément texte uniquement. Toutefois, nous vous recommandons d’utiliser la méthode à la ReadElementContentAsString(String, String) place, car elle offre un moyen plus simple de gérer cette opération.

public:
 virtual System::String ^ ReadElementString(System::String ^ localname, System::String ^ ns);
public virtual string ReadElementString(string localname, string ns);
abstract member ReadElementString : string * string -> string
override this.ReadElementString : string * string -> string
Public Overridable Function ReadElementString (localname As String, ns As String) As String

Paramètres

localname
String

Nom local à vérifier.

ns
String

URI d’espace de noms à vérifier.

Retours

String

Texte contenu dans l’élément lu. Chaîne vide si l’élément est vide.

Exceptions

XmlException

Si le nœud de contenu suivant n’est pas une balise de début ; si l’élément LocalName ou NamespaceURI ne correspond pas aux arguments donnés ; ou si l’élément trouvé ne contient pas de valeur de texte simple.

InvalidOperationException

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

Remarques

Nous vous recommandons d’utiliser la ReadElementContentAsString(String, String) méthode pour lire un élément de texte.

S’applique à