TcpClient Constructor (IPEndPoint)


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

Initializes a new instance of the TcpClient class and binds it to the specified local endpoint.

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

public TcpClient(
	IPEndPoint localEP


Type: System.Net.IPEndPoint

The IPEndPoint to which you bind the TCP Socket.

Exception Condition

The localEP parameter is null.

This constructor creates a new TcpClient and binds it to the IPEndPoint specified by the localEP parameter. Before you call this constructor, you must create an IPEndPoint using the IP address and port number from which you intend to send and receive data. You do not need to specify a local IP address and port number before connecting and communicating. If you create a TcpClient using any other constructor, the underlying service provider will assign the most appropriate local IP address and port number.

You must call the Connect method before sending and receiving data.


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 demonstrates how to create an instance of the TcpClient class using a local endpoint.

//Creates a TCPClient using a local end point.
IPAddress ipAddress = Dns.GetHostEntry (Dns.GetHostName ()).AddressList[0];
IPEndPoint ipLocalEndPoint = new IPEndPoint(ipAddress, 0);
TcpClient tcpClientA = new TcpClient (ipLocalEndPoint);

.NET Framework
Available since 1.1
Return to top