TsgcTCPClient › Methoden › Connect

Connect Methode

Öffnet die TCP-Verbindung synchron und blockiert den Aufrufer, bis der Socket verbunden ist oder das Timeout verstreicht.

Syntax

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

Parameter

Name	Typ	Beschreibung
aTimeout	const Integer	Maximale Zeit in Millisekunden, die auf das Aktivwerden der Verbindung gewartet wird. Standardwert ist 10000 (10 Sekunden).

Rückgabewert

True, wenn der TCP-Socket innerhalb des Timeouts hergestellt wurde; andernfalls False. (Boolean)

Hinweise

Connect ist das blockierende Gegenstück zum Setzen von Active := True. Es setzt Active intern und wartet dann auf ein internes Ereignis, bis der TCP-Handshake abgeschlossen ist oder das Timeout abläuft. Anders als beim WebSocket-Client gibt es keinen HTTP-Upgrade-Schritt, sodass die Methode zurückkehrt, sobald der rohe Socket (und die TLS-Aushandlung, wenn aktiviert) hergestellt ist. Wenn der Client bereits verbunden ist, gibt die Methode sofort True zurück. Wenn die Funktion True zurückgibt, ist es sicher, WriteData sofort aufzurufen, ohne auf OnConnect zu warten. Verwenden Sie stattdessen Start, wenn Sie einen nicht blockierenden Aufruf benötigen, der von einem sekundären Thread aus verbindet.

Beispiel

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');

Zurück zu Methoden