TsgcTCPClient › Methods › Connect

Connect 方法

同步打开 TCP 连接，阻塞调用方直至套接字连接成功或超时。

语法

function Connect(const aTimeout: Integer = 10000): Boolean;

参数

名称	类型	描述
aTimeout	const Integer	等待连接变为活跃状态的最长时间（毫秒）。默认值为 10000（10 秒）。

返回值

当 TCP 套接字在超时内成功建立时为 True，否则为 False。（Boolean）

备注

Connect 是将 Active 设为 True 的阻塞版本。它在内部设置 Active，然后在内部事件上等待，直到 TCP 握手完成或超时到期。与 WebSocket 客户端不同，没有 HTTP 升级步骤，因此该方法在原始套接字（以及启用 TLS 时的 TLS 协商）建立后立即返回。如果客户端已连接，则该方法立即返回 True。当函数返回 True 时，可以安全地立即调用 WriteData，而无需等待 OnConnect。如果需要从辅助线程连接的非阻塞调用，请改用 Start。

示例

oClient := TsgcTCPClient.Create(nil);
oClient.Host := '127.0.0.1';
oClient.Port := 5000;
if oClient.Connect(5000) then
  oClient.WriteData('Hello Server')
else
  ShowMessage('Connection failed');

返回方法