XmlReader.ReadElementContentAsDateTime Méthode

Définition

Espace de noms:

System.Xml

Assemblys:

netstandard.dll, System.Xml.ReaderWriter.dll

Lit l’élément actuel et retourne le contenu en tant qu’objet DateTime .

Surcharges

Nom	Description
ReadElementContentAsDateTime()	Lit l’élément actuel et retourne le contenu en tant qu’objet DateTime .
ReadElementContentAsDateTime(String, String)	Vérifie que le nom local et l’URI d’espace de noms spécifiés correspondent à celui de l’élément actuel, puis lit l’élément actuel et retourne le contenu en tant qu’objet DateTime .

ReadElementContentAsDateTime()

Source:

XmlReader.cs

Lit l’élément actuel et retourne le contenu en tant qu’objet DateTime .

public:
 virtual DateTime ReadElementContentAsDateTime();

public virtual DateTime ReadElementContentAsDateTime();

abstract member ReadElementContentAsDateTime : unit -> DateTime
override this.ReadElementContentAsDateTime : unit -> DateTime

Public Overridable Function ReadElementContentAsDateTime () As DateTime

Retours

DateTime

Contenu de l’élément en tant qu’objet DateTime .

Exceptions

InvalidOperationException

Le XmlReader paramètre n’est pas positionné sur un élément.

- ou -

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

XmlException

L’élément actuel contient des éléments enfants.

- ou -

Le contenu de l’élément ne peut pas être converti en objet DateTime .

ArgumentNullException

La méthode est appelée avec null des arguments.

Exemples

L’exemple suivant utilise la ReadElementContentAsDateTime méthode pour lire le contenu de l’élément date .

using (XmlReader reader = XmlReader.Create("dataFile.xml")) {
     reader.ReadToFollowing("date");
     DateTime date = reader.ReadElementContentAsDateTime();
  
     // If the current culture is "en-US",
     // this writes "Wednesday, January 8, 2003".
     Console.WriteLine(date.ToLongDateString());
}

Using reader As XmlReader = XmlReader.Create("dataFile.xml")
  reader.ReadToFollowing("date")
  Dim [date] As DateTime = reader.ReadElementContentAsDateTime()
            
  ' If the current culture is "en-US",
  ' this writes "Wednesday, January 8, 2003".
  Console.WriteLine([date].ToLongDateString())
End Using

L’exemple utilise le dataFile.xml fichier comme entrée.

<root>
  <stringValue>
     <!--comment-->
     <?some pi?>
      text value of the element.
  </stringValue>
  <longValue>270000000000001</longValue>
  <number>0</number>
  <double>2E10</double>
  <date>2003-01-08T15:00:00-00:00</date>
</root>

Remarques

Cette méthode lit la balise de début, le contenu de l’élément et déplace le lecteur au-delà de la balise d’élément de fin. Il développe des entités et ignore les instructions de traitement et les commentaires. L’élément ne peut contenir que du contenu simple. Autrement dit, il ne peut pas avoir d’éléments enfants.

Si le contenu est tapé xsd:dateTime, le lecteur retourne un objet nonboxé DateTime . Si le contenu n’est pas typé xsd:dateTime, le lecteur tente de le convertir en objet DateTime conformément aux règles définies par la partie 2 du schéma XML W3C : recommandation datatypes .

Note

Vous ne pouvez pas compter sur la DateTime.Year valeur lorsque le contenu est tapé comme xsd:gMonthDay. XmlReader définit toujours la DateTime.Year valeur sur 1904 dans ce cas.

Pour plus d'informations, consultez la section Notes de la page de référence XmlReader.

ReadElementContentAsDateTime(String, String)

Source:

XmlReader.cs

Vérifie que le nom local et l’URI d’espace de noms spécifiés correspondent à celui de l’élément actuel, puis lit l’élément actuel et retourne le contenu en tant qu’objet DateTime .

public:
 virtual DateTime ReadElementContentAsDateTime(System::String ^ localName, System::String ^ namespaceURI);

public virtual DateTime ReadElementContentAsDateTime(string localName, string namespaceURI);

abstract member ReadElementContentAsDateTime : string * string -> DateTime
override this.ReadElementContentAsDateTime : string * string -> DateTime

Public Overridable Function ReadElementContentAsDateTime (localName As String, namespaceURI As String) As DateTime

Paramètres

localName

String

Nom local de l’élément.

namespaceURI

String

URI d’espace de noms de l’élément.

Retours

DateTime

Contenu de l’élément en tant qu’objet DateTime .

Exceptions

InvalidOperationException

Le XmlReader paramètre n’est pas positionné sur un élément.

- ou -

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

XmlException

L’élément actuel contient des éléments enfants.

- ou -

Le contenu de l’élément ne peut pas être converti en type demandé.

ArgumentNullException

La méthode est appelée avec null des arguments.

ArgumentException

Le nom local et l’URI d’espace de noms spécifiés ne correspondent pas à celui de l’élément actuel lu.

Remarques

Cette méthode lit la balise de début, le contenu de l’élément et déplace le lecteur au-delà de la balise d’élément de fin. Il développe des entités et ignore les instructions de traitement et les commentaires. L’élément ne peut contenir que du contenu simple. Autrement dit, il ne peut pas avoir d’éléments enfants.

Si le contenu est tapé xsd:dateTime, le lecteur retourne un objet nonboxé DateTime . Si le contenu n’est pas typé xsd:dateTime, le lecteur tente de le convertir en objet DateTime conformément aux règles définies par la partie 2 du schéma XML W3C : recommandation datatypes .

Note

Vous ne pouvez pas compter sur la DateTime.Year valeur lorsque le contenu est tapé comme xsd:gMonthDay. XmlReader définit toujours la DateTime.Year valeur sur 1904 dans ce cas.

Pour plus d'informations, consultez la section Notes de la page de référence XmlReader.