RandomAccess.WriteAsync Methode

Referenz

Definition

Namespace:: System.IO

Assembly:: System.Runtime.dll

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.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

Parameter

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

ValueTask

Eine Aufgabe, die den asynchronen Abschluss des Schreibvorgangs darstellt.

Ausnahmen

ArgumentNullException

handle oder buffers ist null.

ArgumentException

handle ist ungültig.

ObjectDisposedException

Die Datei ist geschlossen.

NotSupportedException

Die Datei unterstützt keine Suche (Pipe oder Socket).

ArgumentOutOfRangeException

fileOffset ist ein negativer Wert.

UnauthorizedAccessException

handle wurde nicht zum Schreiben geöffnet.

IOException

E/A-Fehler

OperationCanceledException

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.ValueTask

Public Shared Function WriteAsync (handle As SafeFileHandle, buffer As ReadOnlyMemory(Of Byte), fileOffset As Long, Optional cancellationToken As CancellationToken = Nothing) As ValueTask