RandomAccess.WriteAsync Méthode
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
Surcharges
| Nom | Description |
|---|---|
| WriteAsync(SafeFileHandle, IReadOnlyList<ReadOnlyMemory<Byte>>, Int64, CancellationToken) |
Écrit une séquence d’octets provenant de mémoires tampons données dans un fichier donné au 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é au décalage donné. |
WriteAsync(SafeFileHandle, IReadOnlyList<ReadOnlyMemory<Byte>>, Int64, CancellationToken)
- Source:
- RandomAccess.cs
- Source:
- RandomAccess.cs
- Source:
- RandomAccess.cs
- Source:
- RandomAccess.cs
- Source:
- RandomAccess.cs
Écrit une séquence d’octets provenant de mémoires tampons données dans un fichier donné au 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.ValueTaskPublic Shared Function WriteAsync (handle As SafeFileHandle, buffers As IReadOnlyList(Of ReadOnlyMemory(Of Byte)), fileOffset As Long, Optional cancellationToken As CancellationToken = Nothing) As ValueTaskParamètres
- handle
- SafeFileHandle
Handle de fichier.
- buffers
- IReadOnlyList<ReadOnlyMemory<Byte>>
Liste des mémoires tampons de mémoire. Cette méthode copie le contenu de ces mémoires tampons dans le fichier.
- fileOffset
- Int64
Position du fichier dans laquelle écrire. Dans .NET versions 11 et ultérieures, ce paramètre est ignoré pour les fichiers qui ne prennent pas en charge la recherche, tels que les canaux, les sockets et les périphériques de caractères. La valeur doit être non négative même lorsqu’elle est ignorée.
- cancellationToken
- CancellationToken
Jeton à surveiller pour les demandes 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é.
Dans .NET versions 10 et antérieures, le fichier ne prend pas en charge la recherche (par exemple, un canal ou un socket).
fileOffset est négatif.
handle n’a pas été ouvert pour l’é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
Pour les fichiers qui prennent en charge la recherche, la position du fichier n’est pas avancée.
Cette méthode stocke dans la tâche toutes les exceptions non-utilisation que l’é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 façon 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
- Source:
- RandomAccess.cs
- Source:
- RandomAccess.cs
Écrit une séquence d’octets de la mémoire tampon donnée dans un fichier donné au 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.ValueTaskPublic Shared Function WriteAsync (handle As SafeFileHandle, buffer As ReadOnlyMemory(Of Byte), fileOffset As Long, Optional cancellationToken As CancellationToken = Nothing) As ValueTaskParamètres
- handle
- SafeFileHandle
Handle de fichier.
- buffer
- ReadOnlyMemory<Byte>
Une région de mémoire. Cette méthode copie le contenu de cette région dans le fichier.
- fileOffset
- Int64
Position du fichier dans laquelle écrire. Dans .NET versions 11 et ultérieures, ce paramètre est ignoré pour les fichiers qui ne prennent pas en charge la recherche, tels que les canaux, les sockets et les périphériques de caractères. La valeur doit être non négative même lorsqu’elle est ignorée.
- cancellationToken
- CancellationToken
Jeton à surveiller pour les demandes 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é.
Dans .NET versions 10 et antérieures, le fichier ne prend pas en charge la recherche (par exemple, un canal ou un socket).
fileOffset est négatif.
handle n’a pas été ouvert pour l’é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
Pour les fichiers qui prennent en charge la recherche, la position du fichier n’est pas avancée.
