Socket.SendAsync Метод

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

Socket.Tasks.cs

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

Socket.Tasks.cs

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

Socket.Tasks.cs

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

member this.SendAsync : ReadOnlyMemory<byte> * System.Threading.CancellationToken -> System.Threading.Tasks.ValueTask<int>

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

Параметры

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

Асинхронная задача, которая завершается числом отправленных байтов.

Исключения

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

Socket.Tasks.cs

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

Socket.Tasks.cs

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

Socket.Tasks.cs

public:
 System::Threading::Tasks::Task<int> ^ SendAsync(System::Collections::Generic::IList<ArraySegment<System::Byte>> ^ buffers, System::Net::Sockets::SocketFlags socketFlags);

public System.Threading.Tasks.Task<int> SendAsync (System.Collections.Generic.IList<ArraySegment<byte>> buffers, System.Net.Sockets.SocketFlags socketFlags);

member this.SendAsync : System.Collections.Generic.IList<ArraySegment<byte>> * System.Net.Sockets.SocketFlags -> System.Threading.Tasks.Task<int>

Public Function SendAsync (buffers As IList(Of ArraySegment(Of Byte)), socketFlags As SocketFlags) As Task(Of Integer)

Параметры

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

Асинхронная задача, которая завершается числом отправленных байтов.

Исключения

Комментарии

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

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

Socket.Tasks.cs

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

Socket.Tasks.cs

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

Socket.Tasks.cs

public:
 System::Threading::Tasks::Task<int> ^ SendAsync(ArraySegment<System::Byte> buffer, System::Net::Sockets::SocketFlags socketFlags);

public System.Threading.Tasks.Task<int> SendAsync (ArraySegment<byte> buffer, System.Net.Sockets.SocketFlags socketFlags);

member this.SendAsync : ArraySegment<byte> * System.Net.Sockets.SocketFlags -> System.Threading.Tasks.Task<int>

Public Function SendAsync (buffer As ArraySegment(Of Byte), socketFlags As SocketFlags) As Task(Of Integer)

Параметры

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

Асинхронная задача, которая завершается числом отправленных байтов.

Исключения

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

Socket.Tasks.cs

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

Socket.Tasks.cs

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

Socket.Tasks.cs

public System.Threading.Tasks.ValueTask<int> SendAsync (ReadOnlyMemory<byte> buffer, System.Net.Sockets.SocketFlags socketFlags, System.Threading.CancellationToken cancellationToken = default);

member this.SendAsync : ReadOnlyMemory<byte> * System.Net.Sockets.SocketFlags * System.Threading.CancellationToken -> System.Threading.Tasks.ValueTask<int>

Public Function SendAsync (buffer As ReadOnlyMemory(Of Byte), socketFlags As SocketFlags, Optional cancellationToken As CancellationToken = Nothing) As ValueTask(Of Integer)

Параметры

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

Асинхронная задача, которая завершается числом отправленных байтов.

Исключения

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

Socket.Tasks.cs

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

Socket.Tasks.cs

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

Socket.Tasks.cs

public:
 System::Threading::Tasks::Task<int> ^ SendAsync(System::Collections::Generic::IList<ArraySegment<System::Byte>> ^ buffers);

public System.Threading.Tasks.Task<int> SendAsync (System.Collections.Generic.IList<ArraySegment<byte>> buffers);

member this.SendAsync : System.Collections.Generic.IList<ArraySegment<byte>> -> System.Threading.Tasks.Task<int>

Public Function SendAsync (buffers As IList(Of ArraySegment(Of Byte))) As Task(Of Integer)

Параметры

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

Асинхронная задача, которая завершается числом отправленных байтов.

Исключения

Комментарии

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

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

Socket.Tasks.cs

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

Socket.Tasks.cs

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

Socket.Tasks.cs

public:
 System::Threading::Tasks::Task<int> ^ SendAsync(ArraySegment<System::Byte> buffer);

public System.Threading.Tasks.Task<int> SendAsync (ArraySegment<byte> buffer);

member this.SendAsync : ArraySegment<byte> -> System.Threading.Tasks.Task<int>

Public Function SendAsync (buffer As ArraySegment(Of Byte)) As Task(Of Integer)

Параметры

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

Асинхронная задача, которая завершается числом отправленных байтов.

Исключения

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

Socket.cs

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

Socket.cs

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

Socket.cs

public:
 bool SendAsync(System::Net::Sockets::SocketAsyncEventArgs ^ e);

public bool SendAsync (System.Net.Sockets.SocketAsyncEventArgs e);

member this.SendAsync : System.Net.Sockets.SocketAsyncEventArgs -> bool

Public Function SendAsync (e As SocketAsyncEventArgs) As Boolean

Параметры

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

true, если операция ввода-вывода находится в состоянии ожидания. По завершении операции создается событие Completed в параметре e.

false, если операция ввода-вывода завершена синхронно. В данном случае событие Completed на параметре e не будет создано и объект e, передаваемый как параметр, можно изучить сразу после получения результатов вызова метода для извлечения результатов операции.

Исключения

Комментарии

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

Метод SendAsync запускает асинхронную операцию отправки на удаленный узел, установленный в методе Accept, AcceptAsync, BeginAccept, BeginConnect, Connectили ConnectAsync .

Для успешного System.Net.Sockets.SocketAsyncEventArgs вызова этого метода требуются следующие свойства и события объекта :

• SocketAsyncEventArgs.Buffer или SocketAsyncEventArgs.BufferList

• SocketAsyncEventArgs.Count Значение , если SocketAsyncEventArgs.Buffer задано значение

• SocketAsyncEventArgs.Offset Значение , если SocketAsyncEventArgs.Buffer задано значение

• SocketAsyncEventArgs.Completed

Вызывающий объект может задать SocketAsyncEventArgs.UserToken для свойства любой объект пользовательского состояния, требуемый перед вызовом SendAsync метода , чтобы данные можно было получить в методе обратного вызова. Если для обратного вызова требуется больше сведений, чем для одного объекта, можно создать небольшой класс для хранения других необходимых сведений о состоянии в качестве членов.

Метод вызовет исключение, если вы не вызываете SendAsyncAccept, AcceptAsync, BeginAcceptBeginConnect, Connectили ConnectAsync.

SendAsync Вызов метода позволяет отправлять данные в отдельном потоке выполнения.

Для сокетов, ориентированных на сообщения, не следует превышать максимальный размер сообщения базового поставщика службы сокетов Windows. Если данные слишком длинные для атомарной передачи через базовый поставщик служб, данные не передаются и SendAsync метод выдает с SocketAsyncEventArgs.SocketError набором SocketException собственный код ошибки Winsock WSAEMSGSIZE (10040).

Обратите внимание, что успешное SendAsync завершение метода не означает, что данные были успешно доставлены.

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

• SocketAsyncEventArgs
• Buffer
• BufferList
• Completed
• Count
• Offset
• UserToken