TcpClient Constructor (IPEndPoint)

 
System_CAPS_noteNote

The .NET API Reference documentation has a new home. Visit the .NET API Browser on docs.microsoft.com 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 Sub New (
	localEP As IPEndPoint
)

Parameters

localEP
Type: System.Net.IPEndPoint

The IPEndPoint to which you bind the TCP Socket.

Exception Condition
ArgumentNullException

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.

System_CAPS_noteNote

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 endpoint.
Dim ipAddress As IPAddress = Dns.GetHostEntry(Dns.GetHostName()).AddressList(0)
   Dim ipLocalEndPoint As New IPEndPoint(ipAddress, 0)

   Dim tcpClientA As New TcpClient(ipLocalEndPoint)

.NET Framework
Available since 1.1
Return to top
Show: