XmlValidatingReader.ReadElementContentAsBase64(Byte[], Int32, Int32) Metode
Definisi
Penting
Beberapa informasi terkait produk prarilis yang dapat diubah secara signifikan sebelum dirilis. Microsoft tidak memberikan jaminan, tersirat maupun tersurat, sehubungan dengan informasi yang diberikan di sini.
Membaca elemen dan mendekode konten Base64.
public:
override int ReadElementContentAsBase64(cli::array <System::Byte> ^ buffer, int index, int count);public override int ReadElementContentAsBase64(byte[] buffer, int index, int count);override this.ReadElementContentAsBase64 : byte[] * int * int -> intPublic Overrides Function ReadElementContentAsBase64 (buffer As Byte(), index As Integer, count As Integer) As IntegerParameter
- 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
Jumlah byte yang ditulis ke buffer.
Pengecualian
Nilai buffer adalah null.
Simpul saat ini bukan simpul elemen.
Indeks ke dalam buffer atau indeks + hitungan lebih besar dari ukuran buffer yang dialokasikan.
Implementasi XmlValidatingReader tidak mendukung metode ini.
Elemen berisi konten campuran.
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 Base64, dan mengembalikan byte biner yang didekode (misalnya, gambar GIF yang dikodekan Base64 sebaris) ke dalam buffer. Untuk informasi selengkapnya, lihat RFC 1521, "MIME (Ekstensi Surat Internet Multiguna) Bagian Satu: Mekanisme untuk Menentukan dan Menjelaskan Format Badan Pesan Internet". Anda bisa mendapatkan RFC dari situs Web Permintaan Komentar.
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 ReadContentAsBase64 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.
