XmlReader.ReadElementString Méthode

Définition

Espace de noms:

System.Xml

Assembly:

System.Xml.ReaderWriter.dll

Assembly:

System.Xml.dll

Assembly:

netstandard.dll

Lit les éléments de texte brut. Toutefois, nous vous recommandons d’utiliser plutôt la méthode ReadElementContentAsString, car elle permet de gérer cette opération de façon plus directe.

Surcharges

ReadElementString()	Lit un élément texte uniquement. Toutefois, nous vous recommandons d’utiliser plutôt la méthode ReadElementContentAsString(), car elle permet de gérer cette opération de façon plus directe.
ReadElementString(String)	Vérifie que la propriété Name de l'élément trouvé correspond à la chaîne spécifiée avant de lire un élément de texte brut. Toutefois, nous vous recommandons d’utiliser plutôt la méthode ReadElementContentAsString(), car elle permet de gérer cette opération de façon plus directe.
ReadElementString(String, String)	Vérifie que les propriétés LocalName et NamespaceURI de l'élément trouvé correspondent aux chaînes spécifiées avant de lire un élément de texte brut. Toutefois, nous vous recommandons d’utiliser plutôt la méthode ReadElementContentAsString(String, String), car elle permet de gérer cette opération de façon plus directe.

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 plutôt la méthode ReadElementContentAsString(), car elle permet de gérer cette opération de façon plus directe.

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

Le texte contenu dans l'élément lu. Une 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 texte brut.

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

Remarques

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

ReadElementString(String)

Vérifie que la propriété Name de l'élément trouvé correspond à la chaîne spécifiée avant de lire un élément de texte brut. Toutefois, nous vous recommandons d’utiliser plutôt la méthode ReadElementContentAsString(), car elle permet de gérer cette opération de façon plus directe.

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

Le texte contenu dans l'élément lu. Une 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 spécifié ; ou si l'élément trouvé ne contient pas de valeur texte brut.

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

Remarques

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

ReadElementString(String, String)

Vérifie que les propriétés LocalName et NamespaceURI de l'élément trouvé correspondent aux chaînes spécifiées avant de lire un élément de texte brut. Toutefois, nous vous recommandons d’utiliser plutôt la méthode ReadElementContentAsString(String, String), car elle permet de gérer cette opération de façon plus directe.

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 de l'espace de noms à vérifier.

Retours

String

Le texte contenu dans l'élément lu. Une 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 les éléments LocalName ou NamespaceURI ne correspondent pas aux arguments spécifiés ; ou si l'élément trouvé ne contient pas de valeur texte brut.

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

Remarques

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