Stream.ReadExactlyAsync Yöntem

Tanım

Ad Alanı:

System.IO

Bütünleştirilmiş Kod:

System.Runtime.dll

Aşırı Yüklemeler

ReadExactlyAsync(Memory<Byte>, CancellationToken)	Geçerli akıştaki baytları zaman uyumsuz olarak okur, doldurulana kadar buffer akış içindeki konumu ilerler 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 ilerler 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 istekleri için izlenecek belirteç.

Döndürülenler

ValueTask

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

Özel durumlar

EndOfStreamException

Akışın sonuna, doldurulmadan bufferönce 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şlayabileceğiniz bayt uzaklığı buffer .

count

Int32

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

cancellationToken

CancellationToken

İptal istekleri için izlenecek belirteç.

Döndürülenler

ValueTask

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

Özel durumlar

ArgumentNullException

buffer, null değeridir.

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