XmlReader.ReadContentAsBoolean Metode

Definisi

Ruang nama:

System.Xml

Rakitan:

netstandard.dll, System.Xml.ReaderWriter.dll

Sumber:

XmlReader.cs

Membaca konten teks pada posisi saat ini sebagai Boolean.

public:
 virtual bool ReadContentAsBoolean();

public virtual bool ReadContentAsBoolean();

abstract member ReadContentAsBoolean : unit -> bool
override this.ReadContentAsBoolean : unit -> bool

Public Overridable Function ReadContentAsBoolean () As Boolean

Mengembalikan

Boolean

Konten teks sebagai Boolean 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."

Contoh

Contoh berikut menggunakan ReadContentAsBoolean metode untuk membaca atribut sebagai Boolean nilai.

using (XmlReader reader = XmlReader.Create("dataFile_2.xml")) {
      reader.ReadToDescendant("item");
      do {
          reader.MoveToAttribute("sale-item");
          Boolean onSale = reader.ReadContentAsBoolean();
          if (onSale) {
             Console.WriteLine(reader["productID"]);
          }
      } while (reader.ReadToNextSibling("item"));	
}

Using reader As XmlReader = XmlReader.Create("dataFile_2.xml")
              
  reader.ReadToDescendant("item")
              
  Do
    reader.MoveToAttribute("sale-item")
    Dim onSale As [Boolean] = reader.ReadContentAsBoolean()
    If onSale Then
      Console.WriteLine(reader("productID"))
    End If
  Loop While reader.ReadToNextSibling("item")
          
End Using

Contohnya menggunakan dataFile_2.xml file sebagai input.

<root>
  <item sale-item='true' productID='123456' colors='blue green black'>
    <price>9.95</price>
  </item>
  <item sale-item='false' productID='124390'>
    <price>5.95</price>
  </item>
  <item sale-item='true' productID='53298'>
    <price>12.95</price>
  </item>
</root>

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:boolean, pembaca mengembalikan objek yang tidak dikotak Boolean . Jika konten tidak diketik xsd:boolean, pembaca mencoba mengonversinya ke Boolean objek sesuai dengan aturan yang ditentukan oleh rekomendasi Skema XML W3C Bagian 2: Jenis data .

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 .