MessageWebSocket.MessageReceived Evento
Definizione
Importante
Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.
Evento che indica che un messaggio è stato ricevuto nell'oggetto MessageWebSocket .
// 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) Tipo evento
Commenti
Tutti gli errori correlati all'elaborazione e alla connessione dei messaggi vengono comunicati tramite i metodi GetDataReader e GetDataStream . Se uno di questi metodi genera un'eccezione, indica che la connessione sottostante è interrotta o il server ha inviato dati non validi, ad esempio intestazioni HTTP danneggiate o un messaggio che supera le dimensioni massime del messaggio. L'azione appropriata per il codice da eseguire a fronte di un'eccezione da questi metodi consiste nel riavviare uno stato valido noto chiudendo il websocket, creando uno nuovo e riconnettendosi al server.
Tutti i gestori eventi MessageReceived devono essere registrati prima di chiamare ConnectAsync . In seguito, il tentativo di aggiungere o rimuovere un gestore eventi MessageReceived avrà esito negativo con E_ILLEGAL_METHOD_CALL, anche dopo la chiusura del socket
Un messaggio vuoto restituisce un'istanza di IDataReader valida con UnconsumedBufferLength impostata su 0. GetDataStream restituisce un'istanza IInputStream valida che restituisce zero byte.