Metodo XmlReader.ReadContentAsDateTime (System.Xml)

Cambia visualizzazione:
ScriptFree
Riferimento a .NET Framework
Metodo XmlReader.ReadContentAsDateTime

Nota: questo metodo è stato introdotto con .NET Framework versione 2.0.

Legge il contenuto di testo nella posizione corrente come oggetto DateTime.

Spazio dei nomi: System.Xml
Assembly: System.Xml (in system.xml.dll)

Sintassi

Visual Basic - (Dichiarazione)
Public Overridable Function ReadContentAsDateTime As DateTime
Visual Basic (Utilizzo)
Dim instance As XmlReader
Dim returnValue As DateTime

returnValue = instance.ReadContentAsDateTime
C#
public virtual DateTime ReadContentAsDateTime ()
C++
public:
virtual DateTime ReadContentAsDateTime ()
J#
public DateTime ReadContentAsDateTime ()
JScript
public function ReadContentAsDateTime () : DateTime

Valore restituito

Contenuto di testo come oggetto DateTime.
Eccezioni

Tipo di eccezione Condizione

InvalidCastException

Il tentativo di cast non è valido.

FormatException

Il formato della stringa non è valido.

Note

In questo metodo vengono concatenati testo, spazio vuoto, spazio vuoto significativo e sezioni CDATA e vengono ignorati commenti o istruzioni di elaborazione. I riferimenti a entità vengono risolti automaticamente.

Se il contenuto è xsd:dateTime tipizzato, il visualizzatore restituisce un oggetto DateTime unboxed. Se il contenuto non è xsd:dateTime tipizzato, il visualizzatore tenta di convertirlo in un oggetto DateTime in base alle regole definite nella raccomandazione W3C XML Schema Part 2: Datatypes, disponibili all'indirizzo http://www.w3.org/TR/xmlschema-2/ (informazioni in lingua inglese).

NotaNota

Non è possibile utilizzare il valore DateTime.Year se il contenuto è tipizzato come xsd:gMonthDay. In questo caso XmlReader imposta sempre il valore DateTime.Year su 1904.

Nella tabella riportata di seguito viene illustrato come viene considerato ogni tipo di nodo dal metodo.

XmlNodeType

Valore restituito

Comportamento del visualizzatore

Text

CDATA

Whitespace

SignificantWhitespace

EntityReference

EndEntity

Contenuto concatenato di nodi testo, CDATA, spazi vuoti e spazi vuoti significativi convertiti nel tipo richiesto.

Consente di spostare il successivo tag dell'elemento iniziale o finale. I riferimenti a entità vengono espansi automaticamente.

Attribute

Equivale a chiamare XmlConvert.ToXxx nel valore dell'attributo.

Il visualizzatore resta nella posizione corrente.

Comment

ProcessingInstruction

Ignora l'istruzione di elaborazione (PI, Processing Instruction) o il commento e legge il contenuto del testo concatenato successivo all'istruzione di elaborazione o al commento.

Consente di spostare il successivo tag dell'elemento iniziale o finale. I riferimenti a entità vengono espansi automaticamente.

EndElement

Stringa vuota.

Il visualizzatore resta nella posizione corrente.

Element

XmlDeclaration

None

Document

DocumentType

Notation

Entity

DocumentFragment

Viene generata un'InvalidOperationException.

Non definito, sebbene in genere il visualizzatore resti nella posizione corrente.

Per ulteriori informazioni, vedere Lettura di dati tipizzati e la raccomandazione W3C XML Schema Part 2: Datatypes all'indirizzo http://www.w3.org/TR/xmlschema-2/ (informazioni in lingua inglese).

Piattaforme

Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile per Pocket PC, Windows Mobile per Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

.NET Framework non supporta tutte le versioni di ciascuna piattaforma. Per un elenco delle versioni supportate, vedere Requisiti di sistema.

Informazioni sulla versione

.NET Framework

Supportato in: 2.0

.NET Compact Framework

Supportato in: 2.0
Vedere anche