Partager via


RandomAccess.WriteAsync Méthode

Définition

Surcharges

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

Écrit une séquence d’octets de mémoires tampons données dans un fichier donné à un décalage donné.

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

Écrit une séquence d’octets de la mémoire tampon donnée dans un fichier donné à un décalage donné.

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

Source:
RandomAccess.cs
Source:
RandomAccess.cs
Source:
RandomAccess.cs

Écrit une séquence d’octets de mémoires tampons données dans un fichier donné à un décalage donné.

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

Paramètres

handle
SafeFileHandle

Handle de fichier.

buffers
IReadOnlyList<ReadOnlyMemory<Byte>>

Liste des mémoires tampons. Cette méthode copie le contenu de ces mémoires tampons dans le fichier.

fileOffset
Int64

Position de fichier dans laquelle écrire.

cancellationToken
CancellationToken

Jeton pour surveiller les requêtes d'annulation. La valeur par défaut est None.

Retours

Tâche représentant l’achèvement asynchrone de l’opération d’écriture.

Exceptions

handle ou buffers est null.

handle n'est pas valide.

Le fichier est fermé.

Le fichier ne prend pas en charge la recherche (canal ou socket).

fileOffset est un nombre négatif.

handle n’a pas été ouvert pour écriture.

Une erreur d'E/S s'est produite.

Le jeton d’annulation a été annulé. Cette exception est stockée dans la tâche retournée.

Remarques

La position du fichier n’est pas avancée.

Cette méthode stocke dans la tâche toutes les exceptions de non-utilisation que le équivalent synchrone de la méthode peut lever. Si une exception est stockée dans la tâche retournée, cette exception est levée lorsque la tâche est attendue. Les exceptions d’utilisation, telles que ArgumentException, sont toujours levées de manière synchrone. Pour les exceptions stockées, consultez les exceptions levées par Write(SafeFileHandle, IReadOnlyList<ReadOnlyMemory<Byte>>, Int64).

S’applique à

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

Source:
RandomAccess.cs
Source:
RandomAccess.cs
Source:
RandomAccess.cs

Écrit une séquence d’octets de la mémoire tampon donnée dans un fichier donné à un décalage donné.

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

Paramètres

handle
SafeFileHandle

Handle de fichier.

buffer
ReadOnlyMemory<Byte>

Région de la mémoire. Cette méthode copie le contenu de cette région dans le fichier.

fileOffset
Int64

Position de fichier dans laquelle écrire.

cancellationToken
CancellationToken

Jeton pour surveiller les requêtes d'annulation. La valeur par défaut est None.

Retours

Tâche représentant l’achèvement asynchrone de l’opération d’écriture.

Exceptions

handle a la valeur null.

handle n'est pas valide.

Le fichier est fermé.

Le fichier ne prend pas en charge la recherche (canal ou socket).

fileOffset est un nombre négatif.

handle n’a pas été ouvert pour écriture.

Une erreur d'E/S s'est produite.

Le jeton d’annulation a été annulé. Cette exception est stockée dans la tâche retournée.

Remarques

La position du fichier n’est pas avancée.

S’applique à