TsgcWebSocketClient is de .NET-wrapper rond de sgcWebSockets-runtime-client. Het erft alle kern-WebSocket-mogelijkheden van TsgcWebSocketClient_base, en biedt .NET-applicaties een component-stijl-API voor verbinden, versturen en ontvangen via WebSockets
Belangrijkste eigenschappen
- Host & Port – endpoint van de doelserver
- Options.Parameters – URL-pad of querystring-parameters voor de WebSocket-handshake
- TLS & TLSOptions – TLS inschakelen en protocolversie/IO-handler selecteren
- Specifications.RFC6455 – RFC6455-WebSocket-framing-compliance aan/uit
- Proxy – HTTP-proxyconfiguratie (Enabled, Username, Password, Host, Port)
- Extensions.PerMessage_Deflate.Enabled – per-message-compressie inschakelen
- Authentication – basic-authentication-credentials indien nodig
- Active – stel
truein om te verbinden,falseom te verbreken
Events
Registreer event-handlers om te reageren op de verbindingslevenscyclus en data:
- OnConnect – wordt geactiveerd na een succesvolle verbinding; voorbeeld-handler logt het peer-IP
- OnDisconnect – wordt geactiveerd wanneer de verbinding sluit, met de close-code
- OnMessage – ontvangt tekstberichten van de server
- OnError – rapporteert protocol- of socketfouten
- OnException – legt onverwachte excepties bloot die binnen het component worden opgeworpen
Voorbeeld
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!");
Dit fragment weerspiegelt het demo-gebruik: events worden aangesloten voor het verbinden, belangrijkste eigenschappen worden geconfigureerd (host, port, TLS, RFC6455, enz.) en het instellen van Active op true initieert de verbinding.
Met de event-handlers gedefinieerd (zoals hierboven getoond) kan de client verbindingen loggen, berichten ontvangen en data versturen via WriteData.