TsgcTCPClient › Methods › Connect

Connect Metoda

Otwiera połączenie TCP synchronicznie i blokuje wywołującego do momentu nawiązania połączenia z gniazdem lub upłynięcia limitu czasu.

Składnia

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

Parametry

Nazwa	Typ	Opis
aTimeout	const Integer	Maksymalny czas w milisekundach oczekiwania na aktywację połączenia. Domyślnie wynosi 10000 (10 sekund).

Wartość zwracana

True, gdy gniazdo TCP zostało nawiązane w czasie oczekiwania; False w przeciwnym razie. (Boolean)

Uwagi

Connect jest blokującym odpowiednikiem ustawienia Active := True. Wewnętrznie ustawia Active, a następnie oczekuje na zdarzenie wewnętrzne do momentu zakończenia uzgadniania TCP lub upływu limitu czasu. W przeciwieństwie do klienta WebSocket nie ma kroku aktualizacji HTTP, więc metoda powraca po nawiązaniu gniazda (oraz po negocjacji TLS, gdy jest włączona). Jeśli klient jest już połączony, metoda natychmiast zwraca wartość True. Gdy funkcja zwróci True, można bezpiecznie wywołać metodę WriteData natychmiast, bez oczekiwania na zdarzenie OnConnect. Należy użyć metody Start, jeśli potrzebne jest wywołanie nieblokujące nawiązujące połączenie z wątku pomocniczego.

Przykład

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

Powrót do metod