File.WriteAllBytesAsync Metoda

Definicja

Namespace:

System.IO

Zestawów:

netstandard.dll, System.Runtime.dll

Przeciążenia

Nazwa	Opis
WriteAllBytesAsync(String, Byte[], CancellationToken)	Asynchronicznie tworzy nowy plik, zapisuje określoną tablicę bajtów w pliku, a następnie zamyka plik. Jeśli plik docelowy już istnieje, zostanie obcięty i zastąpiony.
WriteAllBytesAsync(String, ReadOnlyMemory<Byte>, CancellationToken)	Asynchronicznie tworzy nowy plik, zapisuje określoną tablicę bajtów w pliku, a następnie zamyka plik. Jeśli plik docelowy już istnieje, zostanie obcięty i zastąpiony.

WriteAllBytesAsync(String, Byte[], CancellationToken)

Źródło:

File.cs

Asynchronicznie tworzy nowy plik, zapisuje określoną tablicę bajtów w pliku, a następnie zamyka plik. Jeśli plik docelowy już istnieje, zostanie obcięty i zastąpiony.

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

Parametry

path

String

Plik do zapisu.

bytes

Byte[]

Bajty do zapisu w pliku.

cancellationToken

CancellationToken

Token do monitorowania żądań anulowania. Wartość domyślna to None.

Zwraca

Task

Zadanie reprezentujące operację zapisu asynchronicznego.

Wyjątki

OperationCanceledException

Token anulowania został anulowany. Ten wyjątek jest przechowywany w zwracanym zadaniu.

Uwagi

Ta metoda przechowuje w zadaniu zwraca wszystkie wyjątki inne niż użycie, które może zgłosić synchroniczna odpowiednik metody. Jeśli wyjątek jest przechowywany w zwróconym zadaniu, ten wyjątek zostanie zgłoszony, gdy zadanie będzie oczekiwać. Wyjątki użycia, takie jak ArgumentException, są nadal zgłaszane synchronicznie. W przypadku przechowywanych wyjątków zobacz wyjątki zgłaszane przez WriteAllBytes(String, Byte[]).

WriteAllBytesAsync(String, ReadOnlyMemory<Byte>, CancellationToken)

Źródło:

File.cs

Asynchronicznie tworzy nowy plik, zapisuje określoną tablicę bajtów w pliku, a następnie zamyka plik. Jeśli plik docelowy już istnieje, zostanie obcięty i zastąpiony.

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

Parametry

path

String

Plik do zapisu.

bytes

ReadOnlyMemory<Byte>

Bajty do zapisu w pliku.

cancellationToken

CancellationToken

Token do monitorowania żądań anulowania. Wartość domyślna to None.

Zwraca

Task

Zadanie reprezentujące operację zapisu asynchronicznego.

Wyjątki

ArgumentNullException

path jest null.

ArgumentException

path jest pusta.

OperationCanceledException

Token anulowania został anulowany. Ten wyjątek jest przechowywany w zwracanym zadaniu.