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

Definisi

Ruang nama:

System.Xml

Rakitan:

netstandard.dll, System.Xml.ReaderWriter.dll

Sumber:

XmlValidatingReader.cs

Membaca konten dan mengembalikan byte biner biner biner yang didekodekan BinHex.

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

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

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

Public Overrides 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.

ArgumentOutOfRangeException

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

NotSupportedException

Implementasi XmlValidatingReader tidak mendukung metode ini.

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 mengalirkan konten, mendekode konten BinHex, dan mengembalikan byte biner yang didekode (misalnya, gambar GIF yang dikodekan BinHex sebaris) 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, dari byte daripada yang dibiarkan di aliran, pembaca tetap berada di posisinya saat ini.

• ReadContentAsBinHex tidak didukung pada jenis simpul XML berikut: Elemen, XmlDeclaration, None, Document, DocumentType, Notation, Entity, dan DocumentFragment.

Lihat juga

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