XmlReader.ReadContentAsLong Metode

Definisi

Ruang nama:

System.Xml

Rakitan:

netstandard.dll, System.Xml.ReaderWriter.dll

Sumber:

XmlReader.cs

Membaca konten teks pada posisi saat ini sebagai bilangan bulat bertanda tangan 64-bit.

public:
 virtual long ReadContentAsLong();

public virtual long ReadContentAsLong();

abstract member ReadContentAsLong : unit -> int64
override this.ReadContentAsLong : unit -> int64

Public Overridable Function ReadContentAsLong () As Long

Mengembalikan

Int64

Konten teks sebagai bilangan bulat bertanda tangan 64-bit.

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:long, pembaca mengembalikan bilangan bulat bertanda tangan 64-bit yang tidak dikotak. Jika konten tidak diketik xsd:long, pembaca mencoba mengonversinya menjadi bilangan bulat bertanda tangan 64-bit sesuai dengan aturan yang ditentukan oleh rekomendasi Skema XML W3C Bagian 2: Jenis data .

Tabel berikut menjelaskan 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 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 bagian Keterangan dari halaman referensi XmlReader.