System.Net.Socket.TSocket.Connect

• Aller au parent : TSocket

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	Le système d'exploitation a signalé une erreur lors de la liaison de votre socket à une adresse IP locale. Cela peut uniquement se produire si le type de votre socket est UDP. Pour de plus amples informations, voir la documentation suivante relative au système d'exploitation sur lequel votre application était exécutée : Windows : fonction bind (MSDN) (EN) OS X: bind (OS X Man Pages) (EN) iOS : bind (iOS Manual Pages) (EN) Android : bind (Linux Programmer's Manual) (EN) Linux: bind (Linux Programmer's Manual) (EN)
	Erreur de socket réseau : <message d'erreur> (<code d'erreur>), sur la fonction 'connect' de l'API	Le système d'exploitation a signalé une erreur lors de la connexion de votre socket à une adresse IP distante. Cela peut uniquement se produire si le type de votre socket est UDP. Pour de plus amples informations, voir la documentation suivante relative au système d'exploitation sur lequel votre application était exécutée : Windows : fonction connect (MSDN) (EN) OS X: connect (OS X Man Pages) (EN) iOS : connect (iOS Manual Pages) (EN) Android : connect (Linux Programmer's Manual) (EN) Linux: connect (Linux Programmer's Manual) (EN)
	Erreur de socket réseau : <message d'erreur> (<code d'erreur>), sur la fonction 'socket' de l'API	Le système d'exploitation a signalé une erreur lors de la création d'un socket. Pour de plus amples informations, voir la documentation suivante relative au système d'exploitation sur lequel votre application était exécutée : Windows : fonction socket (MSDN) (EN) OS X: socket (OS X Man Pages) (EN) iOS : socket (iOS Manual Pages) (EN) Android : socket (Linux Programmer's Manual) (EN) Linux: socket (Linux Programmer's Manual) (EN)
	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	Vous ne pouvez pas connecter un socket qui est déjà ouvert. Un appel précédent à l'une des méthodes suivantes doit avoir déjà ouvert le socket : Bind Connect Create (si vous spécifiez un handle de socket et une adresse de socket) GetClientSocket Listen ListenBroadcast OpenBroadcast

Voir aussi

• System.Net.Socket.TSocket.SocketType
• System.Net.Socket.TNetEndpoint
• System.Net.Socket.TSocket.LookupService
• System.Net.Socket.TSocket.Bind

• System.Net.Socket.TSocket.BeginConnect
• System.Net.Socket.TSocket.EndConnect

• System.Net.Socket.TSocket.CreateSocket
• System.Net.Socket.TSocket.DoBind
• System.Net.Socket.TSocket.DoConnect
• System.Net.Socket.TSocket.InitSocket