XmlReader.ReadContentAsBinHex(Byte[], Int32, Int32) Metode

Definisi

Ruang nama:

System.Xml

Rakitan:

netstandard.dll, System.Xml.ReaderWriter.dll

Sumber:

XmlReader.cs

Membaca konten dan mengembalikan BinHex byte biner yang didekodekan.

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

public virtual int ReadContentAsBinHex(byte[] buffer, int index, int count);

abstract member ReadContentAsBinHex : byte[] * int * int -> int
override this.ReadContentAsBinHex : byte[] * int * int -> int

Public Overridable Function ReadContentAsBinHex (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

ReadContentAsBinHex(Byte[], Int32, Int32) tidak didukung pada simpul saat ini.

-atau-

Metode XmlReader dipanggil sebelum operasi asinkron sebelumnya selesai. Dalam hal ini, InvalidOperationException dilemparkan dengan pesan "Operasi asinkron sudah berlangsung."

ArgumentOutOfRangeException

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

NotSupportedException

Implementasi XmlReader tidak mendukung metode ini.

Keterangan

Metode ini mengalirkan konten, mendekode BinHex konten, dan mengembalikan byte biner yang didekode (misalnya, gambar GIF yang dikodekan sebaris BinHex ) ke dalam buffer. Metode ini dapat dipanggil secara berturut-turut untuk membaca aliran besar teks yang disematkan.

Note

Anda tidak boleh mengakses salah satu properti pembaca antara panggilan ke ReadContentAsBinHex metode hingga metode mengembalikan nilai 0.

Metode ini memiliki perilaku berikut:

• ReadContentAsBinHex mengembalikan nilai 0 ketika telah mencapai akhir aliran byte yang dioperasikannya. Pembaca diposisikan pada node non-konten pertama.

• Jika Anda meminta lebih sedikit, atau jumlah yang tepat, byte daripada yang dibiarkan di aliran pembaca tetap berada di posisinya saat ini.

• ReadContentAsBinHextidak didukung pada jenis node XML berikut: Element, , XmlDeclaration, NoneDocument, DocumentType, Notation, Entity, DocumentFragment.

Untuk versi asinkron dari metode ini, lihat ReadContentAsBinHexAsync.

Lihat juga

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