IsolatedStorageFileStream.ReadAsync Yöntem

Tanım

Ad Alanı:

System.IO.IsolatedStorage

Bütünleştirilmiş Kod:

System.IO.IsolatedStorage.dll

Aşırı Yüklemeler

ReadAsync(Byte[], Int32, Int32, CancellationToken)	Zaman uyumsuz olarak geçerli arabelleğe alınan IsolatedStorageFileStream nesneden baytları bir bayt dizisine kopyalar.
ReadAsync(Memory<Byte>, CancellationToken)	Zaman uyumsuz olarak geçerli arabelleğe alınan IsolatedStorageFileStream nesneden baytları bayt bellek aralığına kopyalar.

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

Kaynak:

IsolatedStorageFileStream.cs

Zaman uyumsuz olarak geçerli arabelleğe alınan IsolatedStorageFileStream nesneden baytları bir bayt dizisine kopyalar.

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

Yazmaya başlayabileceğiniz arabellekteki uzaklık.

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

Task<Int32>

Zaman uyumsuz okuma işlemini temsil eden görev. Okunan toplam bayt sayısını içine buffersarmalar. Bu, şu anda kullanılabilir sayıda bayt yoksa istenen bayt sayısından az veya akışın sonuna ulaşılırsa sıfır olabilir.

Özel durumlar

OperationCanceledException

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

Açıklamalar

buffer parametresi sınıfının bir örneği Buffer veya şu türlerden birinin dizisi olabilir: Byte, SByte, Char, Int16, Int32, , Int64, UInt16, , UInt32, UInt64, Singleveya Double.

Okuma işlemi başarılı olursa, akışın geçerli konumu okunan bayt sayısına göre gelişmiştir. Bir özel durum oluşursa akışın geçerli konumu değişmez.

yöntemi, ReadAsync gerçek türünden buffer bağımsız olarak parametresini bayt bloğu olarak ele alır. Benzer şekilde, offset ve count parametreleri her zaman bayt cinsinden belirtilir. Bayt buffer dizileri dışındaki parametrelerde, veya için doğru değeri oluşturmak için offsetcountbir öğe dizininin veya öğe sayısının bayt cinsinden öğe boyutuyla çarpılması gerektiği anlamına gelir.

ReadAsync yöntemi yalnızca akışın sonuna ulaşılırsa sıfır döndürür. Diğer tüm durumlarda, ReadAsync geri dönmeden önce her zaman akıştan en az bir bayt okur. çağrısı ReadAsyncüzerine nesneden IsolatedStorageFileStream kullanılabilir veri yoksa, yöntem en az bir bayt veri döndürülene kadar engeller.

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.

ReadAsync(Memory<Byte>, CancellationToken)

Kaynak:

IsolatedStorageFileStream.cs

Zaman uyumsuz olarak geçerli arabelleğe alınan IsolatedStorageFileStream nesneden baytları bayt bellek aralığına kopyalar.

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 yazlýlýp yazýlýldýrýlýr.

cancellationToken

CancellationToken

İptal isteklerini izlemek için belirteç. None varsayılan değerdir.

Döndürülenler

ValueTask<Int32>

Zaman uyumsuz okuma işlemini temsil eden görev. Okunan toplam bayt sayısını içine buffersarmalar. Bu, şu anda kullanılabilir sayıda bayt yoksa istenen bayt sayısından az veya akışın sonuna ulaşılırsa sıfır olabilir.

Özel durumlar

OperationCanceledException

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