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

Definisi

Ruang nama:

System.Xml

Rakitan:

netstandard.dll, System.Xml.ReaderWriter.dll

Sumber:

XmlTextReader.cs

Membaca elemen dan mendekode BinHex konten.

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 XmlReader tidak mendukung metode ini.

XmlException

Elemen berisi konten campuran.

FormatException

Isi tidak dapat dikonversi ke tipe yang diminta.

Contoh

Lihat XmlReader.ReadElementContentAsBinHex untuk melihat contoh menggunakan metode ini.

Keterangan

Note

Kami menyarankan Anda membuat instans XmlReader untuk memanfaatkan fungsionalitas baru dengan menggunakan metode XmlReader.Create.

Metode ini membaca konten elemen, mendekodenya menggunakan BinHex pengodean, dan mengembalikan byte biner yang didekodekan (misalnya, gambar GIF yang dikodekan sebaris BinHex ) 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, XmlTextReader membaca semua byte yang tersisa dalam dokumen dan mengembalikan jumlah byte yang dibaca. Panggilan metode berikutnya XmlTextReader 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 membaca semua teks sampai elemen akhir ditemui. Kemudian membaca simpul tag akhir, membaca simpul berikutnya, dan kemudian memposisikan dirinya pada simpul berikutnya.

Lihat juga

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