ClientWebSocket.SendAsync Methode

Definition

Namespace:

System.Net.WebSockets

Assembly:

System.Net.WebSockets.Client.dll

Überlädt

SendAsync(ArraySegment<Byte>, WebSocketMessageType, Boolean, CancellationToken)	Sendet Daten in der ClientWebSocket-Klasse als asynchronen Vorgang.
SendAsync(ReadOnlyMemory<Byte>, WebSocketMessageType, Boolean, CancellationToken)	Sendet Daten in der ClientWebSocket-Klasse eines schreibgeschützten Bytespeicherbereichs als asynchronen Vorgang.
SendAsync(ReadOnlyMemory<Byte>, WebSocketMessageType, WebSocketMessageFlags, CancellationToken)	Sendet Daten in der ClientWebSocket-Klasse eines schreibgeschützten Bytespeicherbereichs als asynchronen Vorgang.

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

Quelle:

ClientWebSocket.cs

Sendet Daten in der ClientWebSocket-Klasse als asynchronen Vorgang.

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

Parameter

buffer

ArraySegment<Byte>

Der Puffer mit der zu sendenden Nachricht.

messageType

WebSocketMessageType

Einer der Enumerationswerte, der angibt, ob der Puffer Klartext enthält oder auf ein binäres Format hinweist.

endOfMessage

Boolean

true, um anzugeben, dass dies der letzte asynchrone Sendevorgang ist; sonst false.

cancellationToken

CancellationToken

Ein Abbruchtoken, mit dem die Benachrichtigung verteilt wird, dass dieser Vorgang abgebrochen werden muss.

Gibt zurück

Task

Das Aufgabenobjekt, das den asynchronen Vorgang darstellt.

Ausnahmen

InvalidOperationException

Die ClientWebSocket-Klasse ist nicht verbunden.

ObjectDisposedException

Der ClientWebSocket wurde geschlossen.

OperationCanceledException

Das Abbruchtoken wurde abgebrochen. Diese Ausnahme wird in der zurückgegebenen Aufgabe gespeichert.

Hinweise

Dieser Vorgang wird nicht blockiert. Das zurückgegebene Task Objekt wird abgeschlossen, nachdem die Sendeanforderung für die ClientWebSocket instance abgeschlossen wurde.

Genau ein Senden und ein Empfang wird für jedes ClientWebSocket Objekt parallel unterstützt. Das Gleichzeitige Ausstellen mehrerer Senden wird nicht unterstützt und führt zu einem nicht definierten Verhalten. Sie sollten Sendevorgänge über den für Sie am besten geeigneten Mechanismus serialisieren, z. B. mithilfe einer Sperre oder eines Semaphors.

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

Quelle:

ClientWebSocket.cs

Sendet Daten in der ClientWebSocket-Klasse eines schreibgeschützten Bytespeicherbereichs als asynchronen Vorgang.

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

Parameter

buffer

ReadOnlyMemory<Byte>

Der Speicherbereich, der die zu sendende Nachricht enthält.

messageType

WebSocketMessageType

Einer der Enumerationswerte, der angibt, ob der Puffer Klartext enthält oder auf ein binäres Format hinweist.

endOfMessage

Boolean

true, um anzugeben, dass dies der letzte asynchrone Sendevorgang ist; sonst false.

cancellationToken

CancellationToken

Ein Abbruchtoken, mit dem die Benachrichtigung verteilt wird, dass dieser Vorgang abgebrochen werden muss.

Gibt zurück

ValueTask

Das Aufgabenobjekt, das den asynchronen Vorgang darstellt.

Ausnahmen

InvalidOperationException

Die ClientWebSocket-Klasse ist nicht verbunden.

ObjectDisposedException

Der ClientWebSocket wurde geschlossen.

OperationCanceledException

Das Abbruchtoken wurde abgebrochen. Diese Ausnahme wird in der zurückgegebenen Aufgabe gespeichert.

Hinweise

Dieser Vorgang wird nicht blockiert. Das zurückgegebene Task Objekt wird abgeschlossen, nachdem die Sendeanforderung für die ClientWebSocket instance abgeschlossen wurde.

Genau ein Senden und ein Empfang wird für jedes ClientWebSocket Objekt parallel unterstützt. Das Gleichzeitige Ausstellen mehrerer Senden wird nicht unterstützt und führt zu einem nicht definierten Verhalten. Sie sollten Sendevorgänge über den für Sie am besten geeigneten Mechanismus serialisieren, z. B. mithilfe einer Sperre oder eines Semaphors.

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

Quelle:

ClientWebSocket.cs

Sendet Daten in der ClientWebSocket-Klasse eines schreibgeschützten Bytespeicherbereichs als asynchronen Vorgang.

public:
 override System::Threading::Tasks::ValueTask SendAsync(ReadOnlyMemory<System::Byte> buffer, System::Net::WebSockets::WebSocketMessageType messageType, System::Net::WebSockets::WebSocketMessageFlags messageFlags, System::Threading::CancellationToken cancellationToken);

public override System.Threading.Tasks.ValueTask SendAsync (ReadOnlyMemory<byte> buffer, System.Net.WebSockets.WebSocketMessageType messageType, System.Net.WebSockets.WebSocketMessageFlags messageFlags, System.Threading.CancellationToken cancellationToken);

override this.SendAsync : ReadOnlyMemory<byte> * System.Net.WebSockets.WebSocketMessageType * System.Net.WebSockets.WebSocketMessageFlags * System.Threading.CancellationToken -> System.Threading.Tasks.ValueTask

Public Overrides Function SendAsync (buffer As ReadOnlyMemory(Of Byte), messageType As WebSocketMessageType, messageFlags As WebSocketMessageFlags, cancellationToken As CancellationToken) As ValueTask

Parameter

buffer

ReadOnlyMemory<Byte>

Der Speicherbereich, der die zu sendende Nachricht enthält.

messageType

WebSocketMessageType

Einer der Enumerationswerte, der angibt, ob der Puffer Klartext enthält oder auf ein binäres Format hinweist.

messageFlags

WebSocketMessageFlags

Eine bitweise Kombination der Enumerationswerte, die angibt, wie die Nachricht gesendet wird.

cancellationToken

CancellationToken

Ein Abbruchtoken, mit dem die Benachrichtigung verteilt wird, dass dieser Vorgang abgebrochen werden muss.

Gibt zurück

ValueTask

Das Aufgabenobjekt, das den asynchronen Vorgang darstellt.

Ausnahmen

OperationCanceledException

Das Abbruchtoken wurde abgebrochen. Diese Ausnahme wird in der zurückgegebenen Aufgabe gespeichert.

Hinweise

Dieser Vorgang wird nicht blockiert. Das zurückgegebene Task Objekt wird abgeschlossen, nachdem die Sendeanforderung für die ClientWebSocket instance abgeschlossen wurde.

Genau ein Senden und ein Empfang wird für jedes ClientWebSocket Objekt parallel unterstützt. Das Gleichzeitige Ausstellen mehrerer Senden wird nicht unterstützt und führt zu einem nicht definierten Verhalten. Sie sollten Sendevorgänge über den für Sie am besten geeigneten Mechanismus serialisieren, z. B. mithilfe einer Sperre oder eines Semaphors.