XmlReader.ReadContentAsDateTime Metode

Definisi

Ruang nama:

System.Xml

Rakitan:

netstandard.dll, System.Xml.ReaderWriter.dll

Sumber:

XmlReader.cs

Membaca isi teks pada posisi saat ini sebagai DateTime objek.

public:
 virtual DateTime ReadContentAsDateTime();

public virtual DateTime ReadContentAsDateTime();

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

Public Overridable Function ReadContentAsDateTime () As DateTime

Mengembalikan

DateTime

Konten teks sebagai DateTime objek.

Pengecualian

InvalidCastException

Pemeran yang dicoba tidak valid.

FormatException

Format string tidak valid.

InvalidOperationException

Metode XmlReader dipanggil sebelum operasi asinkron sebelumnya selesai. Dalam hal ini, InvalidOperationException dilemparkan dengan pesan "Operasi asinkron sudah berlangsung."

Keterangan

Metode ini menggabungkan teks, spasi kosong, ruang kosong yang signifikan, dan bagian CDATA, dan melewati komentar atau instruksi pemrosesan apa pun. Referensi entitas diselesaikan secara otomatis.

Jika konten di ketik xsd:dateTime, pembaca mengembalikan objek yang tidak dikotak DateTime . Jika konten tidak diketik xsd:dateTime, pembaca mencoba mengonversinya ke DateTime objek sesuai dengan aturan yang ditentukan oleh rekomendasi Skema XML W3C Bagian 2: Jenis data .

Note

Anda tidak dapat mengandalkan DateTime.Year nilai ketika konten di ketik sebagai xsd:gMonthDay. XmlReader selalu menetapkan nilai ke DateTime.Year 1904 dalam kasus ini.

Tabel berikut menjelaskan bagaimana metode ini memperlakukan setiap jenis node.

XmlNodeType	Mengembalikan nilai	Perilaku pembaca
Text CDATA Whitespace SignificantWhitespace EntityReference EndEntity	Konten teks yang digabungkan, CDATA, spasi kosong, dan simpul spasi putih yang signifikan dikonversi ke jenis yang diminta.	Berpindah ke elemen mulai berikutnya atau tag elemen akhir. Referensi entitas secara otomatis diperluas.
Attribute	Sama seperti memanggil XmlConvert.ToXxx pada nilai atribut.	Pembaca tetap berada di posisi saat ini.
Comment ProcessingInstruction	Mengabaikan instruksi pemrosesan (PI) atau komentar dan membaca konten teks yang digabungkan yang mengikuti PI atau komentar.	Berpindah ke elemen mulai berikutnya atau tag elemen akhir. Referensi entitas secara otomatis diperluas.
EndElement	String kosong.	Pembaca tetap berada di posisi saat ini.
Element XmlDeclaration None Document DocumentType Notation Entity DocumentFragment	Sebuah InvalidOperationException dilemparkan.	Tidak terdefinisi, meskipun biasanya pembaca tetap berada di posisi saat ini.

Untuk informasi selengkapnya, lihat XmlReader halaman referensi dan rekomendasi Skema XML W3C Bagian 2: Jenis data .