IsolatedStorageFileStream.ReadAsync Methode

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)

Parameters

Retouren

Een taak die de asynchrone leesbewerking vertegenwoordigt. Hiermee wordt het totale aantal bytes verpakt dat is gelezen in de buffer. Dit kan kleiner zijn dan het aantal aangevraagde bytes als er momenteel niet veel bytes beschikbaar zijn of nul als het einde van de stream is bereikt.

Uitzonderingen

Opmerkingen

De buffer parameter kan een exemplaar van de Buffer klasse zijn of een matrix van een van de volgende typen: Byte, , SByte, Char, Int16, , Int64Int32UInt16, , , UInt32, UInt64of .DoubleSingle

Als de leesbewerking is geslaagd, wordt de huidige positie van de stream geavanceerd met het aantal bytes gelezen. Als er een uitzondering optreedt, is de huidige positie van de stream ongewijzigd.

De ReadAsync methode behandelt de buffer parameter als een blok bytes, ongeacht het werkelijke type. Op dezelfde manier worden de offset en count parameters altijd opgegeven in bytes. Voor buffer andere parameters dan bytematrices betekent dit dat een elementindex of het aantal elementen moet worden vermenigvuldigd met de elementgrootte in bytes om een juiste waarde voor offset of countte vormen.

De ReadAsync methode retourneert alleen nul als het einde van de stream is bereikt. In alle andere gevallen ReadAsync leest u altijd ten minste één byte uit de stream voordat u terugkeert. Als er geen gegevens beschikbaar zijn vanuit het IsolatedStorageFileStream object bij een aanroep naar ReadAsync, wordt de methode geblokkeerd totdat ten minste één byte aan gegevens kan worden geretourneerd.

Deze methode slaat op in de taak die alle uitzonderingen voor niet-gebruik retourneert die de synchrone tegenhanger van de methode kan genereren. Als er een uitzondering wordt opgeslagen in de geretourneerde taak, wordt deze uitzondering gegenereerd wanneer de taak wordt gewacht. Gebruiksonderzondering, zoals ArgumentException, worden nog steeds synchroon gegenereerd. Zie de uitzonderingen die zijn gegenereerd door Read(Byte[], Int32, Int32)de opgeslagen uitzonderingen voor de opgeslagen uitzonderingen.

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)

Parameters

Retouren

Een taak die de asynchrone leesbewerking vertegenwoordigt. Hiermee wordt het totale aantal bytes verpakt dat is gelezen in de buffer. Dit kan kleiner zijn dan het aantal aangevraagde bytes als er momenteel niet veel bytes beschikbaar zijn of nul als het einde van de stream is bereikt.

Uitzonderingen