UnmanagedMemoryStream.ReadAsync Metode

Definisi

Ruang nama:

System.IO

Rakitan:

System.Runtime.dll

Overload

ReadAsync(Memory<Byte>, CancellationToken)	Secara asinkron membaca byte aliran memori yang tidak dikelola ke wilayah memori.
ReadAsync(Byte[], Int32, Int32, CancellationToken)	Secara asinkron membaca jumlah byte yang ditentukan ke dalam array yang ditentukan.

ReadAsync(Memory<Byte>, CancellationToken)

Sumber:

UnmanagedMemoryStream.cs

Secara asinkron membaca byte aliran memori yang tidak dikelola ke wilayah memori.

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>

Ketika metode asinkron selesai, wilayah memori ini berisi semua byte yang dibaca dari aliran memori yang tidak dikelola.

cancellationToken

CancellationToken

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

Mengembalikan

ValueTask<Int32>

Tugas yang mewakili operasi baca asinkron, dan membungkus jumlah total byte yang dibaca ke dalam buffer.

Pengecualian

OperationCanceledException

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

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

Sumber:

UnmanagedMemoryStream.cs

Secara asinkron membaca jumlah byte yang ditentukan ke dalam array yang ditentukan.

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.

offset

Int32

Offset byte untuk buffer mulai menulis data dari aliran.

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. Nilai TResult parameter berisi jumlah total byte yang dibaca ke dalam buffer. Nilai hasil dapat kurang dari jumlah byte yang diminta jika jumlah byte yang saat ini tersedia kurang dari angka yang diminta, atau bisa 0 (nol) jika akhir aliran telah tercapai.

Pengecualian

OperationCanceledException

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

Keterangan

Jika pengecualian terjadi selama operasi baca, pengecualian akan ditetapkan sebagai Task.Exception properti dari tugas yang dikembalikan.

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