RandomAccess.Read Método

Referencia

Definición

Espacio de nombres:: System.IO

Ensamblado:: System.Runtime.dll

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

Read(SafeFileHandle, IReadOnlyList<Memory<Byte>>, Int64)	Lee una secuencia de bytes del archivo especificado en un desplazamiento determinado.
Read(SafeFileHandle, Span<Byte>, Int64)	Lee una secuencia de bytes del archivo especificado en un desplazamiento determinado.

Read(SafeFileHandle, IReadOnlyList<Memory<Byte>>, Int64)

Source:: RandomAccess.cs

Source:: RandomAccess.cs

Source:: RandomAccess.cs

Lee una secuencia de bytes del archivo especificado en un desplazamiento determinado.

public:
 static long Read(Microsoft::Win32::SafeHandles::SafeFileHandle ^ handle, System::Collections::Generic::IReadOnlyList<Memory<System::Byte>> ^ buffers, long fileOffset);

public static long Read (Microsoft.Win32.SafeHandles.SafeFileHandle handle, System.Collections.Generic.IReadOnlyList<Memory<byte>> buffers, long fileOffset);

static member Read : Microsoft.Win32.SafeHandles.SafeFileHandle * System.Collections.Generic.IReadOnlyList<Memory<byte>> * int64 -> int64

Public Shared Function Read (handle As SafeFileHandle, buffers As IReadOnlyList(Of Memory(Of Byte)), fileOffset As Long) As Long

Parámetros

handle: SafeFileHandle

Manipulador de archivo.

buffers: IReadOnlyList<Memory<Byte>>

Lista de búferes de memoria. Cuando este método vuelve, el contenido de los búferes se reemplaza por los bytes leídos del archivo.

fileOffset: Int64

Posición del archivo desde la que se va a leer.

Devoluciones

Int64

Número total de bytes leídos en los búferes. Esto 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

ArgumentNullException

handle o buffers es null.

ArgumentException

handle no es válido.

ObjectDisposedException

El archivo se cierra.

NotSupportedException

El archivo no admite la búsqueda (canalización o socket).

ArgumentOutOfRangeException

fileOffset es negativo.

UnauthorizedAccessException

handle no se abrió para leer.

IOException

Error de E/S.

Comentarios

La posición del archivo no está avanzada.

Se aplica a

Read(SafeFileHandle, Span<Byte>, Int64)

Source:: RandomAccess.cs

Source:: RandomAccess.cs

Source:: RandomAccess.cs

Lee una secuencia de bytes del archivo especificado en un desplazamiento determinado.

public:
 static int Read(Microsoft::Win32::SafeHandles::SafeFileHandle ^ handle, Span<System::Byte> buffer, long fileOffset);

public static int Read (Microsoft.Win32.SafeHandles.SafeFileHandle handle, Span<byte> buffer, long fileOffset);

static member Read : Microsoft.Win32.SafeHandles.SafeFileHandle * Span<byte> * int64 -> int

Public Shared Function Read (handle As SafeFileHandle, buffer As Span(Of Byte), fileOffset As Long) As Integer

Parámetros

handle: SafeFileHandle

Manipulador de archivo.

buffer: Span<Byte>

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.

Devoluciones

Int32

Número total de bytes leídos en el búfer. Esto 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.