TsgcWebSocketClient to opakowanie .NET dla klienta środowiska uruchomieniowego sgcWebSockets. Dziedziczy wszystkie podstawowe możliwości WebSocket z TsgcWebSocketClient_base, zapewniając aplikacjom .NET API w stylu komponentowym do łączenia się, wysyłania i odbierania przez WebSockets.
Główne właściwości
- Host i Port – docelowy punkt końcowy serwera
- Options.Parameters – parametry ścieżki URL lub zapytania dla uzgadniania WebSocket
- TLS i TLSOptions – włączenie TLS i wybór wersji protokołu / obsługi IO
- Specifications.RFC6455 – przełączanie zgodności ramkowania WebSocket RFC6455
- Proxy – konfiguracja proxy HTTP (Enabled, Username, Password, Host, Port)
- Extensions.PerMessage_Deflate.Enabled – włączenie kompresji dla każdej wiadomości
- Authentication – poświadczenia uwierzytelniania podstawowego, gdy potrzebne
- Active – ustaw
true, aby połączyć,false, aby rozłączyć
Zdarzenia
Zarejestruj procedury obsługi zdarzeń, aby reagować na cykl życia połączenia i dane:
- OnConnect – wywoływane po pomyślnym połączeniu; przykładowa procedura rejestruje adres IP partnera
- OnDisconnect – wyzwalane, gdy połączenie zostaje zamknięte, przekazując kod zamknięcia
- OnMessage – odbiera wiadomości tekstowe z serwera
- OnError – zgłasza błędy protokołu lub gniazda
- OnException – ujawnia nieoczekiwane wyjątki wywołane w komponencie
Example
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!");
Ten fragment odzwierciedla użycie w demo: zdarzenia są podpinane przed połączeniem, kluczowe właściwości są skonfigurowane (host, port, TLS, RFC6455 itp.), a ustawienie Active na true inicjuje połączenie.
Po zdefiniowaniu procedur obsługi zdarzeń (jak pokazano powyżej) klient może rejestrować połączenia, odbierać wiadomości i wysyłać dane przez WriteData.