Bagikan melalui


Stream.ReadExactlyAsync Metode

Definisi

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
Sumber:
Stream.cs
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

Tugas yang mewakili operasi baca asinkron.

Pengecualian

Akhir aliran tercapai sebelum mengisi buffer.

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.

Berlaku untuk

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

Sumber:
Stream.cs
Sumber:
Stream.cs
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

Tugas yang mewakili operasi baca asinkron.

Pengecualian

bufferadalah null.

offset berada di luar batas buffer.

-atau-

count negatif.

-atau-

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

Akhir aliran tercapai sebelum membaca count jumlah byte.

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

Berlaku untuk