RandomAccess.ReadAsync 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
| ReadAsync(SafeFileHandle, IReadOnlyList<Memory<Byte>>, Int64, CancellationToken) |
Legge una sequenza di byte dal file specificato in corrispondenza dell'offset specificato. |
| ReadAsync(SafeFileHandle, Memory<Byte>, Int64, CancellationToken) |
Legge una sequenza di byte dal file specificato in corrispondenza dell'offset specificato. |
ReadAsync(SafeFileHandle, IReadOnlyList<Memory<Byte>>, Int64, CancellationToken)
- Origine:
- RandomAccess.cs
- Origine:
- RandomAccess.cs
- Origine:
- RandomAccess.cs
Legge una sequenza di byte dal file specificato in corrispondenza dell'offset specificato.
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)Parametri
- handle
- SafeFileHandle
Handle di file.
- buffers
- IReadOnlyList<Memory<Byte>>
Elenco di buffer di memoria. Quando termina, il contenuto di questi buffer viene sostituito dai byte letti dal file.
- fileOffset
- Int64
Posizione del file da cui leggere.
- cancellationToken
- CancellationToken
Token da monitorare per le richieste di annullamento. Il valore predefinito è None.
Restituisce
Numero totale di byte letti nei buffer. Può essere minore del numero di byte allocati nei buffer se il numero di byte non è attualmente disponibile oppure zero (0) se è stata raggiunta la fine del file.
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.
Il token di annullamento è stato annullato. Questa eccezione viene archiviata nell'attività restituita.
Commenti
La posizione del file non è avanzata.
Questo metodo archivia nell'attività restituisce tutte le eccezioni non di utilizzo che la controparte sincrona del metodo può generare. Se un'eccezione viene archiviata nell'attività restituita, tale eccezione verrà generata quando l'attività è attesa. Le eccezioni di utilizzo, ad esempio ArgumentException, vengono comunque generate in modo sincrono. Per le eccezioni archiviate, vedere le eccezioni generate da Read(SafeFileHandle, IReadOnlyList<Memory<Byte>>, Int64).
Si applica a
ReadAsync(SafeFileHandle, Memory<Byte>, Int64, CancellationToken)
- Origine:
- RandomAccess.cs
- Origine:
- RandomAccess.cs
- Origine:
- RandomAccess.cs
Legge una sequenza di byte dal file specificato in corrispondenza dell'offset specificato.
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)Parametri
- handle
- SafeFileHandle
Handle di file.
Un'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.
- cancellationToken
- CancellationToken
Token da monitorare per le richieste di annullamento. Il valore predefinito è None.
Restituisce
Numero complessivo di byte letti nel buffer. Può essere inferiore al numero di byte allocati nel buffer se tale numero di byte non è attualmente disponibile oppure zero (0) se è stata raggiunta la fine del file.
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.
Il token di annullamento è stato annullato. Questa eccezione viene archiviata nell'attività restituita.
Commenti
La posizione del file non è avanzata.
