XmlReader.ReadElementContentAsObject Metode

Definisi

Ruang nama:

System.Xml

Rakitan:

netstandard.dll, System.Xml.ReaderWriter.dll

Membaca elemen saat ini dan mengembalikan konten sebagai Object.

Overload

Nama	Deskripsi
ReadElementContentAsObject()	Membaca elemen saat ini dan mengembalikan konten sebagai Object.
ReadElementContentAsObject(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 Object.

ReadElementContentAsObject()

Sumber:

XmlReader.cs

Membaca elemen saat ini dan mengembalikan konten sebagai Object.

public:
 virtual System::Object ^ ReadElementContentAsObject();

public virtual object ReadElementContentAsObject();

abstract member ReadElementContentAsObject : unit -> obj
override this.ReadElementContentAsObject : unit -> obj

Public Overridable Function ReadElementContentAsObject () As Object

Mengembalikan

Object

Objek runtime bahasa umum (CLR) dalam kotak dari jenis yang paling tepat. Properti ValueType menentukan jenis CLR yang sesuai. Jika konten di ketik sebagai jenis daftar, metode ini mengembalikan array objek kotak dari jenis yang sesuai.

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.

Contoh

Contoh berikut menggunakan metode untuk membaca konten simpul price . Pembaca menggunakan informasi dalam skema untuk memetakan konten ke jenis data yang benar.

// Create a validating reader.
XmlReaderSettings settings = new XmlReaderSettings();
settings.ValidationType = ValidationType.Schema;
settings.Schemas.Add("urn:items", "item.xsd");	
 XmlReader reader = XmlReader.Create("item.xml", settings);

// Get the CLR type of the price element.
reader.ReadToFollowing("price");
Console.WriteLine(reader.ValueType);

// Return the value of the price element as Decimal object.
Decimal price = (Decimal) reader.ReadElementContentAsObject();

// Add 2.50 to the price.
price = Decimal.Add(price, 2.50m);

' Create a validating reader.
Dim settings As New XmlReaderSettings()
settings.ValidationType = ValidationType.Schema
settings.Schemas.Add("urn:items", "item.xsd")
Dim reader As XmlReader = XmlReader.Create("item.xml", settings)
      
' Get the CLR type of the price element. 
reader.ReadToFollowing("price")
Console.WriteLine(reader.ValueType)
      
' Return the value of the price element as Decimal object.
Dim price As [Decimal] = CType(reader.ReadElementContentAsObject(), [Decimal])
      
' Add 2.50 to the price.
price = [Decimal].Add(price, 2.5D)

Contohnya menggunakan dua file berikut sebagai input.

item.xml

<item xmlns="urn:items" productID='123098'>
 <name>hammer</name>
 <price>9.95</price>
 <supplierID>1929</supplierID>
</item>

item.xsd

<?xml version="1.0"?>
<xs:schema xmlns:tns="urn:items" attributeFormDefault="unqualified" elementFormDefault="qualified" targetNamespace="urn:items" xmlns:xs="http://www.w3.org/2001/XMLSchema">
  <xs:element name="item">
    <xs:complexType>
      <xs:sequence>
        <xs:element name="name" type="xs:string" />
        <xs:element name="price" type="xs:decimal" />
        <xs:element name="supplierID" type="xs:unsignedShort" />
      </xs:sequence>
      <xs:attribute name="productID" type="xs:unsignedInt" use="required" />
    </xs:complexType>
  </xs:element>
</xs:schema>

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 ReadElementContentAsObjectAsync.

ReadElementContentAsObject(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 Object.

public:
 virtual System::Object ^ ReadElementContentAsObject(System::String ^ localName, System::String ^ namespaceURI);

public virtual object ReadElementContentAsObject(string localName, string namespaceURI);

abstract member ReadElementContentAsObject : string * string -> obj
override this.ReadElementContentAsObject : string * string -> obj

Public Overridable Function ReadElementContentAsObject (localName As String, namespaceURI As String) As Object

Parameter

localName

String

Nama lokal elemen .

namespaceURI

String

URI namespace elemen.

Mengembalikan

Object

Objek runtime bahasa umum (CLR) dalam kotak dari jenis yang paling tepat. Properti ValueType menentukan jenis CLR yang sesuai. Jika konten di ketik sebagai jenis daftar, metode ini mengembalikan array objek kotak dari jenis yang sesuai.

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.

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