IsolatedStorageFileStream.ReadAsync Método

Definición

Espacio de nombres:

System.IO.IsolatedStorage

Ensamblado:

System.IO.IsolatedStorage.dll

Sobrecargas

ReadAsync(Byte[], Int32, Int32, CancellationToken)	Copia bytes de forma asincrónica en una matriz de bytes a partir del actual objeto IsolatedStorageFileStream almacenado en búfer.
ReadAsync(Memory<Byte>, CancellationToken)	Copia bytes de forma asincrónica en un rango de memoria de bytes a partir del actual objeto IsolatedStorageFileStream almacenado en búfer.

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

Source:

IsolatedStorageFileStream.cs

Copia bytes de forma asincrónica en una matriz de bytes a partir del actual objeto IsolatedStorageFileStream almacenado en búfer.

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)

Parámetros

buffer

Byte[]

El búfer en el que se escriben los datos.

offset

Int32

Desplazamiento en el búfer donde debe comenzar la escritura.

count

Int32

Número máximo de bytes que se pueden leer.

cancellationToken

CancellationToken

Token para supervisar solicitudes de cancelación. El valor predeterminado es None.

Devoluciones

Task<Int32>

Tarea que representa la operación de lectura asincrónica. Ajusta el número total de bytes leídos en buffer. Puede ser menor que el número de bytes solicitado si dicho número de bytes no está disponible en la actualidad, o cero si se alcanza el final de la secuencia.

Excepciones

OperationCanceledException

Se canceló el token de cancelación. Esta excepción se almacena en la tarea devuelta.

Comentarios

El buffer parámetro puede ser una instancia de la Buffer clase o una matriz de uno de los siguientes tipos: Byte, SByteChar, , Int16Int32, Int64, UInt16, UInt32, , UInt64, Singleo Double.

Si la operación de lectura se realiza correctamente, la posición actual de la secuencia está avanzada por el número de bytes leídos. Si se produce una excepción, la posición actual de la secuencia no cambia.

El ReadAsync método trata el buffer parámetro como un bloque de bytes, independientemente de su tipo real. Del mismo modo, los offset parámetros y count siempre se especifican en bytes. En buffer el caso de los parámetros distintos de las matrices de bytes, esto significa que un índice de elemento o el número de elementos se deben multiplicar por el tamaño del elemento en bytes para formar un valor correcto para offset o count.

El ReadAsync método devolverá cero solo si se alcanza el final de la secuencia. En todos los demás casos, ReadAsync siempre lee al menos un byte de la secuencia antes de volver. Si no hay datos disponibles desde el IsolatedStorageFileStream objeto tras una llamada a ReadAsync, el método se bloqueará hasta que se pueda devolver al menos un byte de datos.

Este método almacena en la tarea que devuelve todas las excepciones que no son de uso que puede producir el homólogo sincrónico del método. Si se almacena una excepción en la tarea devuelta, esa excepción se producirá cuando se espere a la tarea. Las excepciones de uso, como ArgumentException, se siguen produciendo de forma sincrónica. Para ver las excepciones almacenadas, vea las excepciones producidas por Read(Byte[], Int32, Int32).

ReadAsync(Memory<Byte>, CancellationToken)

Source:

IsolatedStorageFileStream.cs

Copia bytes de forma asincrónica en un rango de memoria de bytes a partir del actual objeto IsolatedStorageFileStream almacenado en búfer.

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)

Parámetros

buffer

Memory<Byte>

El búfer en el que se escriben los datos.

cancellationToken

CancellationToken

Token para supervisar solicitudes de cancelación. El valor predeterminado es None.

Devoluciones

ValueTask<Int32>

Tarea que representa la operación de lectura asincrónica. Ajusta el número total de bytes leídos en buffer. Puede ser menor que el número de bytes solicitado si dicho número de bytes no está disponible en la actualidad, o cero si se alcanza el final de la secuencia.

Excepciones

OperationCanceledException

Se canceló el token de cancelación. Esta excepción se almacena en la tarea devuelta.