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

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

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

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

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

Параметры

handle

SafeFileHandle

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

buffer

ReadOnlyMemory<Byte>

Область памяти. Этот метод копирует содержимое этого региона в файл.

fileOffset

Int64

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

cancellationToken

CancellationToken

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

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

ValueTask

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

Исключения

ArgumentNullException

handle равно null.

ArgumentException

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

ObjectDisposedException

Файл закрыт.

NotSupportedException

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

ArgumentOutOfRangeException

fileOffset отрицательно.

UnauthorizedAccessException

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

IOException

Произошла ошибка ввода-вывода.

OperationCanceledException

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

Комментарии

Позиция файла не расширена.