TsgcWebSocketClient est le wrapper .NET autour du client runtime sgcWebSockets. Il hérite de toutes les fonctionnalités WebSocket de base depuis TsgcWebSocketClient_base, offrant aux applications .NET une API de style composant pour se connecter, envoyer et recevoir via WebSockets.
Propriétés clés
- Host & Port – endpoint du serveur cible
- Options.Parameters – chemin URL ou paramètres de requête pour le handshake WebSocket
- TLS & TLSOptions – active TLS et sélectionne la version du protocole / le gestionnaire d'E/S
- Specifications.RFC6455 – bascule la conformité du framing WebSocket RFC6455
- Proxy – configuration du proxy HTTP (Enabled, Username, Password, Host, Port)
- Extensions.PerMessage_Deflate.Enabled – active la compression par message
- Authentication – identifiants d'authentification basic si nécessaire
- Active – définis sur
truepour se connecter,falsepour se déconnecter
Événements
Enregistre des gestionnaires d'événements pour réagir au cycle de vie de la connexion et aux données :
- OnConnect – déclenché après une connexion réussie ; le gestionnaire d'exemple journalise l'IP du peer
- OnDisconnect – déclenché à la fermeture de la connexion, fournissant le close code
- OnMessage – reçoit les messages texte depuis le serveur
- OnError – signale les erreurs de protocole ou de socket
- OnException – expose les exceptions inattendues levées dans le composant
Exemple
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!");
Cet extrait reflète l'utilisation de la démo : les événements sont câblés avant la connexion, les propriétés clés sont configurées (host, port, TLS, RFC6455, etc.) et définir Active sur true lance la connexion.
Avec les gestionnaires d'événements définis (comme ci-dessus), le client peut journaliser les connexions, recevoir des messages et envoyer des données via WriteData.
