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.
- 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.
Die Datei unterstützt nicht die Suche (Pipe oder 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
Die Position der Datei ist 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.
- 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.
Die Datei unterstützt nicht die Suche (Pipe oder 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
Die Position der Datei ist nicht erweitert.
