GZipStream.CopyToAsync(Stream, Int32, CancellationToken) Yöntem

Tanım

Ad Alanı:

System.IO.Compression

Bütünleştirilmiş Kodlar:

netstandard.dll, System.IO.Compression.dll

Kaynak:

GZipStream.cs

Geçerli GZip akışındaki baytları zaman uyumsuz olarak okur ve belirtilen arabellek boyutunu kullanarak başka bir akışa yazar.

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

Parametreler

destination

Stream

Geçerli GZip akışının içeriğinin kopyalanacağı akış.

bufferSize

Int32

Arabelleğin bayt cinsinden boyutu. Bu değer sıfırdan büyük olmalıdır. Varsayılan boyut 81920'dir.

cancellationToken

CancellationToken

İptal isteklerini izlemek için belirteç. None varsayılan değerdir.

Döndürülenler

Task

Zaman uyumsuz kopyalama 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, CopyToAsync 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ı engelleyip uygulamanızın çalışmıyor gibi görünmesini sağlayabildiği bir masaüstü uygulamasında bu performans konusunda özellikle önemlidir. Zaman uyumsuz yöntemler, Visual Basic ve C# içindeki ve async anahtar sözcükleriyle await birlikte kullanılır.

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

Kopyalama, geçerli GZip akışındaki geçerli konumda başlar.

Bu yöntem, yöntemin zaman uyumlu karşılık geleninin oluşturabileceği tüm kullanım dışı özel durumları döndürdüğü görevde depolar. Döndürülen görevde bir özel durum depolanırsa, görev beklendiğinde bu özel durum oluşturulur. ArgumentExceptiongibi kullanım özel durumları hâlâ eşzamanlı olarak fırlatılır. Depolanan özel durumlar için tarafından CopyTo(Stream, Int32)oluşan özel durumlara bakın.