XmlReader.ReadContentAsObject Méthode

Référence

Définition

Espace de noms:: System.Xml

Assembly:: System.Xml.ReaderWriter.dll

Assembly:: System.Xml.dll

Assembly:: netstandard.dll

Important

Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.

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

public:
 virtual System::Object ^ ReadContentAsObject();

public virtual object ReadContentAsObject ();

abstract member ReadContentAsObject : unit -> obj
override this.ReadContentAsObject : unit -> obj

Public Overridable Function ReadContentAsObject () As Object

Retours

Object

Contenu de texte sous la forme de l'objet CLR le plus approprié.

Exceptions

InvalidCastException

La tentative de cast n'est pas valide.

FormatException

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

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

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.

Si le contenu est typé, le lecteur retourne un CLR boxé du type le plus approprié, spécifié par la ValueType propriété. Si le contenu est un type de liste, le lecteur retourne un tableau d’objets boxed du type approprié.

Notes

Si une erreur de validation se produit lors de l’analyse du contenu et que le lecteur est un XmlReader objet créé par la Create méthode, le lecteur retourne le contenu sous forme de chaîne. En d’autres termes, lorsqu’une erreur de validation ou un avertissement se produit, le contenu est considéré comme non typé.

Si le contenu n'est pas typé, le lecteur retourne le contenu sous la forme d'une chaîne.

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 à la 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`	Valeur de l’élément si le lecteur est un lecteur de validation de schéma (ValidationType est défini sur Schema); sinon une 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 ReadContentAsObjectAsync.

S’applique à

Partager via