XmlReader.ReadElementContentAsDateTime Metode

Definisi

Ruang nama:

System.Xml

Rakitan:

netstandard.dll, System.Xml.ReaderWriter.dll

Membaca elemen saat ini dan mengembalikan konten sebagai DateTime objek.

Overload

Nama	Deskripsi
ReadElementContentAsDateTime()	Membaca elemen saat ini dan mengembalikan konten sebagai DateTime objek.
ReadElementContentAsDateTime(String, String)	Memeriksa apakah nama lokal dan URI namespace yang ditentukan cocok dengan elemen saat ini, lalu membaca elemen saat ini dan mengembalikan konten sebagai DateTime objek.

ReadElementContentAsDateTime()

Sumber:

XmlReader.cs

Membaca elemen saat ini dan mengembalikan konten sebagai DateTime objek.

public:
 virtual DateTime ReadElementContentAsDateTime();

public virtual DateTime ReadElementContentAsDateTime();

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

Public Overridable Function ReadElementContentAsDateTime () As DateTime

Mengembalikan

DateTime

Konten elemen sebagai DateTime objek.

Pengecualian

InvalidOperationException

XmlReader tidak diposisikan pada elemen.

-atau-

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

XmlException

Elemen saat ini berisi elemen turunan.

-atau-

Konten elemen tidak dapat dikonversi ke DateTime objek.

ArgumentNullException

Metode ini dipanggil dengan null argumen.

Contoh

Contoh berikut menggunakan ReadElementContentAsDateTime metode untuk membaca konten date elemen.

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

Contohnya menggunakan dataFile.xml file sebagai 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>

Keterangan

Metode ini membaca tag mulai, konten elemen, dan memindahkan pembaca melewati tag elemen akhir. Ini memperluas entitas dan mengabaikan instruksi pemrosesan dan komentar. Elemen hanya dapat berisi konten sederhana. Artinya, tidak dapat memiliki elemen turunan.

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.

Untuk informasi selengkapnya, lihat bagian Keterangan dari halaman referensi XmlReader.

ReadElementContentAsDateTime(String, String)

Sumber:

XmlReader.cs

Memeriksa apakah nama lokal dan URI namespace yang ditentukan cocok dengan elemen saat ini, lalu membaca elemen saat ini dan mengembalikan konten sebagai DateTime objek.

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

Parameter

localName

String

Nama lokal elemen .

namespaceURI

String

URI namespace elemen.

Mengembalikan

DateTime

Konten elemen sebagai DateTime objek.

Pengecualian

InvalidOperationException

XmlReader tidak diposisikan pada elemen.

-atau-

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

XmlException

Elemen saat ini berisi elemen turunan.

-atau-

Konten elemen tidak dapat dikonversi ke jenis yang diminta.

ArgumentNullException

Metode ini dipanggil dengan null argumen.

ArgumentException

Nama lokal dan URI namespace yang ditentukan tidak cocok dengan elemen saat ini yang sedang dibaca.

Keterangan

Metode ini membaca tag mulai, konten elemen, dan memindahkan pembaca melewati tag elemen akhir. Ini memperluas entitas dan mengabaikan instruksi pemrosesan dan komentar. Elemen hanya dapat berisi konten sederhana. Artinya, tidak dapat memiliki elemen turunan.

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.

Untuk informasi selengkapnya, lihat bagian Keterangan dari halaman referensi XmlReader.