XmlReader.ReadElementContentAs Metode

Definisi

Ruang nama:

System.Xml

Rakitan:

netstandard.dll, System.Xml.ReaderWriter.dll

Membaca elemen saat ini dan mengembalikan konten sebagai objek dari jenis yang ditentukan.

Overload

Nama	Deskripsi
ReadElementContentAs(Type, IXmlNamespaceResolver)	Membaca konten elemen sebagai jenis yang diminta.
ReadElementContentAs(Type, IXmlNamespaceResolver, String, String)	Memeriksa apakah nama lokal dan URI namespace yang ditentukan cocok dengan elemen saat ini, lalu membaca konten elemen sebagai jenis yang diminta.

ReadElementContentAs(Type, IXmlNamespaceResolver)

Sumber:

XmlReader.cs

Membaca konten elemen sebagai jenis yang diminta.

public:
 virtual System::Object ^ ReadElementContentAs(Type ^ returnType, System::Xml::IXmlNamespaceResolver ^ namespaceResolver);

public virtual object ReadElementContentAs(Type returnType, System.Xml.IXmlNamespaceResolver namespaceResolver);

abstract member ReadElementContentAs : Type * System.Xml.IXmlNamespaceResolver -> obj
override this.ReadElementContentAs : Type * System.Xml.IXmlNamespaceResolver -> obj

Public Overridable Function ReadElementContentAs (returnType As Type, namespaceResolver As IXmlNamespaceResolver) As Object

Parameter

returnType

Type

Jenis nilai yang akan dikembalikan.

Catatan Dengan rilis .NET Framework 3.5, nilai returnType parameter sekarang dapat menjadi jenisnya DateTimeOffset .

namespaceResolver

IXmlNamespaceResolver

Objek IXmlNamespaceResolver yang digunakan untuk mengatasi awalan namespace apa pun yang terkait dengan konversi jenis.

Mengembalikan

Object

Konten elemen dikonversi ke objek jenis yang diminta.

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.

OverflowException

Baca Decimal.MaxValue.

Contoh

Contoh berikut menggunakan ReadElementContentAs metode untuk membaca konten simpul date .

using (XmlReader reader = XmlReader.Create("dataFile.xml")) {
     reader.ReadToFollowing("date");
     DateTime date = (DateTime) reader.ReadElementContentAs(typeof(System.DateTime), null);
  
     // 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 = CType(reader.ReadElementContentAs(GetType(System.DateTime), Nothing), DateTime)
            
  ' 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.

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

Untuk versi asinkron dari metode ini, lihat ReadElementContentAsAsync.

ReadElementContentAs(Type, IXmlNamespaceResolver, String, String)

Sumber:

XmlReader.cs

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

public:
 virtual System::Object ^ ReadElementContentAs(Type ^ returnType, System::Xml::IXmlNamespaceResolver ^ namespaceResolver, System::String ^ localName, System::String ^ namespaceURI);

public virtual object ReadElementContentAs(Type returnType, System.Xml.IXmlNamespaceResolver namespaceResolver, string localName, string namespaceURI);

abstract member ReadElementContentAs : Type * System.Xml.IXmlNamespaceResolver * string * string -> obj
override this.ReadElementContentAs : Type * System.Xml.IXmlNamespaceResolver * string * string -> obj

Public Overridable Function ReadElementContentAs (returnType As Type, namespaceResolver As IXmlNamespaceResolver, localName As String, namespaceURI As String) As Object

Parameter

returnType

Type

Jenis nilai yang akan dikembalikan.

Catatan Dengan rilis .NET Framework 3.5, nilai returnType parameter sekarang dapat menjadi jenisnya DateTimeOffset .

namespaceResolver

IXmlNamespaceResolver

Objek IXmlNamespaceResolver yang digunakan untuk mengatasi awalan namespace apa pun yang terkait dengan konversi jenis.

localName

String

Nama lokal elemen .

namespaceURI

String

URI namespace elemen.

Mengembalikan

Object

Konten elemen dikonversi ke objek jenis yang diminta.

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.

OverflowException

Baca Decimal.MaxValue.

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.

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