MemoryStream.ReadAsync Yöntem

Tanım

Aşırı Yüklemeler

ReadAsync(Memory<Byte>, CancellationToken)

Geçerli bellek akışından zaman uyumsuz olarak bir bayt dizisi okur, dizinini içine destinationyazar, bellek akışındaki konumu okunan bayt sayısına göre ilerler ve iptal isteklerini izler.

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

Geçerli akıştan zaman uyumsuz olarak bir bayt dizisi okur, okunan bayt sayısına göre akış içindeki konumu ilerletir ve iptal isteklerini izler.

ReadAsync(Memory<Byte>, CancellationToken)

Kaynak:
MemoryStream.cs
Kaynak:
MemoryStream.cs
Kaynak:
MemoryStream.cs

Geçerli bellek akışından zaman uyumsuz olarak bir bayt dizisi okur, dizinini içine destinationyazar, bellek akışındaki konumu okunan bayt sayısına göre ilerler ve iptal isteklerini izler.

public override System.Threading.Tasks.ValueTask<int> ReadAsync (Memory<byte> destination, System.Threading.CancellationToken cancellationToken = default);
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>
override this.ReadAsync : Memory<byte> * System.Threading.CancellationToken -> System.Threading.Tasks.ValueTask<int>
Public Overrides Function ReadAsync (destination As Memory(Of Byte), Optional cancellationToken As CancellationToken = Nothing) As ValueTask(Of Integer)
Public Overrides Function ReadAsync (buffer As Memory(Of Byte), Optional cancellationToken As CancellationToken = Nothing) As ValueTask(Of Integer)

Parametreler

destinationbuffer
Memory<Byte>

Verileri yazacak bellek bölgesi.

cancellationToken
CancellationToken

İptal istekleri için izlenecek belirteç. None varsayılan değerdir.

Döndürülenler

Zaman uyumsuz okuma işlemini temsil eden görev. özelliğinin Result değeri içine okunan destinationtoplam bayt sayısını içerir. Sonuç değeri, şu anda kullanılabilir sayıda bayt yoksa içinde destination ayrılan bayt sayısından az veya bellek akışının sonuna ulaşıldıysa 0 (sıfır) olabilir.

Özel durumlar

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

Şunlara uygulanır

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

Kaynak:
MemoryStream.cs
Kaynak:
MemoryStream.cs
Kaynak:
MemoryStream.cs

Geçerli akıştan zaman uyumsuz olarak bir bayt dizisi okur, okunan bayt sayısına göre akış içindeki 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);
[System.Runtime.InteropServices.ComVisible(false)]
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>
[<System.Runtime.InteropServices.ComVisible(false)>]
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

Akıştan 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

Zaman uyumsuz okuma işlemini temsil eden görev. parametresinin TResult değeri arabelleğe okunan toplam bayt sayısını içerir. Şu anda kullanılabilir durumdaki bayt sayısı istenen sayıdan küçükse sonuç değeri istenen bayt sayısından küçük veya akışın sonuna ulaşıldıysa 0 (sıfır) olabilir.

Öznitelikler

Özel durumlar

buffer, null değeridir.

offset veya count negatiftir.

ve count toplamını offset arabellek uzunluğundan daha büyük.

Akış okumayı desteklemiyor.

Akış atıldı.

Akış şu anda önceki bir okuma işlemi tarafından kullanılıyor.

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

Açıklamalar

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

sınıfının bir örneğini CancellationTokenSource oluşturup özelliğini parametresi olarak cancellationToken geçirerek Token iptal belirteci oluşturabilirsiniz.

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.

Şunlara uygulanır