TsgcWebSocketClient es el wrapper .NET del cliente en tiempo de ejecución de sgcWebSockets. Hereda todas las capacidades WebSocket de TsgcWebSocketClient_base, ofreciendo a las aplicaciones .NET una API estilo componente para conectarse, enviar y recibir a través de WebSockets
Propiedades clave
- Host y Port – endpoint del servidor de destino
- Options.Parameters – ruta URL o parámetros de query para el handshake WebSocket
- TLS y TLSOptions – activan TLS y seleccionan la versión del protocolo y el IO handler
- Specifications.RFC6455 – activa o desactiva el cumplimiento de framing WebSocket RFC 6455
- Proxy – configuración de proxy HTTP (Enabled, Username, Password, Host, Port)
- Extensions.PerMessage_Deflate.Enabled – activa la compresión por mensaje
- Authentication – credenciales de autenticación básica cuando se necesitan
- Active – pon
truepara conectar,falsepara desconectar
Eventos
Registra manejadores de eventos para reaccionar al ciclo de vida de la conexión y a los datos:
- OnConnect – se dispara tras una conexión correcta; el manejador de ejemplo registra la IP del extremo remoto
- OnDisconnect – se dispara al cerrarse la conexión, proporcionando el código de cierre
- OnMessage – recibe mensajes de texto del servidor
- OnError – informa de errores de protocolo o de socket
- OnException – expone excepciones inesperadas generadas dentro del componente
Ejemplo
using esegece.sgcWebSockets;
var client = new TsgcWebSocketClient();
client.OnConnect += OnConnectEvent;
client.OnDisconnect += OnDisconnectEvent;
client.OnException += OnExceptionEvent;
client.OnError += OnErrorEvent;
client.OnMessage += OnMessageEvent;
client.Host = "www.esegece.com";
client.Port = 2052;
client.Options.Parameters = "/";
client.TLS = false;
client.Specifications.RFC6455 = true;
client.Active = true;
// Sending data once connected
client.WriteData("Hello WebSocket!");
Este fragmento refleja el uso de la demo: los eventos se enlazan antes de conectarse, se configuran las propiedades clave (host, port, TLS, RFC6455, etc.) y, al poner Active a true, se inicia la conexión.
Con los manejadores de eventos definidos (como se muestra arriba), el cliente puede registrar conexiones, recibir mensajes y enviar datos mediante WriteData.
