Stream.ReadExactlyAsync Metode

Definisi

Ruang nama:

System.IO

Rakitan:

System.Runtime.dll

Overload

ReadExactlyAsync(Memory<Byte>, CancellationToken)	Secara asinkron membaca byte dari aliran saat ini, memajukan posisi dalam aliran hingga buffer terisi, dan memantau permintaan pembatalan.
ReadExactlyAsync(Byte[], Int32, Int32, CancellationToken)	Secara asinkron membaca count jumlah byte dari aliran saat ini, memajukan posisi dalam aliran, dan memantau permintaan pembatalan.

ReadExactlyAsync(Memory<Byte>, CancellationToken)

Sumber:

Stream.cs

Secara asinkron membaca byte dari aliran saat ini, memajukan posisi dalam aliran hingga buffer terisi, dan memantau permintaan pembatalan.

public System.Threading.Tasks.ValueTask ReadExactlyAsync (Memory<byte> buffer, System.Threading.CancellationToken cancellationToken = default);

member this.ReadExactlyAsync : Memory<byte> * System.Threading.CancellationToken -> System.Threading.Tasks.ValueTask

Public Function ReadExactlyAsync (buffer As Memory(Of Byte), Optional cancellationToken As CancellationToken = Nothing) As ValueTask

Parameter

buffer

Memory<Byte>

Buffer untuk menulis data.

cancellationToken

CancellationToken

Token yang akan dipantau untuk permintaan pembatalan.

Mengembalikan

ValueTask

Tugas yang mewakili operasi baca asinkron.

Pengecualian

EndOfStreamException

Akhir aliran tercapai sebelum mengisi buffer.

OperationCanceledException

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

Keterangan

Ketika buffer kosong, operasi baca ini akan selesai tanpa menunggu data yang tersedia di aliran.

ReadExactlyAsync(Byte[], Int32, Int32, CancellationToken)

Sumber:

Stream.cs

Secara asinkron membaca count jumlah byte dari aliran saat ini, memajukan posisi dalam aliran, dan memantau permintaan pembatalan.

public System.Threading.Tasks.ValueTask ReadExactlyAsync (byte[] buffer, int offset, int count, System.Threading.CancellationToken cancellationToken = default);

member this.ReadExactlyAsync : byte[] * int * int * System.Threading.CancellationToken -> System.Threading.Tasks.ValueTask

Public Function ReadExactlyAsync (buffer As Byte(), offset As Integer, count As Integer, Optional cancellationToken As CancellationToken = Nothing) As ValueTask

Parameter

buffer

Byte[]

Buffer untuk menulis data.

offset

Int32

Offset byte untuk buffer mulai menulis data dari aliran.

count

Int32

Jumlah byte yang akan dibaca dari aliran saat ini.

cancellationToken

CancellationToken

Token yang akan dipantau untuk permintaan pembatalan.

Mengembalikan

ValueTask

Tugas yang mewakili operasi baca asinkron.

Pengecualian

ArgumentNullException

bufferadalah null.

ArgumentOutOfRangeException

offset berada di luar batas buffer.

-atau-

count negatif.

-atau-

Rentang yang ditentukan oleh kombinasi offset dan count melebihi panjang buffer.

EndOfStreamException

Akhir aliran tercapai sebelum membaca count jumlah byte.

OperationCanceledException

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

Keterangan

Ketika count adalah 0 (nol), operasi baca ini akan selesai tanpa menunggu data yang tersedia di aliran.

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 ReadExactly(Byte[], Int32, Int32).