TsgcWebSocketServer_HTTPAPI › Eventi › OnMessage
Viene attivato ogni volta che un client invia un messaggio di testo e questo viene ricevuto dal server.
property OnMessage: TsgcWSMessageEvent;
// TsgcWSMessageEvent = procedure(Connection: TsgcWSConnection; const Text: string) of object—
OnMessage viene generato una volta che un frame di testo completo è stato ricevuto da un client attraverso il pipeline WebSocket HTTP.SYS. Il parametro Text contiene la stringa UTF-8 decodificata e il parametro Connection identifica la sessione mittente, in modo che il gestore possa rispondere sulla stessa connessione o trasmettere il messaggio ad altri client. L'evento viene eseguito nel contesto del thread worker IOCP; se è necessario aggiornare i controlli UI, effettuare il marshal della chiamata al thread principale. Se Options.FragmentedMessages è frgOnlyFragmented, l'evento non viene generato e il payload viene consegnato tramite OnFragmented.
procedure OnMessage(Connection: TsgcWSConnection; const Text: string);
begin
ShowMessage('Message Received from Client: ' + Text);
end;