GZipStream.ReadAsync Yöntem

Tanım

Ad Alanı:

System.IO.Compression

Bütünleştirilmiş Kod:

System.IO.Compression.dll

Aşırı Yüklemeler

ReadAsync(Memory<Byte>, CancellationToken)	Geçerli GZip akışındaki bayt dizisini zaman uyumsuz olarak bayt bellek bölgesine okur, GZip akışı içindeki konumu okunan bayt sayısına göre ilerletir ve iptal isteklerini izler.
ReadAsync(Byte[], Int32, Int32, CancellationToken)	Geçerli GZip akışından bayt dizisini zaman uyumsuz olarak bir bayt dizisine okur, GZip akışı içindeki konumu okunan bayt sayısına göre ilerler ve iptal isteklerini izler.

ReadAsync(Memory<Byte>, CancellationToken)

Kaynak:

GZipStream.cs

Geçerli GZip akışındaki bayt dizisini zaman uyumsuz olarak bayt bellek bölgesine okur, GZip akışı içindeki konumu okunan bayt sayısına göre ilerletir ve iptal isteklerini izler.

public override System.Threading.Tasks.ValueTask<int> ReadAsync (Memory<byte> buffer, System.Threading.CancellationToken cancellationToken = default);

override this.ReadAsync : Memory<byte> * System.Threading.CancellationToken -> System.Threading.Tasks.ValueTask<int>

Public Overrides Function ReadAsync (buffer As Memory(Of Byte), Optional cancellationToken As CancellationToken = Nothing) As ValueTask(Of Integer)

Parametreler

buffer

Memory<Byte>

Verileri yazacak bellek bölgesi.

cancellationToken

CancellationToken

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

Döndürülenler

ValueTask<Int32>

Arabelleğe okunan toplam bayt sayısını sarmalayan zaman uyumsuz okuma işlemini temsil eden görev. Sonuç değeri, şu anda kullanılabilir sayıda bayt yoksa arabellekte ayrılan bayt sayısından az veya GZip akışının sonuna ulaşıldıysa 0 (sıfır) olabilir.

Özel durumlar

OperationCanceledException

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

Açıklamalar

Önemli

.NET 6'dan başlayarak, bu yöntem istendiği kadar bayt okumayabilir. Daha fazla bilgi için bkz. DeflateStream, GZipStream ve CryptoStream'de kısmi ve sıfır bayt okumaları.

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

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

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

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

Kaynak:

GZipStream.cs

Geçerli GZip akışından bayt dizisini zaman uyumsuz olarak bir bayt dizisine okur, GZip akışı içindeki konumu okunan bayt sayısına göre ilerler ve iptal isteklerini izler.

public:
 override System::Threading::Tasks::Task<int> ^ ReadAsync(cli::array <System::Byte> ^ buffer, int offset, int count, System::Threading::CancellationToken cancellationToken);

public override System.Threading.Tasks.Task<int> ReadAsync (byte[] buffer, int offset, int count, System.Threading.CancellationToken cancellationToken);

override this.ReadAsync : byte[] * int * int * System.Threading.CancellationToken -> System.Threading.Tasks.Task<int>

Public Overrides Function ReadAsync (buffer As Byte(), offset As Integer, count As Integer, cancellationToken As CancellationToken) As Task(Of Integer)

Parametreler

buffer

Byte[]

Verilerin yazlýlýp yazýlýldýrýlýr.

offset

Int32

GZip akışından veri yazmaya başlayabileceğiniz bayt uzaklığı.

count

Int32

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

cancellationToken

CancellationToken

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

Döndürülenler

Task<Int32>

Toplam okunan bayt sayısını kaydıran zaman uyumsuz okuma işlemini temsil eden görev. Şu anda kullanılabilir bayt sayısı istenen sayıdan küçükse sonuç değeri istenen bayt sayısından az veya GZip akışının sonuna ulaşıldıysa 0 (sıfır) olabilir.

Özel durumlar

OperationCanceledException

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

Açıklamalar

Önemli

.NET 6'dan başlayarak, bu yöntem istendiği kadar bayt okumayabilir. Daha fazla bilgi için bkz. DeflateStream, GZipStream ve CryptoStream'de kısmi ve sıfır bayt okumaları.

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

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

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

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