MessageWebSocket.MessageReceived Ereignis

Definition

Namespace:

Windows.Networking.Sockets

Ein Ereignis, das angibt, dass eine Nachricht für das MessageWebSocket-Objekt empfangen wurde.

// Register
event_token MessageReceived(TypedEventHandler<MessageWebSocket, MessageWebSocketMessageReceivedEventArgs const&> const& handler) const;

// Revoke with event_token
void MessageReceived(event_token const* cookie) const;

// Revoke with event_revoker
MessageWebSocket::MessageReceived_revoker MessageReceived(auto_revoke_t, TypedEventHandler<MessageWebSocket, MessageWebSocketMessageReceivedEventArgs const&> const& handler) const;

public event TypedEventHandler<MessageWebSocket,MessageWebSocketMessageReceivedEventArgs> MessageReceived;

function onMessageReceived(eventArgs) { /* Your code */ }
messageWebSocket.addEventListener("messagereceived", onMessageReceived);
messageWebSocket.removeEventListener("messagereceived", onMessageReceived);
- or -
messageWebSocket.onmessagereceived = onMessageReceived;

Public Custom Event MessageReceived As TypedEventHandler(Of MessageWebSocket, MessageWebSocketMessageReceivedEventArgs) 

Ereignistyp

TypedEventHandler<MessageWebSocket,MessageWebSocketMessageReceivedEventArgs>

Hinweise

Alle Nachrichtenverarbeitungs- und Verbindungsfehler werden über die Methoden GetDataReader und GetDataStream übermittelt. Wenn eine dieser Methoden eine Ausnahme auslöst, gibt dies an, dass entweder die zugrunde liegende Verbindung unterbrochen ist oder der Server ungültige Daten gesendet hat, z. B. beschädigte HTTP-Header oder eine Nachricht, die die maximale Nachrichtengröße überschreitet. Die geeignete Aktion, die Ihr Code angesichts einer Ausnahme von diesen Methoden ergreifen muss, besteht darin, einen bekannten guten Zustand wiederherzustellen, indem Sie das Websocket schließen, ein neues erstellen und eine Verbindung mit dem Server herstellen.

Alle MessageReceived-Ereignishandler müssen registriert werden, bevor ConnectAsync aufgerufen wird. Danach schlägt der Versuch, einen MessageReceived-Ereignishandler hinzuzufügen oder zu entfernen, mit E_ILLEGAL_METHOD_CALL fehl, auch wenn der Socket geschlossen wurde.

Eine leere Nachricht führt dazu, dass GetDataReader einen gültigen IDataReader-instance zurückgibt, wobei UnconsumedBufferLength auf 0 festgelegt ist. GetDataStream gibt einen gültigen IInputStream-instance zurück, der null Bytes ergibt.