Bagikan melalui


CryptoStream.WriteAsync Metode

Definisi

Overload

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

Menulis urutan byte ke aliran saat ini secara asinkron, memajukan posisi saat ini dalam aliran dengan jumlah byte yang ditulis, dan memantau permintaan pembatalan.

WriteAsync(ReadOnlyMemory<Byte>, CancellationToken)

Secara asinkron menulis urutan byte ke aliran saat ini, memajukan posisi saat ini dalam aliran ini dengan jumlah byte yang ditulis, dan memantau permintaan pembatalan.

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

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

Menulis urutan byte ke aliran saat ini secara asinkron, memajukan posisi saat ini dalam aliran dengan jumlah byte yang ditulis, dan memantau permintaan pembatalan.

public:
 override System::Threading::Tasks::Task ^ WriteAsync(cli::array <System::Byte> ^ buffer, int offset, int count, System::Threading::CancellationToken cancellationToken);
public override System.Threading.Tasks.Task WriteAsync (byte[] buffer, int offset, int count, System.Threading.CancellationToken cancellationToken);
override this.WriteAsync : byte[] * int * int * System.Threading.CancellationToken -> System.Threading.Tasks.Task
Public Overrides Function WriteAsync (buffer As Byte(), offset As Integer, count As Integer, cancellationToken As CancellationToken) As Task

Parameter

buffer
Byte[]

Buffer untuk menulis data.

offset
Int32

Offset byte berbasis nol untuk buffer mulai menulis byte ke aliran.

count
Int32

Jumlah maksimum byte yang akan ditulis.

cancellationToken
CancellationToken

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

Mengembalikan

Tugas yang mewakili operasi tulis asinkron.

Pengecualian

bufferadalah null.

offset atau count negatif.

Jumlah offset dan count lebih besar dari panjang buffer.

Aliran tidak mendukung penulisan.

Aliran telah dibuang.

Aliran saat ini sedang digunakan oleh operasi tulis sebelumnya.

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

Keterangan

Anda harus mengawali panggilan Anda dengan WriteAsyncawait 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 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 Write(Byte[], Int32, Int32).

Lihat juga

Berlaku untuk

WriteAsync(ReadOnlyMemory<Byte>, CancellationToken)

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

Secara asinkron menulis urutan byte ke aliran saat ini, memajukan posisi saat ini dalam aliran ini dengan jumlah byte yang ditulis, dan memantau permintaan pembatalan.

public override System.Threading.Tasks.ValueTask WriteAsync (ReadOnlyMemory<byte> buffer, System.Threading.CancellationToken cancellationToken = default);
override this.WriteAsync : ReadOnlyMemory<byte> * System.Threading.CancellationToken -> System.Threading.Tasks.ValueTask
Public Overrides Function WriteAsync (buffer As ReadOnlyMemory(Of Byte), Optional cancellationToken As CancellationToken = Nothing) As ValueTask

Parameter

buffer
ReadOnlyMemory<Byte>

Wilayah memori untuk menulis data.

cancellationToken
CancellationToken

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

Mengembalikan

Tugas yang mewakili operasi tulis asinkron.

Pengecualian

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

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

Berlaku untuk