IsolatedStorageFileStream.ReadAsync Metode

Definisi

Ruang nama:

System.IO.IsolatedStorage

Rakitan:

System.IO.IsolatedStorage.dll

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

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

Task<Int32>

Tugas yang mewakili operasi baca asinkron. Ini membungkus jumlah total byte yang dibaca ke bufferdalam . Ini bisa kurang dari jumlah byte yang diminta jika banyak byte yang saat ini tidak tersedia, atau nol jika akhir aliran tercapai.

Pengecualian

OperationCanceledException

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).

ReadAsync(Memory<Byte>, CancellationToken)

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

buffer

Memory<Byte>

Buffer untuk menulis data ke dalamnya.

cancellationToken

CancellationToken

Token yang akan dipantau untuk permintaan pembatalan. Nilai defaultnya adalah None.

Mengembalikan

ValueTask<Int32>

Tugas yang mewakili operasi baca asinkron. Ini membungkus jumlah total byte yang dibaca ke bufferdalam . Ini bisa kurang dari jumlah byte yang diminta jika banyak byte yang saat ini tidak tersedia, atau nol jika akhir aliran tercapai.

Pengecualian

OperationCanceledException

Token pembatalan dibatalkan. Pengecualian ini disimpan ke dalam tugas yang dikembalikan.