Udostępnij za pośrednictwem


XmlReader.ReadContentAsDateTime Metoda

Definicja

Odczytuje zawartość tekstową w bieżącej pozycji jako DateTime obiekt.

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

Zwraca

DateTime

Zawartość tekstowa DateTime jako obiekt.

Wyjątki

Próba rzutowania jest nieprawidłowa.

Format ciągu jest nieprawidłowy.

Metoda XmlReader została wywołana przed zakończeniem poprzedniej operacji asynchronicznej. W takim przypadku InvalidOperationException jest zgłaszany komunikat "Operacja asynchroniczna jest już w toku".

Uwagi

Ta metoda łączy tekst, białe znaki, znaczące białe znaki i sekcje CDATA oraz pomija wszelkie komentarze lub instrukcje przetwarzania. Odwołania do jednostek są automatycznie rozwiązywane.

Jeśli zawartość jest typowana xsd:dateTime, czytnik zwraca obiekt rozpboxowany DateTime . Jeśli zawartość nie jest wpisywana xsd:dateTime, czytelnik próbuje przekonwertować go na DateTime obiekt zgodnie z regułami zdefiniowanymi przez zalecenie schematu XML W3C Part 2: Datatypes .

Uwaga

Nie można polegać na DateTime.Year wartości, gdy zawartość jest wpisywana jako xsd:gMonthDay. XmlReader zawsze ustawia DateTime.Year wartość 1904 w tym przypadku.

W poniższej tabeli opisano sposób traktowania poszczególnych typów węzłów przez tę metodę.

XmlNodeType Wartość zwracana Zachowanie czytelnika
Text

CDATA

Whitespace

SignificantWhitespace

EntityReference

EndEntity
Połączona zawartość tekstu, CDATA, biały znak i znaczące węzły odstępu przekonwertowane na żądany typ. Przechodzi do następnego elementu początkowego lub tagu elementu końcowego. Odwołania do jednostek są automatycznie rozszerzane.
Attribute Tak samo jak wywołanie XmlConvert.ToXxx wartości atrybutu. Czytelnik pozostaje w bieżącej pozycji.
Comment

ProcessingInstruction
Ignoruje instrukcję przetwarzania (PI) lub komentarz i odczytuje połączoną zawartość tekst, która następuje po pi lub komentarzu. Przechodzi do następnego elementu początkowego lub tagu elementu końcowego. Odwołania do jednostek są automatycznie rozszerzane.
EndElement Pusty ciąg. Czytelnik pozostaje w bieżącej pozycji.
Element

XmlDeclaration

None

Document

DocumentType

Notation

Entity

DocumentFragment
Jest InvalidOperationException zgłaszany. Niezdefiniowany, chociaż zazwyczaj czytelnik pozostaje w bieżącej pozycji.

Aby uzyskać więcej informacji, zobacz stronę referencyjną XmlReader i zalecenie schematu XML W3C Part 2: Datatypes .

Dotyczy