TsgcWebSocketClient › イベント › OnBeforeConnect

OnBeforeConnect イベント

クライアントがサーバーへの接続を試みる前に発生します。

構文

property OnBeforeConnect: TsgcWSOnBeforeConnectEvent;
// TsgcWSOnBeforeConnectEvent = procedure(Sender: TObject) of object

デフォルト値

—

解説

OnBeforeConnect は、クライアントがサーバーへの TCP 接続を開く直前に発生します。これにより、アプリケーションは Host、Port、URL、Proxy、または認証情報などの接続プロパティを最後に更新する機会を得ます。このイベントはすべての WatchDog 再接続試行の前にも発生するため、プライマリサーバーが到達不能な場合にフォールバックエンドポイントに切り替える便利な場所でもあります。ハンドラーは Sender（TsgcWebSocketClient インスタンス）のみを受け取ります。ソケットがまだ作成されていないため、接続オブジェクトはありません。

使用例

procedure OnBeforeConnect(Sender: TObject);
begin
  TsgcWebSocketClient(Sender).Host := 'fallback.example.com';
  TsgcWebSocketClient(Sender).Port := 443;
end;

イベントに戻る