RandomAccess.Read Metodo
Definizione
Importante
Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.
Overload
| Nome | Descrizione |
|---|---|
| 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
- 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 -> int64Public Shared Function Read (handle As SafeFileHandle, buffers As IReadOnlyList(Of Memory(Of Byte)), fileOffset As Long) As LongParametri
- handle
- SafeFileHandle
Handle di file.
- buffers
- IReadOnlyList<Memory<Byte>>
Elenco di buffer di memoria. Quando termina, il contenuto dei buffer viene sostituito dai byte letti dal file.
- fileOffset
- Int64
Posizione del file da cui leggere. In .NET 11 e versioni successive questo parametro viene ignorato per i file che non supportano la ricerca, ad esempio pipe, socket e dispositivi carattere. Il valore deve essere non negativo anche quando viene ignorato.
Valori restituiti
Numero totale di byte letti nei buffer. Può essere minore del numero di byte allocati nei buffer se molti byte non sono attualmente disponibili oppure zero (0) se è stata raggiunta la fine del file.
Eccezioni
handle o buffers è null.
handle non è valido.
Il file è chiuso.
In .NET 10 e versioni precedenti, il file non supporta la ricerca (ad esempio, una pipe o un socket).
fileOffset è negativo.
handle non è stato aperto per la lettura.
Si è verificato un errore di I/O.
Commenti
Per i file che supportano la ricerca, la posizione del file non è avanzata.
Si applica a
Read(SafeFileHandle, Span<Byte>, Int64)
- Origine:
- RandomAccess.cs
- Origine:
- RandomAccess.cs
- 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 -> intPublic Shared Function Read (handle As SafeFileHandle, buffer As Span(Of Byte), fileOffset As Long) As IntegerParametri
- handle
- SafeFileHandle
Handle di file.
Area di memoria. Quando termina, il contenuto di questa area viene sostituito dai byte letti dal file.
- fileOffset
- Int64
Posizione del file da cui leggere. In .NET 11 e versioni successive questo parametro viene ignorato per i file che non supportano la ricerca, ad esempio pipe, socket e dispositivi carattere. Il valore deve essere non negativo anche quando viene ignorato.
Valori restituiti
Numero totale di byte letti nel buffer. Può essere minore del numero di byte allocati nel buffer se molti byte non sono attualmente disponibili oppure zero (0) se è stata raggiunta la fine del file.
Eccezioni
handle è null.
handle non è valido.
Il file è chiuso.
In .NET 10 e versioni precedenti, il file non supporta la ricerca (ad esempio, una pipe o un socket).
fileOffset è negativo.
handle non è stato aperto per la lettura.
Si è verificato un errore di I/O.
Commenti
Per i file che supportano la ricerca, la posizione del file non è avanzata.
