TsgcWebSocketServer_HTTPAPI › Zdarzenia › OnMessage

OnMessage Zdarzenie

Wywoływane za każdym razem, gdy klient wysyła wiadomość tekstową i zostaje ona odebrana przez serwer.

Składnia

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

Wartość domyślna

—

Uwagi

Zdarzenie OnMessage jest wywoływane po odebraniu kompletnej ramki tekstowej od klienta przez potok WebSocket HTTP.SYS. Parametr Text zawiera zdekodowany łańcuch UTF-8, a parametr Connection identyfikuje sesję nadawcy, dzięki czemu program obsługi może odpowiedzieć na tym samym połączeniu lub przekazać wiadomość innym klientom. Zdarzenie działa w kontekście wątku roboczego IOCP; aktualizacje kontrolek interfejsu użytkownika należy przekazywać do wątku głównego. Jeśli właściwość Options.FragmentedMessages ma wartość frgOnlyFragmented, zdarzenie nie jest wywoływane, a ładunek jest dostarczany przez zdarzenie OnFragmented.

Przykład

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

Powrót do Zdarzeń