Aracılığıyla paylaş


CryptoStream.ReadAsync Yöntem

Tanım

Aşırı Yüklemeler

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)

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

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

Kaynak:
CryptoStream.cs
Kaynak:
CryptoStream.cs
Kaynak:
CryptoStream.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);
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[]

Verilerin yazlýlýp yazýlýldýrýlýr.

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 isteklerini izlemek için belirteç. None varsayılan değerdir.

Döndürülenler

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

Özel durumlar

buffer, null değeridir.

offset veya count negatiftir.

ve count toplamı offset arabellek uzunluğundan daha büyüktür.

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

Önemli

.NET 6'dan başlayarak, bu yöntem istendiği kadar bayt okumayabilir. Daha fazla bilgi için bkz. DeflateStream, GZipStream ve CryptoStream'de kısmi ve sıfır bayt okumaları.

Görev tamamlanana kadar yöntemin await yürütülmesini askıya almak için ReadAsync çağrısına (C#) veya Await (Visual Basic) işlecini ön uygulamanız gerekir. Daha fazla bilgi için bkz. Zaman Uyumsuz programlama (C#) veya Async ve Await (Visual Basic) ile zaman uyumsuz programlama.

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

Bu yöntem, görevin içinde depolar ve yöntemin zaman uyumlu karşılık geleninin atabileceği tüm kullanım dışı özel durumları döndürür. Döndürülen görevde bir özel durum depolanırsa, görev beklenirken bu özel durum oluşturulur. gibi ArgumentExceptionkullanım özel durumları yine zaman uyumlu olarak oluşturulur. Depolanan özel durumlar için tarafından oluşan Read(Byte[], Int32, Int32)özel durumlara bakın.

Ayrıca bkz.

Şunlara uygulanır

ReadAsync(Memory<Byte>, CancellationToken)

Kaynak:
CryptoStream.cs
Kaynak:
CryptoStream.cs
Kaynak:
CryptoStream.cs

Geçerli akıştan bir bayt dizisini zaman uyumsuz olarak okur, okunan bayt sayısına göre akış içindeki konumu 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 isteklerini izlemek için belirteç. None varsayılan değerdir.

Döndürülenler

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

Özel durumlar

CryptoStreamMode Geçerli CryptoStream nesneyle ilişkili, temel alınan akışla eşleşmiyor. Örneğin, bu özel durum yalnızca yazılan bir temel akış ile kullanılırken Read oluşturulur.

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

Açıklamalar

.NET 6'dan başlayarak, bu yöntem istendiği kadar bayt okumayabilir. Daha fazla bilgi için bkz. DeflateStream, GZipStream ve CryptoStream'de kısmi ve sıfır bayt okumaları.

Şunlara uygulanır