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)

Parameter

Gibt zurück

Eine Aufgabe, die den asynchronen Lesevorgang darstellt. Es umschließt die Gesamtanzahl der Bytes, die in die buffer. Dies kann kleiner als die Anzahl der angeforderten Bytes sein, wenn viele Bytes derzeit nicht verfügbar sind, oder null, wenn das Ende des Datenstroms erreicht ist.

Ausnahmen

Hinweise

Der buffer Parameter kann eine Instanz der Buffer Klasse oder ein Array eines der folgenden Typen sein: Byte, , , SByte, Char, Int16, UInt32Int64Int32UInt16, UInt64, , , oder . SingleDouble

Wenn der Lesevorgang erfolgreich ist, wird die aktuelle Position des Datenstroms um die Anzahl der gelesenen Bytes erweitert. Wenn eine Ausnahme auftritt, ist die aktuelle Position des Datenstroms unverändert.

Die ReadAsync Methode behandelt den buffer Parameter unabhängig vom tatsächlichen Typ als Byteblock. Ebenso werden die Parameter und count die offset Parameter immer in Byte angegeben. Bei buffer Anderen Parametern als Bytearrays bedeutet dies, dass ein Elementindex oder die Anzahl der Elemente mit der Elementgröße in Bytes multipliziert werden muss, um einen richtigen Wert für offset oder count.

Die ReadAsync Methode gibt nur null zurück, wenn das Ende des Datenstroms erreicht ist. In allen anderen Fällen ReadAsync wird vor der Rückgabe immer mindestens ein Byte aus dem Datenstrom gelesen. Wenn bei einem Aufruf ReadAsyncdes Objekts keine Daten verfügbar IsolatedStorageFileStream sind, wird die Methode blockiert, bis mindestens ein Byte von Daten zurückgegeben werden kann.

Diese Methode speichert in der Aufgabe, die alle Nicht-Verwendungs-Ausnahmen zurückgibt, die das synchrone Gegenstück der Methode auslösen kann. Wenn eine Ausnahme in der zurückgegebenen Aufgabe gespeichert wird, wird diese Ausnahme ausgelöst, wenn die Aufgabe erwartet wird. Verwendungsausnahmen, z. B. ArgumentException, werden weiterhin synchron ausgelöst. Informationen zu den gespeicherten Ausnahmen finden Sie in den von 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)

Parameter

Gibt zurück

Eine Aufgabe, die den asynchronen Lesevorgang darstellt. Es umschließt die Gesamtanzahl der Bytes, die in die buffer. Dies kann kleiner als die Anzahl der angeforderten Bytes sein, wenn viele Bytes derzeit nicht verfügbar sind, oder null, wenn das Ende des Datenstroms erreicht ist.

Ausnahmen