XmlReader.ReadValueChunkAsync(Char[], 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.
Secara asinkron membaca aliran besar teks yang disematkan dalam dokumen XML.
public:
virtual System::Threading::Tasks::Task<int> ^ ReadValueChunkAsync(cli::array <char> ^ buffer, int index, int count);public virtual System.Threading.Tasks.Task<int> ReadValueChunkAsync(char[] buffer, int index, int count);abstract member ReadValueChunkAsync : char[] * int * int -> System.Threading.Tasks.Task<int>
override this.ReadValueChunkAsync : char[] * int * int -> System.Threading.Tasks.Task<int>Public Overridable Function ReadValueChunkAsync (buffer As Char(), index As Integer, count As Integer) As Task(Of Integer)Parameter
- buffer
- Char[]
Array karakter yang berfungsi sebagai buffer tempat konten teks ditulis. Nilai ini tidak boleh null.
- count
- Int32
Jumlah maksimum karakter yang akan disalin ke dalam buffer. Jumlah karakter aktual yang disalin dikembalikan dari metode ini.
Mengembalikan
Jumlah karakter yang dibaca ke dalam buffer. Nilai nol dikembalikan ketika tidak ada lagi konten teks.
Pengecualian
Metode XmlReader dipanggil sebelum operasi asinkron sebelumnya selesai. Dalam hal ini, InvalidOperationException dilemparkan dengan pesan "Operasi asinkron sudah berlangsung." -atau-
Metode XmlReader asinkron dipanggil tanpa mengatur Async bendera ke true. Dalam hal ini, InvalidOperationException dilemparkan dengan pesan "Atur XmlReaderSettings.Async ke true jika Anda ingin menggunakan Metode Asinkron."
Keterangan
Ini adalah versi asinkron dari ReadValueChunk, dengan fungsionalitas yang sama. Untuk menggunakan metode ini, Anda harus mengatur Async bendera ke true.
Metode ini disimpan dalam tugas yang mengembalikan semua pengecualian non-penggunaan yang dapat dilemparkan oleh rekan sinkron metode. Jika pengecualian disimpan ke dalam tugas yang dikembalikan, pengecualian tersebut akan dilemparkan saat tugas ditunggu. Pengecualian penggunaan, seperti ArgumentException, masih dilemparkan secara sinkron. Untuk pengecualian yang disimpan, lihat pengecualian yang dilemparkan oleh ReadValueChunk(Char[], Int32, Int32).
