Поделиться через


File.WriteAllBytesAsync Метод

Определение

Перегрузки

WriteAllBytesAsync(String, Byte[], CancellationToken)

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

WriteAllBytesAsync(String, ReadOnlyMemory<Byte>, CancellationToken)

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

WriteAllBytesAsync(String, Byte[], CancellationToken)

Исходный код:
File.cs
Исходный код:
File.cs
Исходный код:
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.

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

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

Исключения

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

Комментарии

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

Применяется к

WriteAllBytesAsync(String, ReadOnlyMemory<Byte>, CancellationToken)

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

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

Параметры

path
String

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

bytes
ReadOnlyMemory<Byte>

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

cancellationToken
CancellationToken

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

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

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

Исключения

path пуст.

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

Применяется к