File.WriteAllBytesAsync Метод

Определение

Пространство имен:

System.IO

Сборка:

System.Runtime.dll

Перегрузки

WriteAllBytesAsync(String, Byte[], CancellationToken)

Асинхронно создает новый файл, записывает указанный массив байтов в файл, а затем закрывает файл. Если целевой файл уже существует, он усечен и перезаписан.

WriteAllBytesAsync(String, Byte[], CancellationToken)

Исходный код:

File.cs

Асинхронно создает новый файл, записывает указанный массив байтов в файл, а затем закрывает файл. Если целевой файл уже существует, он усечен и перезаписан.

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

Параметры

path

String

Файл для записи.

bytes

Byte[]

Байты для записи в файл.

cancellationToken

CancellationToken

Маркер для отслеживания запросов на отмену. Значение по умолчанию — None.

Возвращаемое значение

Task

Задача, представляющая асинхронную операцию записи.

Исключения

OperationCanceledException

Маркер отмены был отменен. Это исключение хранится в возвращаемой задаче.

Комментарии

Этот метод сохраняет в задаче все исключения без использования, которые может вызывать синхронный аналог метода. Если исключение хранится в возвращаемой задаче, это исключение будет создано при ожидании задачи. Исключения использования, такие как ArgumentException, по-прежнему создаются синхронно. Сведения о сохраненных исключениях см. в исключениях, создаваемых WriteAllBytes(String, Byte[]).