IsolatedStorageFileStream.ReadAsync 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.
Overload
ReadAsync(Byte[], Int32, Int32, CancellationToken) |
Menyalin byte secara asinkron dari objek buffer IsolatedStorageFileStream saat ini ke array byte. |
ReadAsync(Memory<Byte>, CancellationToken) |
Menyalin byte secara asinkron dari objek buffer IsolatedStorageFileStream saat ini ke rentang memori byte. |
ReadAsync(Byte[], Int32, Int32, CancellationToken)
- Sumber:
- IsolatedStorageFileStream.cs
- Sumber:
- IsolatedStorageFileStream.cs
- Sumber:
- IsolatedStorageFileStream.cs
Menyalin byte secara asinkron dari objek buffer IsolatedStorageFileStream saat ini ke array byte.
public:
override System::Threading::Tasks::Task<int> ^ ReadAsync(cli::array <System::Byte> ^ buffer, int offset, int count, System::Threading::CancellationToken cancellationToken);
public override System.Threading.Tasks.Task<int> ReadAsync (byte[] buffer, int offset, int count, System.Threading.CancellationToken cancellationToken);
override this.ReadAsync : byte[] * int * int * System.Threading.CancellationToken -> System.Threading.Tasks.Task<int>
Public Overrides Function ReadAsync (buffer As Byte(), offset As Integer, count As Integer, cancellationToken As CancellationToken) As Task(Of Integer)
Parameter
- buffer
- Byte[]
Buffer untuk menulis data ke dalamnya.
- offset
- Int32
Offset dalam buffer untuk mulai menulis.
- count
- Int32
Jumlah maksimum byte yang akan dibaca.
- cancellationToken
- CancellationToken
Token yang akan dipantau untuk permintaan pembatalan. Nilai defaultnya adalah None.
Mengembalikan
Tugas yang mewakili operasi baca asinkron. Ini membungkus jumlah total byte yang dibaca ke buffer
dalam . Ini bisa kurang dari jumlah byte yang diminta jika banyak byte yang saat ini tidak tersedia, atau nol jika akhir aliran tercapai.
Pengecualian
Token pembatalan dibatalkan. Pengecualian ini disimpan ke dalam tugas yang dikembalikan.
Keterangan
Parameter buffer
dapat berupa instans Buffer kelas , atau array dari salah satu jenis berikut: Byte, Int32SByteInt16Char, Int64UInt16, UInt32, UInt64, , Single, atau .Double
Jika operasi baca berhasil, posisi aliran saat ini dilanjutkan dengan jumlah byte yang dibaca. Jika pengecualian terjadi, posisi aliran saat ini tidak berubah.
Metode ini ReadAsync memperlakukan buffer
parameter sebagai blok byte, terlepas dari jenis aktualnya. Demikian juga, offset
parameter dan count
selalu ditentukan dalam byte. Untuk buffer
parameter selain byte array, ini berarti bahwa indeks elemen atau jumlah elemen harus dikalikan dengan ukuran elemen dalam byte untuk membentuk nilai yang benar untuk offset
atau count
.
Metode ReadAsync ini akan mengembalikan nol hanya jika akhir aliran tercapai. Dalam semua kasus lain, ReadAsync selalu membaca setidaknya satu byte dari aliran sebelum kembali. Jika tidak ada data yang tersedia dari IsolatedStorageFileStream objek setelah panggilan ke ReadAsync, metode akan memblokir hingga setidaknya satu byte data dapat dikembalikan.
Metode ini disimpan dalam tugas yang menampilkan 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 Read(Byte[], Int32, Int32).
Berlaku untuk
ReadAsync(Memory<Byte>, CancellationToken)
- Sumber:
- IsolatedStorageFileStream.cs
- Sumber:
- IsolatedStorageFileStream.cs
- Sumber:
- IsolatedStorageFileStream.cs
Menyalin byte secara asinkron dari objek buffer IsolatedStorageFileStream saat ini ke rentang memori byte.
public override System.Threading.Tasks.ValueTask<int> ReadAsync (Memory<byte> buffer, System.Threading.CancellationToken cancellationToken = default);
override this.ReadAsync : Memory<byte> * System.Threading.CancellationToken -> System.Threading.Tasks.ValueTask<int>
Public Overrides Function ReadAsync (buffer As Memory(Of Byte), Optional cancellationToken As CancellationToken = Nothing) As ValueTask(Of Integer)
Parameter
- cancellationToken
- CancellationToken
Token yang akan dipantau untuk permintaan pembatalan. Nilai defaultnya adalah None.
Mengembalikan
Tugas yang mewakili operasi baca asinkron. Ini membungkus jumlah total byte yang dibaca ke buffer
dalam . Ini bisa kurang dari jumlah byte yang diminta jika banyak byte yang saat ini tidak tersedia, atau nol jika akhir aliran tercapai.
Pengecualian
Token pembatalan dibatalkan. Pengecualian ini disimpan ke dalam tugas yang dikembalikan.