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
| Name | Beschreibung |
|---|---|
| WriteAsync(SafeFileHandle, IReadOnlyList<ReadOnlyMemory<Byte>>, Int64, CancellationToken) |
Schreibt eine Abfolge von Bytes aus bestimmten Puffern in die angegebene Datei bei einem bestimmten Offset. |
| WriteAsync(SafeFileHandle, ReadOnlyMemory<Byte>, Int64, CancellationToken) |
Schreibt eine Abfolge von Bytes aus dem angegebenen Puffer in die angegebene Datei bei einem bestimmten Offset. |
WriteAsync(SafeFileHandle, IReadOnlyList<ReadOnlyMemory<Byte>>, Int64, CancellationToken)
- Quelle:
- RandomAccess.cs
- Quelle:
- RandomAccess.cs
- Quelle:
- RandomAccess.cs
- Quelle:
- RandomAccess.cs
- Quelle:
- RandomAccess.cs
Schreibt eine Abfolge von Bytes 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 der Speicherpuffer. Diese Methode kopiert den Inhalt dieser Puffer in die Datei.
- fileOffset
- Int64
Die Dateiposition, in die geschrieben werden soll. In .NET 11 und höheren Versionen wird dieser Parameter für Dateien ignoriert, die die Suche nicht unterstützen, z. B. Rohre, Sockets und Zeichengeräte. Der Wert muss auch dann nicht negativ sein, wenn er ignoriert wird.
- cancellationToken
- CancellationToken
Das Token, das auf Abbruchanforderungen überwacht werden soll. 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 wird geschlossen.
In .NET 10 und früheren Versionen unterstützt die Datei die Suche nicht (z. B. eine Pipe oder einen Socket).
fileOffset ist negativ.
handle wurde nicht zum Schreiben geöffnet.
Ein E/A-Fehler ist aufgetreten.
Das Abbruchtoken wurde abgebrochen. Diese Ausnahme wird in der zurückgegebenen Aufgabe gespeichert.
Hinweise
Bei Dateien, die die Suche unterstützen, ist die Dateiposition nicht erweitert.
Diese Methode speichert in der Aufgabe, die alle Nicht-Verwendungs-Ausnahmen zurückgibt, die das synchrone Gegenstück 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, z. B. ArgumentException, werden weiterhin synchron ausgelöst. Informationen zu den gespeicherten Ausnahmen finden Sie in den von Write(SafeFileHandle, IReadOnlyList<ReadOnlyMemory<Byte>>, Int64).
Gilt für:
WriteAsync(SafeFileHandle, ReadOnlyMemory<Byte>, Int64, CancellationToken)
- Quelle:
- RandomAccess.cs
- Quelle:
- RandomAccess.cs
- Quelle:
- RandomAccess.cs
- Quelle:
- RandomAccess.cs
- Quelle:
- RandomAccess.cs
Schreibt eine Abfolge von Bytes aus dem angegebenen Puffer in die angegebene Datei bei einem bestimmten 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 Speicherbereich. Diese Methode kopiert den Inhalt dieses Bereichs in die Datei.
- fileOffset
- Int64
Die Dateiposition, in die geschrieben werden soll. In .NET 11 und höheren Versionen wird dieser Parameter für Dateien ignoriert, die die Suche nicht unterstützen, z. B. Rohre, Sockets und Zeichengeräte. Der Wert muss auch dann nicht negativ sein, wenn er ignoriert wird.
- cancellationToken
- CancellationToken
Das Token, das auf Abbruchanforderungen überwacht werden soll. 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 wird geschlossen.
In .NET 10 und früheren Versionen unterstützt die Datei die Suche nicht (z. B. eine Pipe oder einen Socket).
fileOffset ist negativ.
handle wurde nicht zum Schreiben geöffnet.
Ein E/A-Fehler ist aufgetreten.
Das Abbruchtoken wurde abgebrochen. Diese Ausnahme wird in der zurückgegebenen Aufgabe gespeichert.
Hinweise
Bei Dateien, die die Suche unterstützen, ist die Dateiposition nicht erweitert.
