XmlReader.ReadElementContentAsDateTime Metodo

Definizione

Spazio dei nomi:

System.Xml

Assembly:

System.Xml.ReaderWriter.dll

Assembly:

System.Xml.dll

Assembly:

netstandard.dll

Legge l'elemento corrente e restituisce il contenuto come oggetto DateTime.

Overload

ReadElementContentAsDateTime()	Legge l'elemento corrente e restituisce il contenuto come oggetto DateTime.
ReadElementContentAsDateTime(String, String)	Verifica che il nome locale e l'URI dello spazio dei nomi specificati corrispondano a quelli dell'elemento corrente, quindi legge l'elemento e restituisce il contenuto come oggetto DateTime.

ReadElementContentAsDateTime()

Legge l'elemento corrente e restituisce il contenuto come oggetto 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

Restituisce

DateTime

Contenuto dell'elemento come oggetto DateTime.

Eccezioni

InvalidOperationException

L'oggetto XmlReader non è posizionato in corrispondenza di un elemento.

-oppure-

È stato chiamato un metodo della classe XmlReader prima del completamento di un'operazione asincrona precedente. In questo caso, viene generata l'eccezione InvalidOperationException con il messaggio "È già in corso un'operazione asincrona".

XmlException

L'elemento corrente contiene elementi figlio.

-oppure-

Il contenuto dell'elemento non può essere convertito in un oggetto DateTime.

ArgumentNullException

Il metodo è stato chiamato con argomenti null.

Esempio

Nell'esempio seguente viene usato il metodo per leggere il ReadElementContentAsDateTime contenuto dell'elemento 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

Nell'esempio viene utilizzato il file dataFile.xml come input.

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

Commenti

Questo metodo legge il tag iniziale, il contenuto dell'elemento e sposta il lettore oltre il tag dell'elemento finale. Espande le entità e ignora le istruzioni di elaborazione e i commenti. L'elemento può contenere solo contenuto semplice. Ovvero, non può avere elementi figlio.

Se il contenuto è digitato xsd:dateTime, il lettore restituisce un oggetto non in DateTime arrivo. Se il contenuto non è tipizzato xsd:dateTime, il lettore tenta di convertirlo in un DateTime oggetto in base alle regole definite dalla raccomandazione W3C XML Schema Parte 2: Tipi di dati .

Nota

Non è possibile usare il valore DateTime.Year quando il contenuto è tipizzato come xsd:gMonthDay. XmlReader imposta sempre il DateTime.Year valore su 1904 in questo caso.

Per altre informazioni, vedere la sezione Note della pagina di riferimento XmlReader.

ReadElementContentAsDateTime(String, String)

Verifica che il nome locale e l'URI dello spazio dei nomi specificati corrispondano a quelli dell'elemento corrente, quindi legge l'elemento e restituisce il contenuto come oggetto 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

Parametri

localName

String

Nome locale dell'elemento.

namespaceURI

String

URI dello spazio dei nomi dell'elemento.

Restituisce

DateTime

Contenuto dell'elemento come oggetto DateTime.

Eccezioni

InvalidOperationException

L'oggetto XmlReader non è posizionato in corrispondenza di un elemento.

-oppure-

È stato chiamato un metodo della classe XmlReader prima del completamento di un'operazione asincrona precedente. In questo caso, viene generata l'eccezione InvalidOperationException con il messaggio "È già in corso un'operazione asincrona".

XmlException

L'elemento corrente contiene elementi figlio.

-oppure-

Il contenuto dell'elemento non può essere convertito nel tipo richiesto.

ArgumentNullException

Il metodo è stato chiamato con argomenti null.

ArgumentException

Il nome locale e l'URI dello spazio dei nomi specificati non corrispondono a quelli dell'elemento corrente da leggere.

Commenti

Questo metodo legge il tag iniziale, il contenuto dell'elemento e sposta il lettore oltre il tag dell'elemento finale. Espande le entità e ignora le istruzioni di elaborazione e i commenti. L'elemento può contenere solo contenuto semplice. Ovvero, non può avere elementi figlio.

Se il contenuto è tipizzato xsd:dateTime, il lettore restituisce un oggetto unboxed DateTime . Se il contenuto non è tipizzato xsd:dateTime, il lettore tenta di convertirlo in un DateTime oggetto in base alle regole definite dalla raccomandazione W3C XML Schema Part 2: Datatypes .

Nota

Non è possibile usare il valore DateTime.Year quando il contenuto è tipizzato come xsd:gMonthDay. XmlReader imposta sempre il DateTime.Year valore su 1904 in questo caso.

Per altre informazioni, vedere la sezione Note della pagina di riferimento XmlReader.