Partager via


XmlReader.ReadContentAsString Méthode

Définition

Lit le contenu de texte à la position actuelle comme un objet String.

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

Retours

String

Contenu de texte sous la forme d'un objet String.

Exceptions

La tentative de cast n'est pas valide.

Le format de chaîne n'est pas valide.

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

Cette méthode concatène le texte, l’espace blanc, les espaces blancs significatifs et les sections CDATA, et ignore tous les commentaires ou instructions de traitement. Les références d’entité sont résolues automatiquement.

Cette méthode peut être utilisée pour convertir des valeurs typées en chaîne ou pour lire le contenu du texte tout en ignorant les commentaires et les instructions de traitement.

Le tableau suivant décrit comment cette méthode traite chaque type de nœud.

XmlNodeType Valeur retournée Comportement du lecteur
Text

CDATA

Whitespace

SignificantWhitespace

EntityReference

EndEntity
Nœuds de contenus de texte, CDATA, d'espace blanc et d'espace blanc significatif concaténés convertis en type demandé. Avance jusqu'à la balise d'élément de début ou de fin suivante. Les références d’entité sont automatiquement développées.
Attribute Identique à l’appel XmlConvert.ToXxx de la valeur d’attribut. Le lecteur reste dans sa position actuelle.
Comment

ProcessingInstruction
Ignore l'instruction de traitement ou le commentaire et lit le contenu du texte concaténé qui suit l'instruction ou le commentaire. Avance jusqu'à la balise d'élément de début ou de fin suivante. Les références d’entité sont automatiquement développées.
EndElement Chaîne vide. Le lecteur reste dans sa position actuelle.
Element

XmlDeclaration

None

Document

DocumentType

Notation

Entity

DocumentFragment
Un objet InvalidOperationException est levé. Non défini, bien que le lecteur reste généralement dans sa position actuelle.

Pour plus d’informations, consultez la section Notes 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 ReadContentAsStringAsync.

S’applique à