DeflateStream.ReadAsync Yöntem

Tanım

Aşırı Yüklemeler

ReadAsync(Memory<Byte>, CancellationToken)

Geçerli söndür akışından bir bayt dizisini zaman uyumsuz olarak okur, bir bayt bellek aralığına yazar, söndür akış içindeki konumu okunan bayt sayısıyla ilerletir ve iptal isteklerini izler.Asynchronously reads a sequence of bytes from the current Deflate stream, writes them to a byte memory range, advances the position within the Deflate stream by the number of bytes read, and monitors cancellation requests.

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

Geçerli söndür akışından bir bayt dizisini zaman uyumsuz olarak okur, bir bayt dizisine yazar, söndür akış içindeki konumu okunan bayt sayısıyla ilerletir ve iptal isteklerini izler.Asynchronously reads a sequence of bytes from the current Deflate stream, writes them to a byte array, advances the position within the Deflate stream by the number of bytes read, and monitors cancellation requests.

ReadAsync(Memory<Byte>, CancellationToken)

Geçerli söndür akışından bir bayt dizisini zaman uyumsuz olarak okur, bir bayt bellek aralığına yazar, söndür akış içindeki konumu okunan bayt sayısıyla ilerletir ve iptal isteklerini izler.Asynchronously reads a sequence of bytes from the current Deflate stream, writes them to a byte memory range, advances the position within the Deflate stream by the number of bytes read, and monitors cancellation requests.

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>

Verilerin yazılacağı bellek bölgesi.The region of memory to write the data into.

cancellationToken
CancellationToken

İptal isteklerini izlemeye yönelik belirteç.The token to monitor for cancellation requests. Varsayılan değer: None.The default value is None.

Döndürülenler

ValueTask<Int32>

Arabelleğe okunan toplam bayt sayısını sarmalayan, zaman uyumsuz okuma işlemini temsil eden bir görev.A task that represents the asynchronous read operation, which wraps the total number of bytes read into the buffer. Sonuç değeri, bu sayıda bayt kullanılabilir durumda değilse arabellekte ayrılan bayt sayısından daha az olabilir veya söndür akışın sonuna ulaşılırsa 0 (sıfır) olabilir.The result value can be less than the number of bytes allocated in the buffer if that many bytes are not currently available, or it can be 0 (zero) if the end of the Deflate stream has been reached.

Açıklamalar

ReadAsyncYöntemi, ana iş parçacığını engellemeden Kaynak yoğunluklu g/ç işlemlerini gerçekleştirmenize olanak sağlar.The ReadAsync method enables you to perform resource-intensive I/O operations without blocking the main thread. Bu performans artışı özellikle bir Windows 8.x MağazasıWindows 8.x Store veya masaüstüdesktop uygulamasında önemlidir, çünkü UI iş parçacığını engelleyen zaman alan bir işlem uygulamanızın çalışmıyor gibi gözükmesine sebep olabilir.This performance consideration is particularly important in a Windows 8.x MağazasıWindows 8.x Store app or masaüstüdesktop app where a time-consuming stream operation can block the UI thread and make your app appear as if it is not working. Zaman uyumsuz yöntemler, async await Visual Basic ve C# ' deki ve anahtar sözcüklerle birlikte kullanılır.The async methods are used in conjunction with the async and await keywords in Visual Basic and C#.

CanReadGeçerli örneğin okumayı destekleyip desteklemediğini öğrenmek için özelliğini kullanın.Use the CanRead property to determine whether the current instance supports reading.

İşlem tamamlanmadan önce iptal edilirse, döndürülen görev TaskStatus.Canceled özelliğin değerini içerir Task.Status .If the operation is canceled before it completes, the returned task contains the TaskStatus.Canceled value for the Task.Status property.

Şunlara uygulanır

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

Geçerli söndür akışından bir bayt dizisini zaman uyumsuz olarak okur, bir bayt dizisine yazar, söndür akış içindeki konumu okunan bayt sayısıyla ilerletir ve iptal isteklerini izler.Asynchronously reads a sequence of bytes from the current Deflate stream, writes them to a byte array, advances the position within the Deflate stream by the number of bytes read, and monitors cancellation requests.

public:
 override System::Threading::Tasks::Task<int> ^ ReadAsync(cli::array <System::Byte> ^ array, int offset, int count, System::Threading::CancellationToken cancellationToken);
public override System.Threading.Tasks.Task<int> ReadAsync (byte[] array, 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 (array As Byte(), offset As Integer, count As Integer, cancellationToken As CancellationToken) As Task(Of Integer)

Parametreler

array
Byte[]

Verilerin yazılacağı arabellek.The buffer to write the data into.

offset
Int32

arraySöndür akıştan veri yazmaya başlamak için kullanılacak bayt kayması.The byte offset in array at which to begin writing data from the Deflate stream.

count
Int32

Okunacak en fazla bayt sayısı.The maximum number of bytes to read.

cancellationToken
CancellationToken

İptal isteklerini izlemeye yönelik belirteç.The token to monitor for cancellation requests. Varsayılan değer: None.The default value is None.

Döndürülenler

Task<Int32>

İçinde okunan toplam bayt sayısını sarmalayan, zaman uyumsuz okuma işlemini temsil eden bir görev array .A task that represents the asynchronous read operation, which wraps the total number of bytes read into the array. Sonuç değeri, şu anda kullanılabilir olan bayt sayısı istenen sayıdan az olursa veya bir söndür akışın sonuna ulaşılırsa 0 (sıfır) olabilir.The result value can be less than the number of bytes requested if the number of bytes currently available is less than the requested number, or it can be 0 (zero) if the end of the Deflate stream has been reached.

Açıklamalar

ReadAsyncYöntemi, ana iş parçacığını engellemeden Kaynak yoğunluklu g/ç işlemlerini gerçekleştirmenize olanak sağlar.The ReadAsync method enables you to perform resource-intensive I/O operations without blocking the main thread. Bu performans artışı özellikle bir Windows 8.x MağazasıWindows 8.x Store veya masaüstüdesktop uygulamasında önemlidir, çünkü UI iş parçacığını engelleyen zaman alan bir işlem uygulamanızın çalışmıyor gibi gözükmesine sebep olabilir.This performance consideration is particularly important in a Windows 8.x MağazasıWindows 8.x Store app or masaüstüdesktop app where a time-consuming stream operation can block the UI thread and make your app appear as if it is not working. Zaman uyumsuz yöntemler, async await Visual Basic ve C# ' deki ve anahtar sözcüklerle birlikte kullanılır.The async methods are used in conjunction with the async and await keywords in Visual Basic and C#.

CanReadGeçerli örneğin okumayı destekleyip desteklemediğini öğrenmek için özelliğini kullanın.Use the CanRead property to determine whether the current instance supports reading.

İşlem tamamlanmadan önce iptal edilirse, döndürülen görev TaskStatus.Canceled özelliğin değerini içerir Task.Status .If the operation is canceled before it completes, the returned task contains the TaskStatus.Canceled value for the Task.Status property.

Şunlara uygulanır