TsgcTCPClient › Eventi › OnMessage
Si attiva quando i byte grezzi ricevuti dal server TCP possono essere esposti come testo.
property OnMessage: TsgcWSMessageEvent;
// TsgcWSMessageEvent = procedure(Connection: TsgcWSConnection; const Text: string) of object—
A differenza del client WebSocket, TsgcTCPClient non negozia un handshake e non riceve messaggi frame; pertanto OnMessage consegna i byte grezzi arrivati sul socket TCP convertiti in stringa. Quando TCPEndOfFrameScanBuffer è eofScanNone, ogni lettura viene presentata man mano che arriva; quando è eofScanLatestBytes o eofScanAllBytes, il buffer viene suddiviso sul delimitatore TCPEndOfFrame e viene generato un evento per ogni frame logico. Il parametro Text contiene il payload decodificato in UTF-8; utilizzare OnBinary se il server invia dati non testuali. Per impostazione predefinita NotifyEvents è neAsynchronous, quindi il gestore viene eseguito nel contesto del thread principale ed è sicuro aggiornare direttamente i controlli dell'interfaccia utente; passare a neNoSync se il client riceve un elevato volume di dati e si preferisce gestire la sincronizzazione autonomamente.
procedure OnMessage(Connection: TsgcWSConnection; const Text: string);
begin
ShowMessage('Received from TCP server: ' + Text);
end;