TsgcWebSocketServerEventos › OnMessage

OnMessage Evento

Se activa cada vez que un cliente envía un mensaje de texto y es recibido por el servidor.

Sintaxis

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

Valor Predeterminado

Observaciones

OnMessage se genera cuando se ha recibido una trama de texto completa de un cliente. El parámetro Text contiene la cadena UTF-8 decodificada y el parámetro Connection identifica la sesión del remitente, de modo que el manejador puede responder en la misma conexión o retransmitir el mensaje a otros clientes. De forma predeterminada, NotifyEvents es neAsynchronous y el manejador se ejecuta sincronizado con el hilo principal, lo que hace seguro actualizar controles de interfaz; para servidores de alto rendimiento, establezca NotifyEvents en neNoSync para despachar en el hilo de conexión e implemente su propia sincronización. Si Options.FragmentedMessages es frgOnlyFragmented, el evento no se genera y la carga se entrega a través de OnFragmented.

Ejemplo


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

Volver a Eventos