TsgcWebSocketServer_HTTPAPIEvents › OnMessage

OnMessage Gebeurtenis

Wordt geactiveerd elke keer dat een client een tekstbericht verzendt en dit door de server wordt ontvangen.

Syntaxis

__property TsgcWSMessageEvent OnMessage;
// typedef void __fastcall (__closure *TsgcWSMessageEvent)(TsgcWSConnection * Connection, const UnicodeString Text);

Standaardwaarde

Opmerkingen

OnMessage wordt geactiveerd zodra een volledig tekstframe van een client is ontvangen via de HTTP.SYS WebSocket-pipeline. De parameter Text bevat de gedecodeerde UTF-8-string en de parameter Connection identificeert de verzendende sessie, zodat de handler op dezelfde verbinding kan antwoorden of het bericht naar andere clients kan doorsturen. De gebeurtenis draait in de context van de IOCP-workerthread; als u UI-controls moet bijwerken, marshall de aanroep naar de hoofdthread. Als Options.FragmentedMessages frgOnlyFragmented is, wordt de gebeurtenis niet geactiveerd en wordt de payload in plaats daarvan via OnFragmented geleverd.

Voorbeeld


void OnMessage(TsgcWSConnection *Connection, const string Text)
{
  ShowMessage("Message Received from Client: " + Text);
}

Terug naar Events