Teilen über


File.WriteAllBytesAsync Methode

Definition

Überlädt

WriteAllBytesAsync(String, Byte[], CancellationToken)

Erstellt asynchron eine neue Datei, schreibt das angegebene Bytearray in die Datei und schließt dann die Datei. Wenn die Zieldatei bereits vorhanden ist, wird sie abgeschnitten und überschrieben.

WriteAllBytesAsync(String, ReadOnlyMemory<Byte>, CancellationToken)

Erstellt asynchron eine neue Datei, schreibt das angegebene Bytearray in die Datei und schließt dann die Datei. Wenn die Zieldatei bereits vorhanden ist, wird sie abgeschnitten und überschrieben.

WriteAllBytesAsync(String, Byte[], CancellationToken)

Quelle:
File.cs
Quelle:
File.cs
Quelle:
File.cs

Erstellt asynchron eine neue Datei, schreibt das angegebene Bytearray in die Datei und schließt dann die Datei. Wenn die Zieldatei bereits vorhanden ist, wird sie abgeschnitten und überschrieben.

public static System.Threading.Tasks.Task WriteAllBytesAsync (string path, byte[] bytes, System.Threading.CancellationToken cancellationToken = default);
static member WriteAllBytesAsync : string * byte[] * System.Threading.CancellationToken -> System.Threading.Tasks.Task
Public Shared Function WriteAllBytesAsync (path As String, bytes As Byte(), Optional cancellationToken As CancellationToken = Nothing) As Task

Parameter

path
String

Die Datei, in die geschrieben werden soll.

bytes
Byte[]

Die Bytes, die in die Datei geschrieben werden sollen.

cancellationToken
CancellationToken

Das Token, das auf Abbruchanforderungen überwacht werden soll. Der Standardwert ist None.

Gibt zurück

Eine Aufgabe, die den asynchronen Schreibvorgang darstellt.

Ausnahmen

Das Abbruchtoken wurde abgebrochen. Diese Ausnahme wird in der zurückgegebenen Aufgabe gespeichert.

Hinweise

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. Verwendungs exceptions, z. B. ArgumentException, werden weiterhin synchron ausgelöst. Informationen zu den gespeicherten Ausnahmen finden Sie in den von WriteAllBytes(String, Byte[])ausgelösten Ausnahmen.

Gilt für:

WriteAllBytesAsync(String, ReadOnlyMemory<Byte>, CancellationToken)

Erstellt asynchron eine neue Datei, schreibt das angegebene Bytearray in die Datei und schließt dann die Datei. Wenn die Zieldatei bereits vorhanden ist, wird sie abgeschnitten und überschrieben.

public static System.Threading.Tasks.Task WriteAllBytesAsync (string path, ReadOnlyMemory<byte> bytes, System.Threading.CancellationToken cancellationToken = default);
static member WriteAllBytesAsync : string * ReadOnlyMemory<byte> * System.Threading.CancellationToken -> System.Threading.Tasks.Task
Public Shared Function WriteAllBytesAsync (path As String, bytes As ReadOnlyMemory(Of Byte), Optional cancellationToken As CancellationToken = Nothing) As Task

Parameter

path
String

Die Datei, in die geschrieben werden soll.

bytes
ReadOnlyMemory<Byte>

Die Bytes, die in die Datei geschrieben werden sollen.

cancellationToken
CancellationToken

Das Token, das auf Abbruchanforderungen überwacht werden soll. Der Standardwert ist None.

Gibt zurück

Eine Aufgabe, die den asynchronen Schreibvorgang darstellt.

Ausnahmen

path ist null.

path ist leer.

Das Abbruchtoken wurde abgebrochen. Diese Ausnahme wird in der zurückgegebenen Aufgabe gespeichert.

Gilt für: