System.Net.Socket.TSocket.Connect

De RAD Studio API Documentation
Aller à : navigation, rechercher

Delphi

procedure Connect(const Name, Address, Service: string; Port: Word); overload;
procedure Connect(const EndPoint: TNetEndpoint); overload;

C++

void __fastcall Connect(const System::UnicodeString Name, const System::UnicodeString Address, const System::UnicodeString Service, System::Word Port)/* overload */;
void __fastcall Connect(const TNetEndpoint &EndPoint)/* overload */;

Propriétés

Type Visibilité  Source Unité  Parent
procedure
function
public
System.Net.Socket.pas
System.Net.Socket.hpp
System.Net.Socket TSocket


Description

Etablit une connexion au point de terminaison spécifié.

Afin d'établir une connexion directe, le type de votre socket doit être RAW, RDM, SEQ ou TCP. Si le type de votre socket est UDP, Connect essaie de lier votre socket à l'adresse spécifiée au lieu d'établir une connexion à cette adresse.

Pour spécifier le point de terminaison cible, vous devez fournir l'une des combinaisons de paramètres suivantes :

  • Un point de terminaison (Endpoint).
  • Une adresse IP (Address) et un service (Service). Vous pouvez transmettre un mot vide en tant que Port, car Service est utilisé pour déterminer le port.
  • Une adresse IP (Address) et un port (Port). Transmettez une chaîne vide en tant que Service. Sinon, le nom de service spécifié est utilisé pour déterminer le port à utiliser, et le port spécifié est ignoré.

Exceptions

Un appel à Connect peut déclencher l'une des exceptions suivantes :

Exception Exception.Message Scénarios

ESocketError

Erreur de socket réseau : <message d'erreur> (<code d'erreur>), sur la fonction 'bind' de l'API

Erreur de socket réseau : <message d'erreur> (<code d'erreur>), sur la fonction 'connect' de l'API

Erreur de socket réseau : <message d'erreur> (<code d'erreur>), sur la fonction 'socket' de l'API

Aucune adresse spécifiée

  • Vous n'avez pas spécifié assez d'informations pour déterminer l'adresse du socket. Connect déclenche cette exception lorsque Name et Address sont des chaînes vides.

Socket déjà ouvert

Voir aussi