XmlValidatingReader.ReadElementContentAsBinHex(Byte[], Int32, Int32) Metode

Definisi

Ruang nama:

System.Xml

Rakitan:

netstandard.dll, System.Xml.ReaderWriter.dll

Sumber:

XmlValidatingReader.cs

Membaca elemen dan mendekode konten BinHex.

public:
 override int ReadElementContentAsBinHex(cli::array <System::Byte> ^ buffer, int index, int count);

public override int ReadElementContentAsBinHex(byte[] buffer, int index, int count);

override this.ReadElementContentAsBinHex : byte[] * int * int -> int

Public Overrides Function ReadElementContentAsBinHex (buffer As Byte(), index As Integer, count As Integer) As Integer

Parameter

buffer

Byte[]

Buffer tempat menyalin teks yang dihasilkan. Nilai ini tidak boleh null.

index

Int32

Offset ke dalam buffer tempat untuk mulai menyalin hasilnya.

count

Int32

Jumlah maksimum byte yang akan disalin ke dalam buffer. Jumlah aktual byte yang disalin dikembalikan dari metode ini.

Mengembalikan

Int32

Jumlah byte yang ditulis ke buffer.

Pengecualian

ArgumentNullException

Nilai buffer adalah null.

InvalidOperationException

Simpul saat ini bukan simpul elemen.

ArgumentOutOfRangeException

Indeks ke dalam buffer atau indeks + hitungan lebih besar dari ukuran buffer yang dialokasikan.

NotSupportedException

Implementasi XmlValidatingReader tidak mendukung metode ini.

XmlException

Elemen berisi konten campuran.

FormatException

Isi tidak dapat dikonversi ke tipe yang diminta.

Keterangan

Note

Kelas XmlValidatingReader usang dalam .NET Framework 2.0. Anda dapat membuat instans validasi XmlReader dengan menggunakan XmlReaderSettings kelas dan Create metode . Untuk informasi selengkapnya, lihat bagian Keterangan dari halaman referensi XmlReader.

Metode ini membaca konten elemen, mendekodenya menggunakan pengodean BinHex, dan mengembalikan byte biner yang didekode (misalnya, gambar GIF yang dikodekan BinHex sebaris) ke dalam buffer.

Metode ini hanya dapat membaca elemen konten sederhana. Elemen dapat berisi teks, spasi kosong, spasi kosong yang signifikan, bagian CDATA, komentar, dan instruksi pemrosesan. Ini juga dapat berisi referensi entitas, yang secara otomatis diperluas. Elemen tidak boleh memiliki elemen turunan.

Metode ini sangat mirip ReadContentAsBinHex dengan metode kecuali hanya dapat dipanggil pada jenis node elemen.

count Jika nilai lebih tinggi dari jumlah byte dalam dokumen, atau jika sama dengan jumlah byte dalam dokumen, XmlValidatingReader membaca semua byte yang tersisa dalam dokumen dan mengembalikan jumlah byte yang dibaca. Panggilan metode berikutnya XmlValidatingReader mengembalikan nol dan memindahkan pembaca ke simpul mengikuti EndElement.

Jika Anda memanggil Read sebelum semua konten elemen dikonsumsi, pembaca mungkin berulah seolah-olah konten pertama digunakan dan kemudian Read metode dipanggil. Ini berarti bahwa pembaca akan membaca semua teks sampai elemen akhir ditemui. Kemudian akan membaca simpul tag akhir, membaca simpul berikutnya, dan kemudian memposisikan dirinya pada simpul berikutnya.

Lihat juga

• XmlReader
• ReadContentAsBinHex(Byte[], Int32, Int32)