TsgcWebSocketServer_HTTPAPI › Événements › OnMessage

OnMessage Événement

Se déclenche chaque fois qu'un client envoie un message texte et qu'il est reçu par le serveur.

Syntaxe

property OnMessage: TsgcWSMessageEvent;
// TsgcWSMessageEvent = procedure(Connection: TsgcWSConnection; const Text: string) of object

Valeur par défaut

—

Remarques

OnMessage est déclenché une fois qu'une trame de texte complète a été reçue d'un client via le pipeline WebSocket HTTP.SYS. Le paramètre Text transporte la chaîne UTF-8 décodée et le paramètre Connection identifie la session émettrice, afin que le gestionnaire puisse répondre sur la même connexion ou relayer le message à d'autres clients. L'événement s'exécute dans le contexte du thread de travail IOCP ; si vous avez besoin de mettre à jour les contrôles de l'interface utilisateur, transmettez l'appel au thread principal. Si Options.FragmentedMessages est frgOnlyFragmented, l'événement n'est pas déclenché et la charge utile est remise via OnFragmented à la place.

Exemple

procedure OnMessage(Connection: TsgcWSConnection; const Text: string);
begin
  ShowMessage('Message Received from Client: ' + Text);
end;

Retour aux événements