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)	Geçerli arabelleğe alınan IsolatedStorageFileStream nesneden baytları zaman uyumsuz olarak bayt dizisine kopyalar.
ReadAsync(Memory<Byte>, CancellationToken)	Zaman uyumsuz olarak baytları arabelleğe alınan IsolatedStorageFileStream geçerli nesneden bayt bellek aralığına kopyalar.

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

Kaynak:

IsolatedStorageFileStream.cs

Geçerli arabelleğe alınan IsolatedStorageFileStream nesneden baytları zaman uyumsuz olarak 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[]

Verileri yazacak arabellek.

offset

Int32

Yazmaya başlayabileceğiniz arabellekteki uzaklık.

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

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 aşağıdaki türlerden birine sahip bir dizi olabilir: Byte, SByte, Char, , Int16, Int32, Int64, , UInt64SingleUInt16UInt32, veya .Double

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

yöntemi, ReadAsync parametresini buffer gerçek türünden bağımsız olarak bayt bloğu olarak ele alır. Benzer şekilde, offset ve count parametreleri her zaman bayt cinsinden belirtilir. Bayt dizileri dışındaki parametreler için buffer bu, veya için doğru bir değer 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 dönmeden önce her zaman akıştan en az bir bayt okur. çağrısında ReadAsyncnesnesinden IsolatedStorageFileStream veri yoksa, yöntem en az bir bayt veri döndürülene kadar engeller.

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.

ReadAsync(Memory<Byte>, CancellationToken)

Kaynak:

IsolatedStorageFileStream.cs

Zaman uyumsuz olarak baytları arabelleğe alınan IsolatedStorageFileStream geçerli nesneden 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>

Verileri yazacak arabellek.

cancellationToken

CancellationToken

İptal istekleri için izlenecek 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.