Auf Englisch lesen

Freigeben über


WebSocket.ReceiveAsync Methode

Definition

Überlädt

ReceiveAsync(ArraySegment<Byte>, CancellationToken)

Empfängt Daten asynchron von der WebSocket-Verbindung.

ReceiveAsync(Memory<Byte>, CancellationToken)

Empfängt Daten asynchron von der WebSocket-Verbindung.

ReceiveAsync(ArraySegment<Byte>, CancellationToken)

Quelle:
WebSocket.cs
Quelle:
WebSocket.cs
Quelle:
WebSocket.cs

Empfängt Daten asynchron von der WebSocket-Verbindung.

C#
public abstract System.Threading.Tasks.Task<System.Net.WebSockets.WebSocketReceiveResult> ReceiveAsync(ArraySegment<byte> buffer, System.Threading.CancellationToken cancellationToken);

Parameter

buffer
ArraySegment<Byte>

Verweist auf den Anwendungspuffer, der der Speicherort für die empfangenen Daten ist.

cancellationToken
CancellationToken

Gibt die Benachrichtigung darüber weiter, dass Vorgänge abgebrochen werden sollen.

Gibt zurück

Das Aufgabenobjekt, das den asynchronen Vorgang darstellt. Die Result-Eigenschaft im Task-Objekt gibt ein WebSocketReceiveResult Objekt zurück, das die empfangenen Daten darstellt.

Ausnahmen

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

Hinweise

Dieser Vorgang wird nicht blockiert. Das zurückgegebene Task<TResult> Objekt wird abgeschlossen, nachdem die Daten für WebSocketempfangen wurden.

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

Gilt für:

.NET 10 und andere Versionen
Produkt Versionen
.NET Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9, 10
.NET Framework 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 2.0, 2.1

ReceiveAsync(Memory<Byte>, CancellationToken)

Quelle:
WebSocket.cs
Quelle:
WebSocket.cs
Quelle:
WebSocket.cs

Empfängt Daten asynchron von der WebSocket-Verbindung.

C#
public virtual System.Threading.Tasks.ValueTask<System.Net.WebSockets.ValueWebSocketReceiveResult> ReceiveAsync(Memory<byte> buffer, System.Threading.CancellationToken cancellationToken);

Parameter

buffer
Memory<Byte>

Der Anwendungspuffer, der den Speicherort für die empfangenen Daten darstellt.

cancellationToken
CancellationToken

Das Abbruchtoken zum Abbrechen des Empfangsvorgangs.

Gibt zurück

Das Aufgabenobjekt, das den asynchronen Vorgang darstellt. Die Result-Eigenschaft im Task-Objekt gibt ein ValueWebSocketReceiveResult Objekt zurück, das die empfangenen Daten darstellt.

Ausnahmen

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

Gilt für:

.NET 10 und andere Versionen
Produkt Versionen
.NET Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9, 10
.NET Standard 2.1