CryptoStream.CopyToAsync(Stream, Int32, CancellationToken) Metode

Definisi

Ruang nama:

System.Security.Cryptography

Rakitan:

System.Security.Cryptography.dll

Sumber:

CryptoStream.cs

Secara asinkron membaca byte dari aliran yang mendasar, menerapkan transformasi kriptografi yang relevan, dan menulis hasilnya ke aliran tujuan.

public:
 override System::Threading::Tasks::Task ^ CopyToAsync(System::IO::Stream ^ destination, int bufferSize, System::Threading::CancellationToken cancellationToken);

public override System.Threading.Tasks.Task CopyToAsync (System.IO.Stream destination, int bufferSize, System.Threading.CancellationToken cancellationToken);

override this.CopyToAsync : System.IO.Stream * int * System.Threading.CancellationToken -> System.Threading.Tasks.Task

Public Overrides Function CopyToAsync (destination As Stream, bufferSize As Integer, cancellationToken As CancellationToken) As Task

Parameter

destination

Stream

Aliran tempat konten aliran saat ini akan disalin.

bufferSize

Int32

Ukuran, dalam byte, dari buffer. Nilai ini harus lebih besar dari nol. Ukuran defaultnya adalah 81920.

cancellationToken

CancellationToken

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

Mengembalikan

Task

Tugas yang mewakili operasi penyalinan asinkron.

Pengecualian

ArgumentNullException

destinationadalah null.

ArgumentOutOfRangeException

buffersize negatif atau nol.

ObjectDisposedException

Aliran saat ini atau aliran tujuan dibuang.

NotSupportedException

Aliran saat ini tidak mendukung pembacaan, atau aliran tujuan tidak mendukung penulisan.

CryptographicException

Terjadi kesalahan selama operasi kriptografi.

OperationCanceledException

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

Keterangan

Penyalinan dimulai pada posisi saat ini di aliran saat ini, dan tidak mengatur ulang posisi aliran tujuan setelah operasi salin selesai.

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 CopyTo(Stream, Int32).