RandomAccess.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(SafeFileHandle, IReadOnlyList<Memory<Byte>>, Int64, CancellationToken) |
Lee una secuencia de bytes del archivo especificado en un desplazamiento determinado. |
| ReadAsync(SafeFileHandle, Memory<Byte>, Int64, CancellationToken) |
Lee una secuencia de bytes del archivo especificado en un desplazamiento determinado. |
ReadAsync(SafeFileHandle, IReadOnlyList<Memory<Byte>>, Int64, CancellationToken)
- Source:
- RandomAccess.cs
- Source:
- RandomAccess.cs
- Source:
- RandomAccess.cs
- Source:
- RandomAccess.cs
- Source:
- RandomAccess.cs
Lee una secuencia de bytes del archivo especificado en un desplazamiento determinado.
public static System.Threading.Tasks.ValueTask<long> ReadAsync(Microsoft.Win32.SafeHandles.SafeFileHandle handle, System.Collections.Generic.IReadOnlyList<Memory<byte>> buffers, long fileOffset, System.Threading.CancellationToken cancellationToken = default);static member ReadAsync : Microsoft.Win32.SafeHandles.SafeFileHandle * System.Collections.Generic.IReadOnlyList<Memory<byte>> * int64 * System.Threading.CancellationToken -> System.Threading.Tasks.ValueTask<int64>Public Shared Function ReadAsync (handle As SafeFileHandle, buffers As IReadOnlyList(Of Memory(Of Byte)), fileOffset As Long, Optional cancellationToken As CancellationToken = Nothing) As ValueTask(Of Long)Parámetros
- handle
- SafeFileHandle
Identificador de archivo.
- buffers
- IReadOnlyList<Memory<Byte>>
Lista de búferes de memoria. Cuando este método devuelve, el contenido de estos búferes se reemplaza por los bytes leídos del archivo.
- fileOffset
- Int64
Posición del archivo desde la que se va a leer. En .NET 11 y versiones posteriores, este parámetro se omite para los archivos que no admiten búsquedas, como canalizaciones, sockets y dispositivos de caracteres. El valor debe ser no negativo incluso cuando se omite.
- cancellationToken
- CancellationToken
Token que se va a supervisar para las solicitudes de cancelación. El valor por defecto es None.
Devoluciones
Número total de bytes leídos en los búferes. Puede ser menor que el número de bytes asignados en los búferes si no hay muchos bytes disponibles actualmente o cero (0) si se ha alcanzado el final del archivo.
Excepciones
handle o buffers es null.
handle no es válido.
El archivo está cerrado.
En .NET 10 y versiones anteriores, el archivo no admite la búsqueda (por ejemplo, una canalización o un socket).
fileOffset es negativo.
handle no se abrió para leer.
Error de E/S.
Se canceló el token de cancelación. Esta excepción se almacena en la tarea devuelta.
Comentarios
En el caso de los archivos que admiten la búsqueda, la posición del archivo no es avanzada.
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(SafeFileHandle, IReadOnlyList<Memory<Byte>>, Int64).
Se aplica a
ReadAsync(SafeFileHandle, Memory<Byte>, Int64, CancellationToken)
- Source:
- RandomAccess.cs
- Source:
- RandomAccess.cs
- Source:
- RandomAccess.cs
- Source:
- RandomAccess.cs
- Source:
- RandomAccess.cs
Lee una secuencia de bytes del archivo especificado en un desplazamiento determinado.
public static System.Threading.Tasks.ValueTask<int> ReadAsync(Microsoft.Win32.SafeHandles.SafeFileHandle handle, Memory<byte> buffer, long fileOffset, System.Threading.CancellationToken cancellationToken = default);static member ReadAsync : Microsoft.Win32.SafeHandles.SafeFileHandle * Memory<byte> * int64 * System.Threading.CancellationToken -> System.Threading.Tasks.ValueTask<int>Public Shared Function ReadAsync (handle As SafeFileHandle, buffer As Memory(Of Byte), fileOffset As Long, Optional cancellationToken As CancellationToken = Nothing) As ValueTask(Of Integer)Parámetros
- handle
- SafeFileHandle
Identificador de archivo.
Una región de memoria. Cuando este método devuelve, el contenido de esta región se reemplaza por los bytes leídos del archivo.
- fileOffset
- Int64
Posición del archivo desde la que se va a leer. En .NET 11 y versiones posteriores, este parámetro se omite para los archivos que no admiten búsquedas, como canalizaciones, sockets y dispositivos de caracteres. El valor debe ser no negativo incluso cuando se omite.
- cancellationToken
- CancellationToken
Token que se va a supervisar para las solicitudes de cancelación. El valor por defecto es None.
Devoluciones
Número total de bytes leídos en el búfer. Puede ser menor que el número de bytes asignados en el búfer si no hay muchos bytes disponibles actualmente o cero (0) si se ha alcanzado el final del archivo.
Excepciones
handle es null.
handle no es válido.
El archivo está cerrado.
En .NET 10 y versiones anteriores, el archivo no admite la búsqueda (por ejemplo, una canalización o un socket).
fileOffset es negativo.
handle no se abrió para leer.
Error de E/S.
Se canceló el token de cancelación. Esta excepción se almacena en la tarea devuelta.
Comentarios
En el caso de los archivos que admiten la búsqueda, la posición del archivo no es avanzada.
