MessageWebSocket.MessageReceived Evento
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
Um evento que indica que uma mensagem foi recebida no objeto 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 de evento
Comentários
Todos os erros relacionados ao processamento de mensagens e à conexão são comunicados por meio dos métodos GetDataReader e GetDataStream . Se um desses métodos gerar uma exceção, isso indicará que a conexão subjacente está quebrada ou o servidor enviou dados inválidos, como cabeçalhos HTTP corrompidos ou uma mensagem que excede o tamanho máximo da mensagem. A ação apropriada para que seu código tome em face de uma exceção desses métodos é restabelecer um bom estado conhecido fechando o websocket, criando um novo e reconectando-se ao servidor.
Todos os manipuladores de eventos MessageReceived devem ser registrados antes que ConnectAsync seja chamado. Depois disso, a tentativa de adicionar ou remover um manipulador de eventos MessageReceived falhará com E_ILLEGAL_METHOD_CALL, mesmo após o soquete ter sido fechado
Uma mensagem vazia resulta em GetDataReader retornando uma instância IDataReader válida com UnconsumedBufferLength definido como 0. GetDataStream retorna uma instância IInputStream válida que produz zero bytes.