TsgcTCPClient › Méthodes › Connect

Connect Méthode

Ouvre la connexion TCP de manière synchrone et bloque l'appelant jusqu'à ce que le socket soit connecté ou que le délai d'attente expire.

Syntaxe

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

Paramètres

NomTypeDescription
aTimeoutconst Integer Temps maximum en millisecondes pour attendre que la connexion devienne active. La valeur par défaut est 10000 (10 secondes).

Valeur de retour

True lorsque le socket TCP a été établi dans le délai imparti ; False sinon. (Boolean)

Remarques

Connect est la contrepartie bloquante de la définition de Active := True. Elle définit Active en interne et attend ensuite sur un événement interne jusqu'à ce que la poignée de main TCP soit terminée ou que le délai d'attente expire. Contrairement au client WebSocket, il n'y a pas d'étape de mise à niveau HTTP, donc la méthode retourne dès que le socket brut (et la négociation TLS, lorsqu'elle est activée) est établi. Si le client est déjà connecté, la méthode retourne True immédiatement. Lorsque la fonction retourne True, il est sûr d'appeler WriteData directement, sans attendre OnConnect. Utilisez Start à la place si vous avez besoin d'un appel non bloquant qui se connecte depuis un thread secondaire.

Exemple


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

Retour aux méthodes