RandomAccess.WriteAsync Methode
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Überlädt
| WriteAsync(SafeFileHandle, IReadOnlyList<ReadOnlyMemory<Byte>>, Int64, CancellationToken) |
Schreibt eine Bytesequenz aus bestimmten Puffern in die angegebene Datei bei einem bestimmten Offset. |
| WriteAsync(SafeFileHandle, ReadOnlyMemory<Byte>, Int64, CancellationToken) |
Schreibt eine Bytesequenz aus dem angegebenen Puffer in die angegebene Datei am angegebenen Offset. |
WriteAsync(SafeFileHandle, IReadOnlyList<ReadOnlyMemory<Byte>>, Int64, CancellationToken)
- Quelle:
- RandomAccess.cs
- Quelle:
- RandomAccess.cs
- Quelle:
- RandomAccess.cs
Schreibt eine Bytesequenz aus bestimmten Puffern in die angegebene Datei bei einem bestimmten Offset.
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 ValueTaskParameter
- handle
- SafeFileHandle
Das Dateihandle.
- buffers
- IReadOnlyList<ReadOnlyMemory<Byte>>
Eine Liste von Speicherpuffern. Diese Methode kopiert den Inhalt dieser Puffer in die Datei.
- fileOffset
- Int64
Die Dateiposition, in die geschrieben werden soll.
- cancellationToken
- CancellationToken
Das Token zum Überwachen von Abbruchanforderungen. Der Standardwert ist None.
Gibt zurück
Eine Aufgabe, die den asynchronen Abschluss des Schreibvorgangs darstellt.
Ausnahmen
handle oder buffers ist null.
handle ist ungültig.
Die Datei ist geschlossen.
Die Datei unterstützt keine Suche (Pipe oder Socket).
fileOffset ist ein negativer Wert.
handle wurde nicht zum Schreiben geöffnet.
E/A-Fehler
Das Abbruchtoken wurde abgebrochen. Diese Ausnahme wird in der zurückgegebenen Aufgabe gespeichert.
Hinweise
Die Position der Datei ist nicht erweitert.
Diese Methode speichert in der Aufgabe, die alle Nichtverwendungsausnahmen zurückgibt, die die synchrone Entsprechung der Methode auslösen kann. Wenn eine Ausnahme in der zurückgegebenen Aufgabe gespeichert wird, wird diese Ausnahme ausgelöst, wenn die Aufgabe erwartet wird. Verwendungsausnahmen wie ArgumentExceptionwerden weiterhin synchron ausgelöst. Informationen zu den gespeicherten Ausnahmen finden Sie unter ausnahmen, die von ausgelöst werden Write(SafeFileHandle, IReadOnlyList<ReadOnlyMemory<Byte>>, Int64).
Gilt für:
WriteAsync(SafeFileHandle, ReadOnlyMemory<Byte>, Int64, CancellationToken)
- Quelle:
- RandomAccess.cs
- Quelle:
- RandomAccess.cs
- Quelle:
- RandomAccess.cs
Schreibt eine Bytesequenz aus dem angegebenen Puffer in die angegebene Datei am angegebenen Offset.
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 ValueTaskParameter
- handle
- SafeFileHandle
Das Dateihandle.
- buffer
- ReadOnlyMemory<Byte>
Ein Bereich im Arbeitsspeicher. Diese Methode kopiert den Inhalt dieses Bereichs in die Datei.
- fileOffset
- Int64
Die Dateiposition, in die geschrieben werden soll.
- cancellationToken
- CancellationToken
Das Token zum Überwachen von Abbruchanforderungen. Der Standardwert ist None.
Gibt zurück
Eine Aufgabe, die den asynchronen Abschluss des Schreibvorgangs darstellt.
Ausnahmen
handle ist null.
handle ist ungültig.
Die Datei ist geschlossen.
Die Datei unterstützt keine Suche (Pipe oder Socket).
fileOffset ist ein negativer Wert.
handle wurde nicht zum Schreiben geöffnet.
E/A-Fehler
Das Abbruchtoken wurde abgebrochen. Diese Ausnahme wird in der zurückgegebenen Aufgabe gespeichert.
Hinweise
Die Position der Datei ist nicht erweitert.
