System.Net.Socket.TSocket.Connect

• Up to 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 */;

Properties

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

Description

Establishes a connection to the specified endpoint.

In order to establish a direct connection, the type of your socket must be RAW, RDM, SEQ, or TCP. If the type of your socket is UDP, Connect attempts to bind your socket to the specified address instead of establishing a connection to that address.

To specify the target endpoint, you must provide any of the following combinations of parameters:

• An endpoint (Endpoint).
• An IP address (Address) and a service (Service). You may pass an empty word as Port, as Service is used to determine the port.
• An IP address (Address) and a port (Port). Pass an empty string as Service. Otherwise the specified service name is used to determine the port to use, and the specified port is ignored.

Exceptions

A call to Connect can raise any of the following exceptions:

Exception	Exception.Message	Scenarios
ESocketError	Network socket error: <error message> (<error code>), on API 'bind'	The operating system reported an error while binding your socket to a local IP address. This can only happen if the type of your socket is UDP. For more information, see the following documentation for the operating system where your application was running: Windows: bind function (MSDN) OS X: bind (OS X Man Pages) iOS: bind (iOS Manual Pages) Android: bind (Linux Programmer's Manual) Linux: bind (Linux Programmer's Manual)
	Network socket error: <error message> (<error code>), on API 'connect'	The operating system reported an error while connecting your socket to a remote IP address. This can only happen if the type of your socket is not UDP. For more information, see the following documentation for the operating system where your application was running: Windows: connect function (MSDN) OS X: connect (OS X Man Pages) iOS: connect (iOS Manual Pages) Android: connect (Linux Programmer's Manual) Linux: connect (Linux Programmer's Manual)
	Network socket error: <error message> (<error code>), on API 'socket'	The operating system reported an error while creating a socket. For more information, see the following documentation for the operating system where your application was running: Windows: socket function (MSDN) OS X: socket (OS X Man Pages) iOS: socket (iOS Manual Pages) Android: socket (Linux Programmer's Manual) Linux: socket (Linux Programmer's Manual)
	No address specified	You did not specify enough information to determine the address of the socket. Connect raises this exception when both Name and Address are empty strings.
	Socket already open	You cannot connect a socket that is already open. A previous call to any of the following methods must have opened the socket already: Bind Connect Create (if you specify a socket handle and a socket address) GetClientSocket Listen ListenBroadcast OpenBroadcast

See Also

• 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