IsolatedStorageFileStream.ReadAsync Método
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
Sobrecargas
| Nombre | Description |
|---|---|
| ReadAsync(Byte[], Int32, Int32, CancellationToken) |
Copia de forma asincrónica bytes del objeto almacenado en IsolatedStorageFileStream búfer actual en una matriz de bytes. |
| ReadAsync(Memory<Byte>, CancellationToken) |
Copia de forma asincrónica bytes del objeto almacenado en IsolatedStorageFileStream búfer actual en un intervalo de memoria de bytes. |
ReadAsync(Byte[], Int32, Int32, CancellationToken)
- Source:
- IsolatedStorageFileStream.cs
- Source:
- IsolatedStorageFileStream.cs
- Source:
- IsolatedStorageFileStream.cs
- Source:
- IsolatedStorageFileStream.cs
- Source:
- IsolatedStorageFileStream.cs
Copia de forma asincrónica bytes del objeto almacenado en IsolatedStorageFileStream búfer actual en una matriz de bytes.
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[]
Búfer en el que se van a escribir los datos.
- offset
- Int32
Desplazamiento en el búfer en el que se va a empezar a escribir.
- count
- Int32
Número máximo de bytes que se van a leer.
- cancellationToken
- CancellationToken
Token que se va a supervisar para las solicitudes de cancelación. El valor por defecto es None.
Devoluciones
Tarea que representa la operación de lectura asincrónica. Encapsula el número total de bytes leídos en .buffer Puede ser menor que el número de bytes solicitados si no hay muchos bytes disponibles actualmente, o cero si se alcanza el final de la secuencia.
Excepciones
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, SByte, CharInt16Int32, Int64UInt16UInt32, , UInt64, o . SingleDouble
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. Para buffer los parámetros que no sean matrices de bytes, esto significa que un índice de elemento o el número de elementos debe multiplicarse 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 devolverlo. 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 de no uso que puede producir el homólogo sincrónico del método. Si se almacena una excepción en la tarea devuelta, se producirá esa excepción cuando se espere la tarea. Las excepciones de uso, como ArgumentException, todavía se producen sincrónicamente. Para las excepciones almacenadas, consulte las excepciones producidas por Read(Byte[], Int32, Int32).
Se aplica a
ReadAsync(Memory<Byte>, CancellationToken)
- Source:
- IsolatedStorageFileStream.cs
- Source:
- IsolatedStorageFileStream.cs
- Source:
- IsolatedStorageFileStream.cs
- Source:
- IsolatedStorageFileStream.cs
- Source:
- IsolatedStorageFileStream.cs
Copia de forma asincrónica bytes del objeto almacenado en IsolatedStorageFileStream búfer actual en un intervalo de memoria de bytes.
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
- cancellationToken
- CancellationToken
Token que se va a supervisar para las solicitudes de cancelación. El valor por defecto es None.
Devoluciones
Tarea que representa la operación de lectura asincrónica. Encapsula el número total de bytes leídos en .buffer Puede ser menor que el número de bytes solicitados si no hay muchos bytes disponibles actualmente, o cero si se alcanza el final de la secuencia.
Excepciones
Se canceló el token de cancelación. Esta excepción se almacena en la tarea devuelta.