CryptoStream.WriteAsync Метод

Определение

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

System.Security.Cryptography

Сборки:

netstandard.dll, System.Security.Cryptography.dll

Перегрузки

Имя	Описание
WriteAsync(Byte[], Int32, Int32, CancellationToken)	Записывает последовательность байтов в текущий поток асинхронно, перемещает текущую позицию в потоке по количеству записанных байтов и отслеживает запросы на отмену.
WriteAsync(ReadOnlyMemory<Byte>, CancellationToken)	Асинхронно записывает последовательность байтов в текущий поток, перемещает текущую позицию в этом потоке по количеству записанных байтов и отслеживает запросы на отмену.

WriteAsync(Byte[], Int32, Int32, CancellationToken)

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

CryptoStream.cs

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

public:
 override System::Threading::Tasks::Task ^ WriteAsync(cli::array <System::Byte> ^ buffer, int offset, int count, System::Threading::CancellationToken cancellationToken);

public override System.Threading.Tasks.Task WriteAsync(byte[] buffer, int offset, int count, System.Threading.CancellationToken cancellationToken);

override this.WriteAsync : byte[] * int * int * System.Threading.CancellationToken -> System.Threading.Tasks.Task

Public Overrides Function WriteAsync (buffer As Byte(), offset As Integer, count As Integer, cancellationToken As CancellationToken) As Task

Параметры

buffer

Byte[]

Буфер для записи данных из.

offset

Int32

Отсчитываемое от нуля смещение buffer байтов, с которого начинается запись байтов в поток.

count

Int32

Максимальное число байтов для записи.

cancellationToken

CancellationToken

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

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

Task

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

Исключения

ArgumentNullException

buffer равно null.

ArgumentOutOfRangeException

offset или count отрицательный.

ArgumentException

offset Сумма и count больше длины буфера.

NotSupportedException

Поток не поддерживает запись.

ObjectDisposedException

Поток удален.

InvalidOperationException

Поток в настоящее время используется предыдущей операцией записи.

OperationCanceledException

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

Комментарии

Чтобы приостановить выполнение метода до завершения задачи, необходимо перед вызовом оператора WriteAsyncawait (C#) или Await (Visual Basic). Дополнительные сведения см. в статье асинхронное программирование (C#) или асинхронное программирование с помощью Async и Await (Visual Basic).

Если операция отменена до завершения, возвращаемая задача содержит Canceled значение свойства Status .

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

См. также раздел

• Отмена

WriteAsync(ReadOnlyMemory<Byte>, CancellationToken)

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

CryptoStream.cs

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

public override System.Threading.Tasks.ValueTask WriteAsync(ReadOnlyMemory<byte> buffer, System.Threading.CancellationToken cancellationToken = default);

override this.WriteAsync : ReadOnlyMemory<byte> * System.Threading.CancellationToken -> System.Threading.Tasks.ValueTask

Public Overrides Function WriteAsync (buffer As ReadOnlyMemory(Of Byte), Optional cancellationToken As CancellationToken = Nothing) As ValueTask

Параметры

buffer

ReadOnlyMemory<Byte>

Область памяти для записи данных из.

cancellationToken

CancellationToken

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

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

ValueTask

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

Исключения

NotSupportedException

Связанный CryptoStreamMode с текущим CryptoStream объектом объект не соответствует базовому потоку. Например, это исключение возникает при использовании Write только для базового потока, который доступен только для чтения.

OperationCanceledException

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