Condividi tramite


RandomAccess.Read Metodo

Definizione

Overload

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

Legge una sequenza di byte dal file specificato in corrispondenza dell'offset specificato.

Read(SafeFileHandle, Span<Byte>, Int64)

Legge una sequenza di byte dal file specificato in corrispondenza dell'offset specificato.

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

Origine:
RandomAccess.cs
Origine:
RandomAccess.cs
Origine:
RandomAccess.cs

Legge una sequenza di byte dal file specificato in corrispondenza dell'offset specificato.

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

Parametri

handle
SafeFileHandle

Handle di file.

buffers
IReadOnlyList<Memory<Byte>>

Elenco dei buffer di memoria. Quando questo metodo restituisce, il contenuto dei buffer viene sostituito dai byte letti dal file.

fileOffset
Int64

Posizione del file da cui leggere.

Restituisce

Numero totale di byte letti nei buffer. Ciò può essere minore del numero di byte allocati nei buffer se tale numero di byte non è attualmente disponibile o zero (0) se la fine del file è stata raggiunta.

Eccezioni

handle o buffers è null.

handle non è valido.

Il file viene chiuso.

Il file non supporta la ricerca (pipe o socket).

fileOffset è negativo.

handle non è stato aperto per la lettura.

Si è verificato un errore di I/O.

Commenti

La posizione del file non è avanzata.

Si applica a

Read(SafeFileHandle, Span<Byte>, Int64)

Origine:
RandomAccess.cs
Origine:
RandomAccess.cs
Origine:
RandomAccess.cs

Legge una sequenza di byte dal file specificato in corrispondenza dell'offset specificato.

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

Parametri

handle
SafeFileHandle

Handle di file.

buffer
Span<Byte>

Un'area di memoria. Quando questo metodo restituisce, il contenuto di questa area viene sostituito dai byte letti dal file.

fileOffset
Int64

Posizione del file da cui leggere.

Restituisce

Numero complessivo di byte letti nel buffer. Questo può essere minore del numero di byte allocati nel buffer se tale numero di byte non è attualmente disponibile o zero (0) se la fine del file è stata raggiunta.

Eccezioni

handle è null.

handle non è valido.

Il file viene chiuso.

Il file non supporta la ricerca (pipe o socket).

fileOffset è negativo.

handle non è stato aperto per la lettura.

Si è verificato un errore di I/O.

Commenti

La posizione del file non è avanzata.

Si applica a