ClientWebSocket.SendAsync Method

Definition

Namespace:
System.Net.WebSockets
Assembly:
System.Net.WebSockets.Client.dll
Assembly:
System.dll
Assembly:
netstandard.dll

Overloads

SendAsync(ArraySegment<Byte>, WebSocketMessageType, Boolean, CancellationToken)

Sends data on ClientWebSocket as an asynchronous operation.
SendAsync(ReadOnlyMemory<Byte>, WebSocketMessageType, Boolean, CancellationToken)

Sends data on ClientWebSocket from a read-only byte memory range as an asynchronous operation.

SendAsync(ArraySegment<Byte>, WebSocketMessageType, Boolean, CancellationToken)

Sends data on ClientWebSocket as an asynchronous operation.

public:
 override System::Threading::Tasks::Task ^ SendAsync(ArraySegment<System::Byte> buffer, System::Net::WebSockets::WebSocketMessageType messageType, bool endOfMessage, System::Threading::CancellationToken cancellationToken);
public override System.Threading.Tasks.Task SendAsync (ArraySegment<byte> buffer, System.Net.WebSockets.WebSocketMessageType messageType, bool endOfMessage, System.Threading.CancellationToken cancellationToken);
override this.SendAsync : ArraySegment<byte> * System.Net.WebSockets.WebSocketMessageType * bool * System.Threading.CancellationToken -> System.Threading.Tasks.Task
Public Overrides Function SendAsync (buffer As ArraySegment(Of Byte), messageType As WebSocketMessageType, endOfMessage As Boolean, cancellationToken As CancellationToken) As Task

Parameters

buffer
ArraySegment<Byte>

The buffer containing the message to be sent.

messageType
WebSocketMessageType

One of the enumeration values that specifies whether the buffer is clear text or in a binary format.

endOfMessage
Boolean

true to indicate this is the final asynchronous send; otherwise, false.

cancellationToken
CancellationToken

A cancellation token used to propagate notification that this operation should be canceled.

Returns

Task

The task object representing the asynchronous operation.

Exceptions

InvalidOperationException

The ClientWebSocket is not connected.

ObjectDisposedException

The ClientWebSocket has been closed.

Remarks

This operation will not block. The returned Task object will complete after the send request on the ClientWebSocket instance has completed.

Exactly one send and one receive is supported on each ClientWebSocket object in parallel.

Applies to

SendAsync(ReadOnlyMemory<Byte>, WebSocketMessageType, Boolean, CancellationToken)

Sends data on ClientWebSocket from a read-only byte memory range as an asynchronous operation.

public:
 override System::Threading::Tasks::ValueTask SendAsync(ReadOnlyMemory<System::Byte> buffer, System::Net::WebSockets::WebSocketMessageType messageType, bool endOfMessage, System::Threading::CancellationToken cancellationToken);
public override System.Threading.Tasks.ValueTask SendAsync (ReadOnlyMemory<byte> buffer, System.Net.WebSockets.WebSocketMessageType messageType, bool endOfMessage, System.Threading.CancellationToken cancellationToken);
override this.SendAsync : ReadOnlyMemory<byte> * System.Net.WebSockets.WebSocketMessageType * bool * System.Threading.CancellationToken -> System.Threading.Tasks.ValueTask
Public Overrides Function SendAsync (buffer As ReadOnlyMemory(Of Byte), messageType As WebSocketMessageType, endOfMessage As Boolean, cancellationToken As CancellationToken) As ValueTask

Parameters

buffer
ReadOnlyMemory<Byte>

The region of memory containing the message to be sent.

messageType
WebSocketMessageType

One of the enumeration values that specifies whether the buffer is clear text or in a binary format.

endOfMessage
Boolean

true to indicate this is the final asynchronous send; otherwise, false.

cancellationToken
CancellationToken

A cancellation token used to propagate notification that this operation should be canceled.

Returns

ValueTask

The task object representing the asynchronous operation.

Exceptions

InvalidOperationException

The ClientWebSocket is not connected.

ObjectDisposedException

The ClientWebSocket has been closed.

Remarks

This operation will not block. The returned Task object will complete after the send request on the ClientWebSocket instance has completed.

Exactly one send and one receive is supported on each ClientWebSocket object in parallel.

Applies to