XmlReader.ReadContentAsObject Méthode
Définition
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 du texte à la position actuelle en tant que Object.
public:
virtual System::Object ^ ReadContentAsObject();public virtual object ReadContentAsObject();abstract member ReadContentAsObject : unit -> obj
override this.ReadContentAsObject : unit -> objPublic Overridable Function ReadContentAsObject () As ObjectRetours
Contenu texte en tant qu’objet CLR (Common Language Runtime) le plus approprié.
Exceptions
La tentative de cast n’est pas valide.
Le format de chaîne n’est pas valide.
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
Cette méthode concatène du texte, de l’espace blanc, de l’espace blanc significatif et des sections CDATA, et ignore 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 boxés du type approprié.
Note
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 tapé, le lecteur retourne le contenu sous forme de chaîne.
Le tableau suivant décrit comment cette méthode traite chaque type de nœud.
| XmlNodeType | Valeur retournée | Comportement du lecteur |
|---|---|---|
TextCDATAWhitespaceSignificantWhitespaceEntityReferenceEndEntity |
Contenu concaténé de texte, CDATA, espace blanc et nœuds d’espace blanc significatifs convertis en type demandé. | Passe à l’élément de début ou à la balise d’élément de fin suivant. 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 |
CommentProcessingInstruction |
Ignore l’instruction de traitement (PI) ou le commentaire et lit le contenu de texte concaténé qui suit le pi ou le commentaire. | Passe à l’élément de début ou à la balise d’élément de fin suivant. 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 à la position actuelle. |
ElementXmlDeclarationNoneDocumentDocumentTypeNotationEntityDocumentFragment |
Une InvalidOperationException est levée. | Non défini, bien que le lecteur reste généralement dans la position actuelle. |
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 ReadContentAsObjectAsync.
