MessageWebSocket.MessageReceived Événement
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
Événement qui indique qu’un message a été reçu sur l’objet 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) Type d'événement
Remarques
Toutes les erreurs liées au traitement des messages et aux connexions sont communiquées par le biais des méthodes GetDataReader et GetDataStream . Si l’une de ces méthodes lève une exception, cela indique que la connexion sous-jacente est interrompue ou que le serveur a envoyé des données non valides, telles que des en-têtes HTTP endommagés ou un message qui dépasse la taille maximale des messages. L’action appropriée que votre code doit prendre en cas d’exception de ces méthodes consiste à rétablir un état correct connu en fermant le websocket, en en créant un nouveau et en vous reconnectant au serveur.
Tous les gestionnaires d’événements MessageReceived doivent être inscrits avant l’appel de ConnectAsync . Après cela, la tentative d’ajout ou de suppression d’un gestionnaire d’événements MessageReceived échoue avec E_ILLEGAL_METHOD_CALL, même après la fermeture du socket
Un message vide entraîne le renvoi d’un instance IDataReader valide avec UnconsumedBufferLength défini sur 0. GetDataStream retourne un instance IInputStream valide qui génère zéro octet.