TsgcTCPClient › Methods › Connect

Connect Metodo

Apre la connessione TCP in modo sincrono e blocca il chiamante fino a quando il socket è connesso o il timeout scade.

Sintassi

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

Parametri

NomeTipoDescrizione
aTimeoutconst IntegerTempo massimo in millisecondi da attendere affinché la connessione diventi attiva. Il valore predefinito è 10000 (10 secondi).

Valore restituito

True quando il socket TCP è stato stabilito entro il timeout; False in caso contrario. (Boolean)

Note

Connect è la controparte bloccante dell'impostazione Active := True. Imposta Active internamente e poi attende su un evento interno finché l'handshake TCP non viene completato o il timeout scade. A differenza del client WebSocket non è presente un passaggio di upgrade HTTP, quindi il metodo ritorna non appena il socket raw (e la negoziazione TLS, se abilitata) è stabilito. Se il client è già connesso, il metodo ritorna immediatamente True. Quando la funzione ritorna True è sicuro chiamare WriteData immediatamente, senza attendere OnConnect. Utilizzare Start invece se si necessita di una chiamata non bloccante che si connette da un thread secondario.

Esempio


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

Torna ai Metodi