BrotliStream.ReadAsync Yöntem

Tanım

Ad Alanı:

System.IO.Compression

Bütünleştirilmiş Kod:

System.IO.Compression.Brotli.dll

Aşırı Yüklemeler

ReadAsync(Memory<Byte>, CancellationToken)	Geçerli Brotli akışından zaman uyumsuz olarak bir bayt dizisi okur, bunları bir bayt bellek aralığına yazar, Brotli akışındaki konumu okunan bayt sayısına göre ilerletir ve iptal isteklerini izler.
ReadAsync(Byte[], Int32, Int32, CancellationToken)	Geçerli Brotli akışından zaman uyumsuz olarak bir bayt dizisi okur, bunları belirtilen dizinden başlayarak bir bayt dizisine yazar, Okunan bayt sayısına göre Brotli akışındaki konumu ilerletir ve iptal isteklerini izler.

ReadAsync(Memory<Byte>, CancellationToken)

Kaynak:

BrotliStream.Decompress.cs

Geçerli Brotli akışından zaman uyumsuz olarak bir bayt dizisi okur, bunları bir bayt bellek aralığına yazar, Brotli akışındaki 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 istekleri için izlenecek 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 Brotli 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

'ReadAsync' yöntemi, 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ızın çalışmıyormuş gibi görünmesini sağlayabildiği bir Windows 8.x Store uygulamasında veya masaüstü uygulaması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.

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

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

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

Kaynak:

BrotliStream.Decompress.cs

Geçerli Brotli akışından zaman uyumsuz olarak bir bayt dizisi okur, bunları belirtilen dizinden başlayarak bir bayt dizisine yazar, Okunan bayt sayısına göre Brotli 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

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

count

Int32

Okunacak 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<Int32>

zaman uyumsuz okuma işlemini temsil eden ve okunan toplam bayt sayısını içine buffersarmalayan görev. Sonuç değeri, şu anda kullanılabilir durumdaki bayt sayısı istenen sayıdan küçükse istenen bayt sayısından küçük veya Brotli 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

'ReadAsync' yöntemi, 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ızın çalışmıyormuş gibi görünmesini sağlayabildiği bir Windows 8.x Store uygulamasında veya masaüstü uygulaması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.

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

İşlem tamamlanmadan iptal edilirse, döndürülen görev özelliğin CanceledStatus 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 Read(Byte[], Int32, Int32)özel durumlara bakın.