NetworkStream.WriteAsync Метод

Определение

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

System.Net.Sockets

Сборки:

netstandard.dll, System.Net.Sockets.dll

Перегрузки

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

WriteAsync(ReadOnlyMemory<Byte>, CancellationToken)

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

NetworkStream.cs

Записывает данные NetworkStream в диапазон памяти только для чтения в виде асинхронной операции.

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>

Область памяти, содержащая данные для записи в NetworkStream.

cancellationToken

CancellationToken

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

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

ValueTask

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

Исключения

InvalidOperationException

Запись NetworkStream не поддерживается.

IOException

При доступе к сокету произошла ошибка.

–или–

Во время записи в сеть произошел сбой.

ObjectDisposedException

NetworkStream закрыт.

OperationCanceledException

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

Комментарии

Этот метод отправляет все байты в buffer сеть.

Note

Проверьте, является ли NetworkStream запись доступной CanWrite для записи путем вызова свойства. Если вы пытаетесь написать NetworkStream в недоступную запись, вы получите InvalidOperationException.

Note

Если вы получаете IOExceptionсвойство, проверьте InnerException , было ли оно вызвано SocketException. В этом случае используйте свойство ErrorCode для получения определенного кода ошибки и ознакомьтесь с документацией по коду ошибки Windows Sockets версии 2 API для подробного описания ошибки.

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

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

NetworkStream.cs

Записывает данные NetworkStream в указанный диапазон массива байтов в виде асинхронной операции.

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[]

Массив байтов, содержащий данные для записи в NetworkStream.

offset

Int32

Расположение, в buffer котором начинается запись данных.

count

Int32

Число байтов для записи в NetworkStream.

cancellationToken

CancellationToken

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

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

Task

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

Исключения

ArgumentNullException

Параметр buffer имеет значение null.

ArgumentOutOfRangeException

Параметр offset меньше 0.

–или–

Параметр offset больше длины buffer.

–или–

Параметр size меньше 0.

–или–

Параметр size больше длины buffer минус значение offset параметра.

InvalidOperationException

Запись NetworkStream не поддерживается.

IOException

Во время записи в сеть произошел сбой.

–или–

При доступе к сокету произошла ошибка.

ObjectDisposedException

NetworkStream закрыт.

OperationCanceledException

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

Комментарии

Этот метод начинается с указанного offset и отправляет count байты из содержимого buffer сети.

Note

Проверьте, является ли NetworkStream запись доступной CanWrite для записи путем вызова свойства. Если вы пытаетесь написать NetworkStream в недоступную запись, вы получите InvalidOperationException.

Note

Если вы получаете IOExceptionсвойство, проверьте InnerException , было ли оно вызвано SocketException. В этом случае используйте свойство ErrorCode для получения определенного кода ошибки и ознакомьтесь с документацией по коду ошибки Windows Sockets версии 2 API для подробного описания ошибки.

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