RandomAccess.WriteAsync Метод

Ссылка

Определение

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

Сборка:: System.Runtime.dll

Важно!

Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.

Перегрузки

WriteAsync(SafeFileHandle, IReadOnlyList<ReadOnlyMemory<Byte>>, Int64, CancellationToken)	Записывает последовательность байтов из заданных буферов в заданный файл с заданным смещением.
WriteAsync(SafeFileHandle, ReadOnlyMemory<Byte>, Int64, CancellationToken)	Записывает последовательность байтов из заданного буфера в заданный файл с заданным смещением.

WriteAsync(SafeFileHandle, IReadOnlyList<ReadOnlyMemory<Byte>>, Int64, CancellationToken)

Исходный код:: RandomAccess.cs

Исходный код:: RandomAccess.cs

Исходный код:: RandomAccess.cs

Записывает последовательность байтов из заданных буферов в заданный файл с заданным смещением.

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

Параметры

handle: SafeFileHandle

Дескриптор файла.

buffers: IReadOnlyList<ReadOnlyMemory<Byte>>

Список буферов памяти. Этот метод копирует содержимое этих буферов в файл.

fileOffset: Int64

Позиция файла для записи.

cancellationToken: CancellationToken

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

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

ValueTask

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

Исключения

ArgumentNullException

Параметр handle или buffers имеет значение null.

ArgumentException

handle недопустим.

ObjectDisposedException

Файл закрыт.

NotSupportedException

Файл не поддерживает поиск (канал или сокет).

ArgumentOutOfRangeException

fileOffset является отрицательным значением.

UnauthorizedAccessException

handle не был открыт для написания.

IOException

Ошибка ввода/вывода.

OperationCanceledException

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

Этот метод сохраняет в задаче все исключения, не относящиеся к использованию, которые может создавать синхронный аналог метода. Если исключение сохраняется в возвращаемой задаче, это исключение будет создано при ожидании задачи. Исключения использования, такие как ArgumentException, по-прежнему создаются синхронно. Хранимые исключения см. в разделе исключения, создаваемые Write(SafeFileHandle, IReadOnlyList<ReadOnlyMemory<Byte>>, Int64).

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

WriteAsync(SafeFileHandle, ReadOnlyMemory<Byte>, Int64, CancellationToken)

Исходный код:: RandomAccess.cs

Исходный код:: RandomAccess.cs

Исходный код:: RandomAccess.cs

Записывает последовательность байтов из заданного буфера в заданный файл с заданным смещением.

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