XmlReader.ReadContentAsDateTime 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 de texte à la position actuelle comme un objet DateTime.
public:
virtual DateTime ReadContentAsDateTime();
public virtual DateTime ReadContentAsDateTime ();
abstract member ReadContentAsDateTime : unit -> DateTime
override this.ReadContentAsDateTime : unit -> DateTime
Public Overridable Function ReadContentAsDateTime () As DateTime
Retours
Contenu de texte sous la forme d'un objet DateTime.
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 du texte, des espaces blancs, des espaces blancs significatifs et des sections CDATA, et ignore les commentaires ou instructions de traitement. Les références d’entité sont automatiquement résolues.
Si le contenu est tapé xsd:dateTime
, le lecteur retourne un objet sans boîte de réception DateTime . Si le contenu n’est pas typé xsd:dateTime
, le lecteur tente de le convertir en objet DateTime selon les règles définies par la recommandation Schéma XML W3C Partie 2 : Types de données .
Notes
Vous ne pouvez pas compter sur la valeur DateTime.Year lorsque le contenu est de type xsd:gMonthDay
.
XmlReader définit toujours la DateTime.Year valeur 1904 dans ce cas.
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 XmlReader page de référence et la recommandation Schéma XML W3C Partie 2 : Types de données .