Stream.ReadExactlyAsync Yöntem

Tanım

Ad Alanı:

System.IO

Bütünleştirilmiş Kodlar:

netstandard.dll, System.Runtime.dll

Aşırı Yüklemeler

Name	Description
ReadExactlyAsync(Memory<Byte>, CancellationToken)	Geçerli akıştaki baytları zaman uyumsuz olarak okur, doldurulana kadar buffer akış içindeki konumu ilerletir ve iptal isteklerini izler.
ReadExactlyAsync(Byte[], Int32, Int32, CancellationToken)	Geçerli akıştaki bayt sayısını zaman uyumsuz olarak okur count , akış içindeki konumu ilerletir ve iptal isteklerini izler.

ReadExactlyAsync(Memory<Byte>, CancellationToken)

Kaynak:

Stream.cs

Geçerli akıştaki baytları zaman uyumsuz olarak okur, doldurulana kadar buffer akış içindeki konumu ilerletir ve iptal isteklerini izler.

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

member this.ReadExactlyAsync : Memory<byte> * System.Threading.CancellationToken -> System.Threading.Tasks.ValueTask

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

Parametreler

buffer

Memory<Byte>

Verileri yazacak arabellek.

cancellationToken

CancellationToken

İptal isteklerini izlemek için belirteç.

Döndürülenler

ValueTask

Zaman uyumsuz okuma işlemini temsil eden görev.

Özel durumlar

EndOfStreamException

akışı doldurulmadan bufferönce sonuna ulaşılır.

OperationCanceledException

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

Açıklamalar

Boş olduğunda buffer , bu okuma işlemi akışta kullanılabilir veriler beklenmeden tamamlanır.

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

Kaynak:

Stream.cs

Geçerli akıştaki bayt sayısını zaman uyumsuz olarak okur count , akış içindeki konumu ilerletir ve iptal isteklerini izler.

public System.Threading.Tasks.ValueTask ReadExactlyAsync(byte[] buffer, int offset, int count, System.Threading.CancellationToken cancellationToken = default);

member this.ReadExactlyAsync : byte[] * int * int * System.Threading.CancellationToken -> System.Threading.Tasks.ValueTask

Public Function ReadExactlyAsync (buffer As Byte(), offset As Integer, count As Integer, Optional cancellationToken As CancellationToken = Nothing) As ValueTask

Parametreler

buffer

Byte[]

Verileri yazacak arabellek.

offset

Int32

Akıştan veri yazmaya başlamak için bayt uzaklığı buffer .

count

Int32

Geçerli akıştan okunacak bayt sayısı.

cancellationToken

CancellationToken

İptal isteklerini izlemek için belirteç.

Döndürülenler

ValueTask

Zaman uyumsuz okuma işlemini temsil eden görev.

Özel durumlar

ArgumentNullException

buffer, null'e eşittir.

ArgumentOutOfRangeException

offset , sınırlarının bufferdışındadır.

-veya-

count negatiftir.

-veya-

ve count birleşimi offset tarafından belirtilen aralık, uzunluğunu bufferaşıyor.

EndOfStreamException

Bayt sayısı okunmadan count önce akışın sonuna ulaşılır.

OperationCanceledException

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

Açıklamalar

0 (sıfır) olduğunda count , bu okuma işlemi akışta kullanılabilir veriler beklenmeden tamamlanır.

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 ReadExactly(Byte[], Int32, Int32)oluşan özel durumlara bakın.