RandomAccess.WriteAsync Método

Referencia

Definición

Espacio de nombres:: System.IO

Ensamblado:: System.Runtime.dll

Importante

Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.

Sobrecargas

WriteAsync(SafeFileHandle, IReadOnlyList<ReadOnlyMemory<Byte>>, Int64, CancellationToken)	Escribe una secuencia de bytes de los búferes especificados en un archivo determinado en un desplazamiento determinado.
WriteAsync(SafeFileHandle, ReadOnlyMemory<Byte>, Int64, CancellationToken)	Escribe una secuencia de bytes del búfer especificado en un archivo determinado en un desplazamiento determinado.

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

Source:: RandomAccess.cs

Source:: RandomAccess.cs

Source:: RandomAccess.cs

Escribe una secuencia de bytes de los búferes especificados en un archivo determinado en un desplazamiento determinado.

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

Parámetros

handle: SafeFileHandle

Manipulador de archivo.

buffers: IReadOnlyList<ReadOnlyMemory<Byte>>

Lista de búferes de memoria. Este método copia el contenido de estos búferes en el archivo.

fileOffset: Int64

Posición del archivo en la que se va a escribir.

cancellationToken: CancellationToken

Token para supervisar solicitudes de cancelación. El valor predeterminado es None.

Devoluciones

ValueTask

Tarea que representa la finalización asincrónica de la operación de escritura.

Excepciones

ArgumentNullException

handle o buffers es null.

ArgumentException

handle no es válido.

ObjectDisposedException

El archivo se cierra.

NotSupportedException

El archivo no admite la búsqueda (canalización o socket).

ArgumentOutOfRangeException

fileOffset es negativo.

UnauthorizedAccessException

handle no se abrió para escribir.

IOException

Error de E/S.

OperationCanceledException

Se canceló el token de cancelación. Esta excepción se almacena en la tarea devuelta.

Comentarios

La posición del archivo no está avanzada.

Este método almacena en la tarea que devuelve todas las excepciones que no son de uso que puede producir el homólogo sincrónico del método. Si se almacena una excepción en la tarea devuelta, se producirá esa excepción cuando se espere la tarea. Las excepciones de uso, como ArgumentException, se siguen iniciando de forma sincrónica. Para ver las excepciones almacenadas, consulte las excepciones producidas por Write(SafeFileHandle, IReadOnlyList<ReadOnlyMemory<Byte>>, Int64).

Se aplica a

.NET 9 y otras versiones

Producto	Versiones
.NET	6, 7, 8, 9

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

Source:: RandomAccess.cs

Source:: RandomAccess.cs

Source:: RandomAccess.cs

Escribe una secuencia de bytes del búfer especificado en un archivo determinado en un desplazamiento determinado.

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