Bagikan melalui


CryptoStream.ReadAsync Metode

Definisi

Overload

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

Membaca urutan byte dari aliran saat ini secara asinkron, memajukan posisi dalam aliran dengan jumlah byte yang dibaca, dan memantau permintaan pembatalan.

ReadAsync(Memory<Byte>, CancellationToken)

Secara asinkron membaca urutan byte dari aliran saat ini, memajukan posisi dalam aliran dengan jumlah byte yang dibaca, dan memantau permintaan pembatalan.

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

Sumber:
CryptoStream.cs
Sumber:
CryptoStream.cs
Sumber:
CryptoStream.cs

Membaca urutan byte dari aliran saat ini secara asinkron, memajukan posisi dalam aliran dengan jumlah byte yang dibaca, dan memantau permintaan pembatalan.

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

Tugas yang mewakili operasi baca asinkron. Nilai parameter objek TResult tugas berisi jumlah total byte yang dibaca ke dalam buffer. Hasilnya bisa 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

bufferadalah null.

offset atau count negatif.

Jumlah offset dan count lebih besar dari panjang buffer.

Aliran tidak mendukung pembacaan.

Aliran telah dibuang.

Aliran saat ini sedang digunakan oleh operasi baca sebelumnya.

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

Keterangan

Penting

Mulai dari .NET 6, metode ini mungkin tidak membaca byte sebanyak yang diminta. Untuk informasi selengkapnya, lihat Bacaan parsial dan nol byte di DeflateStream, GZipStream, dan CryptoStream.

Anda harus mengawali panggilan Anda dengan ReadAsyncawait operator (C#) atau Await (Visual Basic) untuk menangguhkan eksekusi metode hingga tugas selesai. Untuk informasi selengkapnya, lihat Pemrograman asinkron (C#) atau Pemrograman asinkron dengan Asinkron dan Menunggu (Visual Basic).

Jika operasi dibatalkan sebelum selesai, tugas yang dikembalikan berisi Canceled nilai untuk Status properti .

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

Lihat juga

Berlaku untuk

ReadAsync(Memory<Byte>, CancellationToken)

Sumber:
CryptoStream.cs
Sumber:
CryptoStream.cs
Sumber:
CryptoStream.cs

Secara asinkron membaca urutan byte dari aliran saat ini, memajukan posisi dalam aliran dengan jumlah byte yang dibaca, dan memantau permintaan pembatalan.

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>

Wilayah memori untuk menulis data.

cancellationToken
CancellationToken

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

Mengembalikan

Tugas yang mewakili operasi baca asinkron. Nilai propertinya Result berisi jumlah total byte yang dibaca ke dalam buffer. Nilai hasil dapat kurang dari jumlah byte yang dialokasikan dalam buffer jika banyak byte saat ini tidak tersedia, atau bisa 0 (nol) jika akhir aliran telah tercapai.

Pengecualian

Yang CryptoStreamMode terkait dengan objek saat ini CryptoStream tidak cocok dengan aliran yang mendasar. Misalnya, pengecualian ini dilemparkan saat menggunakan Read dengan aliran yang mendasar yang hanya menulis.

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

Keterangan

Mulai dari .NET 6, metode ini mungkin tidak membaca byte sebanyak yang diminta. Untuk informasi selengkapnya, lihat Bacaan parsial dan nol byte di DeflateStream, GZipStream, dan CryptoStream.

Berlaku untuk