RandomAccess.Read Metodo

Definizione

Spazio dei nomi:

System.IO

Assembly:

System.Runtime.dll

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

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

Int64

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

ArgumentNullException

handle o buffers è null.

ArgumentException

handle non è valido.

ObjectDisposedException

Il file viene chiuso.

NotSupportedException

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

ArgumentOutOfRangeException

fileOffset è negativo.

UnauthorizedAccessException

handle non è stato aperto per la lettura.

IOException

Si è verificato un errore di I/O.

Commenti

La posizione del file non è avanzata.

Read(SafeFileHandle, Span<Byte>, Int64)

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

Int32

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

ArgumentNullException

handle è null.

ArgumentException

handle non è valido.

ObjectDisposedException

Il file viene chiuso.

NotSupportedException

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

ArgumentOutOfRangeException

fileOffset è negativo.

UnauthorizedAccessException

handle non è stato aperto per la lettura.

IOException

Si è verificato un errore di I/O.

Commenti

La posizione del file non è avanzata.