RandomAccess.WriteAsync Método
Definición
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
| Nombre | Description |
|---|---|
| WriteAsync(SafeFileHandle, IReadOnlyList<ReadOnlyMemory<Byte>>, Int64, CancellationToken) |
Escribe una secuencia de bytes de 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
- Source:
- RandomAccess.cs
- Source:
- RandomAccess.cs
Escribe una secuencia de bytes de 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.ValueTaskPublic Shared Function WriteAsync (handle As SafeFileHandle, buffers As IReadOnlyList(Of ReadOnlyMemory(Of Byte)), fileOffset As Long, Optional cancellationToken As CancellationToken = Nothing) As ValueTaskPará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 que se va a supervisar para las solicitudes de cancelación. El valor por defecto es None.
Devoluciones
Tarea que representa la finalización asincrónica de la operación de escritura.
Excepciones
handle o buffers es null.
handle no es válido.
El archivo está cerrado.
El archivo no admite la búsqueda (canalización o socket).
fileOffset es negativo.
handle no se abrió para escribir.
Error de E/S.
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 de no 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, todavía se producen sincrónicamente. Para las excepciones almacenadas, consulte las excepciones producidas por Write(SafeFileHandle, IReadOnlyList<ReadOnlyMemory<Byte>>, Int64).
Se aplica a
WriteAsync(SafeFileHandle, ReadOnlyMemory<Byte>, Int64, CancellationToken)
- Source:
- RandomAccess.cs
- Source:
- RandomAccess.cs
- 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.ValueTaskPublic Shared Function WriteAsync (handle As SafeFileHandle, buffer As ReadOnlyMemory(Of Byte), fileOffset As Long, Optional cancellationToken As CancellationToken = Nothing) As ValueTaskParámetros
- handle
- SafeFileHandle
Manipulador de archivo.
- buffer
- ReadOnlyMemory<Byte>
Una región de memoria. Este método copia el contenido de esta región en el archivo.
- fileOffset
- Int64
Posición del archivo en la que se va a escribir.
- cancellationToken
- CancellationToken
Token que se va a supervisar para las solicitudes de cancelación. El valor por defecto es None.
Devoluciones
Tarea que representa la finalización asincrónica de la operación de escritura.
Excepciones
handle es null.
handle no es válido.
El archivo está cerrado.
El archivo no admite la búsqueda (canalización o socket).
fileOffset es negativo.
handle no se abrió para escribir.
Error de E/S.
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.
