Bagikan melalui

GZipStream.WriteAsync Metode

  • Referensi

Definisi

Ruang nama:
System.IO.Compression
Rakitan:
System.IO.Compression.dll
Rakitan:
netstandard.dll

Overload

WriteAsync(ReadOnlyMemory<Byte>, CancellationToken)

Secara asinkron menulis byte terkompresi ke aliran GZip yang mendasar dari wilayah memori byte baca-saja yang ditentukan.
WriteAsync(Byte[], Int32, Int32, CancellationToken)

Secara asinkron menulis byte terkompresi ke aliran GZip yang mendasar dari array byte yang ditentukan.

WriteAsync(ReadOnlyMemory<Byte>, CancellationToken)

Sumber:
GZipStream.cs
Sumber:
GZipStream.cs
Sumber:
GZipStream.cs

Secara asinkron menulis byte terkompresi ke aliran GZip yang mendasar dari wilayah memori byte baca-saja yang ditentukan.

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

ValueTask

Tugas yang mewakili operasi tulis asinkron.

Pengecualian

OperationCanceledException

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

Keterangan

Metode ini WriteAsync memungkinkan Anda melakukan operasi I/O intensif sumber daya tanpa memblokir utas utama. Pertimbangan performa ini sangat penting dalam aplikasi desktop di mana operasi streaming yang memakan waktu dapat memblokir utas UI dan membuat aplikasi muncul seolah-olah tidak berfungsi. Metode asinkron digunakan bersama dengan async kata kunci dan await di Visual Basic dan C#.

CanWrite Gunakan properti untuk menentukan apakah instans saat ini mendukung penulisan.

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

Berlaku untuk

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

Sumber:
GZipStream.cs
Sumber:
GZipStream.cs
Sumber:
GZipStream.cs

Secara asinkron menulis byte terkompresi ke aliran GZip yang mendasar dari array byte yang ditentukan.

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

Parameter

arraybuffer
Byte[]

Buffer yang berisi data untuk dikompresi.

offset
Int32

Offset byte berbasis nol untuk mulai menyalin byte ke aliran GZip.

count
Int32

Jumlah maksimum byte yang akan ditulis.

cancellationToken
CancellationToken

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

Mengembalikan

Task

Tugas yang mewakili operasi tulis asinkron.

Pengecualian

OperationCanceledException

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

Keterangan

Metode ini WriteAsync memungkinkan Anda melakukan operasi I/O intensif sumber daya tanpa memblokir utas utama. Pertimbangan performa ini sangat penting dalam aplikasi desktop di mana operasi streaming yang memakan waktu dapat memblokir utas UI dan membuat aplikasi muncul seolah-olah tidak berfungsi. Metode asinkron digunakan bersama dengan async kata kunci dan await di Visual Basic dan C#.

CanWrite Gunakan properti untuk menentukan apakah instans saat ini mendukung penulisan.

Jika operasi dibatalkan sebelum selesai, tugas yang dikembalikan berisi TaskStatus.Canceled nilai untuk Task.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).

Berlaku untuk