TsgcWebSocketServer_HTTPAPI › Ereignisse › OnMessage
Wird jedes Mal ausgelöst, wenn ein Client eine Textnachricht sendet und sie vom Server empfangen wird.
property OnMessage: TsgcWSMessageEvent;
// TsgcWSMessageEvent = procedure(Connection: TsgcWSConnection; const Text: string) of object—
OnMessage wird ausgelöst, sobald ein vollständiger Text-Frame von einem Client über die HTTP.SYS-WebSocket-Pipeline empfangen wurde. Der Parameter Text trägt den dekodierten UTF-8-String und der Parameter Connection identifiziert die Sender-Sitzung, sodass der Handler über dieselbe Verbindung antworten oder die Nachricht an andere Clients weiterleiten kann. Das Ereignis läuft im Kontext des IOCP-Worker-Threads; wenn Sie UI-Steuerelemente aktualisieren müssen, leiten Sie den Aufruf an den Haupt-Thread weiter. Wenn Options.FragmentedMessages frgOnlyFragmented ist, wird das Ereignis nicht ausgelöst und die Nutzlast wird stattdessen über OnFragmented geliefert.
procedure OnMessage(Connection: TsgcWSConnection; const Text: string);
begin
ShowMessage('Message Received from Client: ' + Text);
end;