TcpClient.Connect Method (IPEndPoint)


The .NET API Reference documentation has a new home. Visit the .NET API Browser on to see the new experience.

Connects the client to a remote TCP host using the specified remote network endpoint.

Namespace:   System.Net.Sockets
Assembly:  System (in System.dll)

public void Connect(
	IPEndPoint remoteEP


Type: System.Net.IPEndPoint

The IPEndPoint to which you intend to connect.

Exception Condition

The remoteEp parameter is null.


An error occurred when accessing the socket. See the Remarks section for more information.


The TcpClient is closed.

Call this method to establish a synchronous remote host connection to the specified IPEndPoint. Before you call Connect you must create an instance of the IPEndPoint class using an IP address and a port number. Use this IPEndPoint as the remoteEP parameter. The Connect method will block until it either connects or fails. After connecting with the remote host, use the GetStream method to obtain the underlying NetworkStream. Use this NetworkStream to send and receive data.


If you receive a SocketException, use SocketException.ErrorCode to obtain the specific error code. After you have obtained this code, you can refer to the Windows Sockets version 2 API error code documentation in MSDN for a detailed description of the error.


This member outputs trace information when you enable network tracing in your application. For more information, see Network Tracing in the .NET Framework

The following code example uses an IPEndPoint to connect with a remote host.

//Uses a remote endpoint to establish a socket connection.
TcpClient tcpClient = new TcpClient ();
IPAddress ipAddress = Dns.GetHostEntry ("").AddressList[0];
IPEndPoint ipEndPoint = new IPEndPoint (ipAddress, 11004);

tcpClient.Connect (ipEndPoint);

.NET Framework
Available since 1.1
Return to top