IsolatedStorageFileStream.ReadAsync Methode

Definition

Namespace:

System.IO.IsolatedStorage

Assembly:

System.IO.IsolatedStorage.dll

Überlädt

ReadAsync(Byte[], Int32, Int32, CancellationToken)	Kopiert Bytes asynchron aus dem aktuellen gepufferten IsolatedStorageFileStream-Objekt in ein Bytearray.
ReadAsync(Memory<Byte>, CancellationToken)	Kopiert Bytes asynchron aus dem aktuellen gepufferten IsolatedStorageFileStream-Objekt in ein Bytespeicherbereich.

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

Quelle:

IsolatedStorageFileStream.cs

Kopiert Bytes asynchron aus dem aktuellen gepufferten IsolatedStorageFileStream-Objekt in ein Bytearray.

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

buffer

Byte[]

Der Puffer, in den die Daten geschrieben werden sollen.

offset

Int32

Der Offset im Puffer, ab dem geschrieben werden soll.

count

Int32

Die maximale Anzahl der zu lesenden Bytes.

cancellationToken

CancellationToken

Das Token zum Überwachen von Abbruchanforderungen. Der Standardwert ist None.

Gibt zurück

Task<Int32>

Eine Aufgabe, die den asynchronen Lesevorgang darstellt. Umschließt die Gesamtanzahl der in buffer gelesenen Bytes. Dies kann weniger als die Anzahl der angeforderten Bytes sein, wenn diese Anzahl an Bytes derzeit nicht verfügbar ist, oder 0 (null), wenn das Streamende erreicht ist.

Ausnahmen

OperationCanceledException

Das Abbruchtoken wurde abgebrochen. Diese Ausnahme wird in der zurückgegebenen Aufgabe gespeichert.

Hinweise

Der buffer Parameter kann eine Instanz der Buffer -Klasse oder ein Array eines der folgenden Typen sein: Byte, SByte, Char, Int16, Int32, Int64, UInt64SingleUInt16UInt32oder .Double

Wenn der Lesevorgang erfolgreich ist, wird die aktuelle Position des Datenstroms um die Anzahl der gelesenen Bytes erweitert. Wenn eine Ausnahme auftritt, bleibt 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 offset Parameter und count immer in Bytes 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 korrekten Wert für offset oder countzu bilden.

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

Diese Methode speichert in der Aufgabe, die alle Nichtverwendungsausnahmen zurückgibt, die die synchrone Entsprechung 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 wie ArgumentExceptionwerden weiterhin synchron ausgelöst. Informationen zu den gespeicherten Ausnahmen finden Sie unter ausnahmen, die von ausgelöst werden Read(Byte[], Int32, Int32).

ReadAsync(Memory<Byte>, CancellationToken)

Quelle:

IsolatedStorageFileStream.cs

Kopiert Bytes asynchron aus dem aktuellen gepufferten IsolatedStorageFileStream-Objekt in ein Bytespeicherbereich.

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

buffer

Memory<Byte>

Der Puffer, in den die Daten geschrieben werden sollen.

cancellationToken

CancellationToken

Das Token zum Überwachen von Abbruchanforderungen. Der Standardwert ist None.

Gibt zurück

ValueTask<Int32>

Eine Aufgabe, die den asynchronen Lesevorgang darstellt. Umschließt die Gesamtanzahl der in buffer gelesenen Bytes. Dies kann weniger als die Anzahl der angeforderten Bytes sein, wenn diese Anzahl an Bytes derzeit nicht verfügbar ist, oder 0 (null), wenn das Streamende erreicht ist.

Ausnahmen

OperationCanceledException

Das Abbruchtoken wurde abgebrochen. Diese Ausnahme wird in der zurückgegebenen Aufgabe gespeichert.