IsolatedStorageFileStream.ReadAsync Metod

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)

Parametrar

Returer

En uppgift som representerar den asynkrona läsåtgärden. Den omsluter det totala antalet byte som lästs in i buffer. Detta kan vara mindre än antalet byte som begärs om så många byte inte är tillgängliga för närvarande, eller noll om strömmens slut nås.

Undantag

Kommentarer

Parametern buffer kan vara en instans av Buffer klassen eller en matris med någon av följande typer: Byte, , SByte, CharInt16, Int32, Int64, UInt16, UInt32, , UInt64, Singleeller Double.

Om läsåtgärden lyckas avanceras strömmens aktuella position med antalet lästa byte. Om ett undantag inträffar ändras strömmens aktuella position.

Metoden ReadAsync behandlar parametern buffer som ett block med byte, oavsett dess faktiska typ. På samma sätt anges parametrarna offset och count alltid i byte. För buffer andra parametrar än bytematriser innebär det att ett elementindex eller antalet element måste multipliceras med elementstorleken i byte för att bilda ett korrekt värde för offset eller count.

Metoden ReadAsync returnerar endast noll om strömmens slut nås. I alla andra fall ReadAsync läser du alltid minst en byte från strömmen innan den returneras. Om inga data är tillgängliga från IsolatedStorageFileStream objektet vid ett anrop till ReadAsyncblockeras metoden tills minst en byte data kan returneras.

Den här metoden lagrar i aktiviteten som returnerar alla undantag som inte används som metodens synkrona motsvarighet kan utlösa. Om ett undantag lagras i den returnerade aktiviteten utlöses undantaget när aktiviteten väntar. Användningsfel, till exempel ArgumentException, genereras fortfarande synkront. De lagrade undantagen finns i undantagen som genereras av Read(Byte[], Int32, Int32).

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)

Parametrar

Returer

En uppgift som representerar den asynkrona läsåtgärden. Den omsluter det totala antalet byte som lästs in i buffer. Detta kan vara mindre än antalet byte som begärs om så många byte inte är tillgängliga för närvarande, eller noll om strömmens slut nås.

Undantag