This documentation is archived and is not being maintained.

TcpClient.Connect Method (IPEndPoint)

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
public void Connect (
	IPEndPoint remoteEP
public function Connect (
	remoteEP : IPEndPoint



The IPEndPoint to which you intend to connect.

Exception typeCondition


remoteEp is a null reference (Nothing in Visual Basic).


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

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

//Uses a remote end point to establish a socket connection.
TcpClient tcpClient = new TcpClient();
IPAddress ipAddress =
IPEndPoint ipEndPoint = new IPEndPoint(ipAddress, 11004);


Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile for Pocket PC, Windows Mobile for Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

The .NET Framework does not support all versions of every platform. For a list of the supported versions, see System Requirements.

.NET Framework

Supported in: 2.0, 1.1, 1.0

.NET Compact Framework

Supported in: 2.0, 1.0