Aracılığıyla paylaş

DeflateStream.WriteAsync Yöntem

  • Başvuru

Tanım

Ad Alanı:
System.IO.Compression
Bütünleştirilmiş Kod:
System.IO.Compression.dll
Bütünleştirilmiş Kod:
netstandard.dll

Aşırı Yüklemeler

WriteAsync(ReadOnlyMemory<Byte>, CancellationToken)

Sıkıştırılmış baytları belirtilen salt okunur bellek bölgesinden temel alınan Deflate akışına zaman uyumsuz olarak yazar.
WriteAsync(Byte[], Int32, Int32, CancellationToken)

Sıkıştırılmış baytları, belirtilen bayt dizisinden temel alınan Deflate akışına zaman uyumsuz olarak yazar.

WriteAsync(ReadOnlyMemory<Byte>, CancellationToken)

Kaynak:
DeflateStream.cs
Kaynak:
DeflateStream.cs
Kaynak:
DeflateStream.cs

Sıkıştırılmış baytları belirtilen salt okunur bellek bölgesinden temel alınan Deflate akışına zaman uyumsuz olarak yazar.

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

Parametreler

buffer
ReadOnlyMemory<Byte>

Veri yazacak bellek bölgesi.

cancellationToken
CancellationToken

İptal istekleri için izlenecek belirteç. None varsayılan değerdir.

Döndürülenler

ValueTask

Zaman uyumsuz yazma işlemini temsil eden görev.

Özel durumlar

OperationCanceledException

İptal belirteci iptal edildi. Bu özel durum, döndürülen görevde depolanır.

Açıklamalar

yöntemi, WriteAsync ana iş parçacığını engellemeden yoğun kaynak kullanımlı G/Ç işlemleri gerçekleştirmenizi sağlar. Zaman alan bir akış işleminin kullanıcı arabirimi iş parçacığını engellediği ve uygulamanın çalışmıyormuş gibi görünmesini sağlayabildiği masaüstü uygulamalarında bu performansla ilgili dikkat edilmesi gerekenler özellikle önemlidir. Zaman uyumsuz yöntemler, Visual Basic ve C# içindeki ve await anahtar sözcükleriyle async birlikte kullanılır.

CanWrite Geçerli örneğin yazmayı destekleyip desteklemediğini belirlemek için özelliğini kullanın.

İşlem tamamlanmadan iptal edilirse, döndürülen görev özelliğin TaskStatus.CanceledTask.Status değerini içerir.

Şunlara uygulanır

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

Kaynak:
DeflateStream.cs
Kaynak:
DeflateStream.cs
Kaynak:
DeflateStream.cs

Sıkıştırılmış baytları, belirtilen bayt dizisinden temel alınan Deflate akışına zaman uyumsuz olarak yazar.

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

Parametreler

arraybuffer
Byte[]

Sıkıştıracak verileri içeren arabellek.

offset
Int32

Baytları Deflate akışına kopyalamaya başlanacak sıfır tabanlı bayt uzaklığı.

count
Int32

Yazacak bayt sayısı üst sınırı.

cancellationToken
CancellationToken

İptal istekleri için izlenecek belirteç. None varsayılan değerdir.

Döndürülenler

Task

Zaman uyumsuz yazma işlemini temsil eden görev.

Özel durumlar

OperationCanceledException

İptal belirteci iptal edildi. Bu özel durum, döndürülen görevde depolanır.

Açıklamalar

yöntemi, WriteAsync ana iş parçacığını engellemeden yoğun kaynak kullanımlı G/Ç işlemleri gerçekleştirmenizi sağlar. Zaman alan bir akış işleminin kullanıcı arabirimi iş parçacığını engellediği ve uygulamanın çalışmıyormuş gibi görünmesini sağlayabildiği masaüstü uygulamalarında bu performansla ilgili dikkat edilmesi gerekenler özellikle önemlidir. Zaman uyumsuz yöntemler, Visual Basic ve C# içindeki ve await anahtar sözcükleriyle async birlikte kullanılır.

CanWrite Geçerli örneğin yazmayı destekleyip desteklemediğini belirlemek için özelliğini kullanın.

İşlem tamamlanmadan iptal edilirse, döndürülen görev özelliğin TaskStatus.CanceledTask.Status değerini içerir.

Bu yöntem, yöntemin zaman uyumlu karşılık geleninin atabileceği tüm kullanım dışı özel durumları döndürdüğü görevde depolar. Döndürülen görevde bir özel durum depolanıyorsa, görev beklenirken bu özel durum oluşturulur. gibi ArgumentExceptionkullanım özel durumları yine de zaman uyumlu olarak oluşturulur. Depolanan özel durumlar için tarafından oluşan Write(Byte[], Int32, Int32)özel durumlara bakın.

Şunlara uygulanır