XmlReader.ReadElementContentAsDateTime Metodo

Definizione

Spazio dei nomi:
System.Xml
Assembly:
netstandard.dll, System.Xml.ReaderWriter.dll
Assembly:
System.Xml.ReaderWriter.dll
Assembly:
System.Xml.dll
Assembly:
netstandard.dll

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

Overload

Nome Descrizione
ReadElementContentAsDateTime()

Legge l'elemento corrente e restituisce il contenuto come DateTime oggetto .
ReadElementContentAsDateTime(String, String)

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

ReadElementContentAsDateTime()

Origine:
XmlReader.cs
Origine:
XmlReader.cs
Origine:
XmlReader.cs
Origine:
XmlReader.cs
Origine:
XmlReader.cs

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

public:
 virtual DateTime ReadElementContentAsDateTime();
public virtual DateTime ReadElementContentAsDateTime();
abstract member ReadElementContentAsDateTime : unit -> DateTime
override this.ReadElementContentAsDateTime : unit -> DateTime
Public Overridable Function ReadElementContentAsDateTime () As DateTime

Valori restituiti

DateTime

Contenuto dell'elemento come DateTime oggetto .

Eccezioni

InvalidOperationException

L'oggetto XmlReader non è posizionato su un elemento .

oppure

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

XmlException

L'elemento corrente contiene elementi figlio.

oppure

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

ArgumentNullException

Il metodo viene chiamato con null argomenti.

Esempio

Nell'esempio seguente viene utilizzato il ReadElementContentAsDateTime metodo per leggere il 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

L'esempio usa il dataFile.xml file 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 è 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 .

Note

Non è possibile fare affidamento sul DateTime.Year valore quando il contenuto viene digitato 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.

Si applica a

ReadElementContentAsDateTime(String, String)

Origine:
XmlReader.cs
Origine:
XmlReader.cs
Origine:
XmlReader.cs
Origine:
XmlReader.cs
Origine:
XmlReader.cs

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

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.

Valori restituiti

DateTime

Contenuto dell'elemento come DateTime oggetto .

Eccezioni

InvalidOperationException

L'oggetto XmlReader non è posizionato su un elemento .

oppure

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

XmlException

L'elemento corrente contiene elementi figlio.

oppure

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

ArgumentNullException

Il metodo viene chiamato con null argomenti.

ArgumentException

Il nome locale e l'URI dello spazio dei nomi specificati non corrispondono a quello dell'elemento corrente letto.

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 .

Note

Non è possibile fare affidamento sul DateTime.Year valore quando il contenuto viene digitato 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.

Si applica a