RandomAccess.WriteAsync Metodo

Riferimento

Definizione

Spazio dei nomi:: System.IO

Assembly:: System.Runtime.dll

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

WriteAsync(SafeFileHandle, IReadOnlyList<ReadOnlyMemory<Byte>>, Int64, CancellationToken)	Scrive una sequenza di byte dai buffer specificati in un determinato file in corrispondenza dell'offset specificato.
WriteAsync(SafeFileHandle, ReadOnlyMemory<Byte>, Int64, CancellationToken)	Scrive una sequenza di byte dal buffer specificato al file specificato in corrispondenza dell'offset specificato.

WriteAsync(SafeFileHandle, IReadOnlyList<ReadOnlyMemory<Byte>>, Int64, CancellationToken)

Origine:: RandomAccess.cs

Origine:: RandomAccess.cs

Origine:: RandomAccess.cs

Scrive una sequenza di byte dai buffer specificati in un determinato file in corrispondenza dell'offset specificato.

public static System.Threading.Tasks.ValueTask WriteAsync (Microsoft.Win32.SafeHandles.SafeFileHandle handle, System.Collections.Generic.IReadOnlyList<ReadOnlyMemory<byte>> buffers, long fileOffset, System.Threading.CancellationToken cancellationToken = default);

static member WriteAsync : Microsoft.Win32.SafeHandles.SafeFileHandle * System.Collections.Generic.IReadOnlyList<ReadOnlyMemory<byte>> * int64 * System.Threading.CancellationToken -> System.Threading.Tasks.ValueTask

Public Shared Function WriteAsync (handle As SafeFileHandle, buffers As IReadOnlyList(Of ReadOnlyMemory(Of Byte)), fileOffset As Long, Optional cancellationToken As CancellationToken = Nothing) As ValueTask

Parametri

handle: SafeFileHandle

Handle di file.

buffers: IReadOnlyList<ReadOnlyMemory<Byte>>

Elenco di buffer di memoria. Questo metodo copia il contenuto di questi buffer nel file.

fileOffset: Int64

Posizione del file in cui scrivere.

cancellationToken: CancellationToken

Token da monitorare per le richieste di annullamento. Il valore predefinito è None.

Restituisce

ValueTask

Attività che rappresenta il completamento asincrono dell'operazione di scrittura.

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 scrittura.

IOException

Si è verificato un errore di I/O.

OperationCanceledException

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 Write(SafeFileHandle, IReadOnlyList<ReadOnlyMemory<Byte>>, Int64).

Si applica a

WriteAsync(SafeFileHandle, ReadOnlyMemory<Byte>, Int64, CancellationToken)

Origine:: RandomAccess.cs

Origine:: RandomAccess.cs

Origine:: RandomAccess.cs

Scrive una sequenza di byte dal buffer specificato al file specificato in corrispondenza dell'offset specificato.

public static System.Threading.Tasks.ValueTask WriteAsync (Microsoft.Win32.SafeHandles.SafeFileHandle handle, ReadOnlyMemory<byte> buffer, long fileOffset, System.Threading.CancellationToken cancellationToken = default);

static member WriteAsync : Microsoft.Win32.SafeHandles.SafeFileHandle * ReadOnlyMemory<byte> * int64 * System.Threading.CancellationToken -> System.Threading.Tasks.ValueTask

Public Shared Function WriteAsync (handle As SafeFileHandle, buffer As ReadOnlyMemory(Of Byte), fileOffset As Long, Optional cancellationToken As CancellationToken = Nothing) As ValueTask