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

Definisi

Ruang nama:

System.Xml

Rakitan:

netstandard.dll, System.Xml.ReaderWriter.dll

Sumber:

XmlReader.cs

Membaca konten dan mengembalikan byte biner base64 yang didekodekan.

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

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

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

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

ReadContentAsBase64(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 Base64 konten, dan mengembalikan byte biner yang didekode (misalnya, gambar GIF yang dikodekan sebaris Base64 ) ke dalam buffer. Metode ini dapat dipanggil secara berturut-turut untuk membaca aliran besar teks yang disematkan. Untuk informasi selengkapnya, lihat RFC 1521, "MIME (Ekstensi Surat Internet Multiguna) Bagian Satu: Mekanisme untuk Menentukan dan Menjelaskan Format Badan Pesan Internet". Anda dapat memperoleh RFC dari situs web Permintaan Komentar.

Note

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

Metode ini memiliki perilaku berikut:

• ReadContentAsBase64 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.

• ReadContentAsBase64tidak didukung pada jenis node XML berikut: Element, , XmlDeclaration, None, DocumentDocumentType, Notation, Entity, DocumentFragment.

Untuk versi asinkron dari metode ini, lihat ReadContentAsBase64Async.

Lihat juga

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