DeflateStream.ReadAsync Yöntem

Tanım

Ad Alanı:

System.IO.Compression

Bütünleştirilmiş Kodlar:

netstandard.dll, System.IO.Compression.dll

Aşırı Yüklemeler

Name	Description
ReadAsync(Memory<Byte>, CancellationToken)	Geçerli Deflate akışından zaman uyumsuz olarak bir bayt dizisi okur, bunları bir bayt bellek aralığına yazar, okunan bayt sayısıyla Deflate akışındaki konumu ilerletir ve iptal isteklerini izler.
ReadAsync(Byte[], Int32, Int32, CancellationToken)	Geçerli Deflate akışından zaman uyumsuz olarak bir bayt dizisi okur, bunları bir bayt dizisine yazar, okunan bayt sayısıyla Deflate akışındaki konumu ilerletir ve iptal isteklerini izler.

ReadAsync(Memory<Byte>, CancellationToken)

Kaynak:

DeflateStream.cs

Geçerli Deflate akışından zaman uyumsuz olarak bir bayt dizisi okur, bunları bir bayt bellek aralığına yazar, okunan bayt sayısıyla Deflate akışındaki konumu 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ç. Varsayılan değer None değeridir.

Döndürülenler

ValueTask<Int32>

Zaman uyumsuz okuma işlemini temsil eden ve toplam okunan bayt sayısını arabelleğe kaydıran görev. Sonuç değeri, şu anda kullanılabilir sayıda bayt yoksa arabellekte ayrılan bayt sayısından az veya Deflate 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ı engelleyip 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:

DeflateStream.cs

Geçerli Deflate akışından zaman uyumsuz olarak bir bayt dizisi okur, bunları bir bayt dizisine yazar, okunan bayt sayısıyla Deflate akışındaki konumu ilerletir 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[]

Verileri yazacak arabellek.

offset

Int32

Deflate akışından veri yazmaya başlamak için bayt uzaklığı.

count

Int32

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

cancellationToken

CancellationToken

İptal isteklerini izlemek için belirteç. Varsayılan değer None değeridir.

Döndürülenler

Task<Int32>

Zaman uyumsuz okuma işlemini temsil eden ve toplam okunan bayt sayısını arabelleğe kaydıran görev. Sonuç değeri, kullanılabilir durumdaki bayt sayısı istenen sayıdan küçükse istenen bayt sayısından az veya Deflate 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ı engelleyip 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, 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 Read(Byte[], Int32, Int32)oluşan özel durumlara bakın.