TcpClient Constructor (IPEndPoint)
Collapse the table of content
Expand the table of content

TcpClient Constructor (IPEndPoint^)

 

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
)

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 end point.
IPAddress^ ipAddress = Dns::Resolve( Dns::GetHostName() )->AddressList[ 0 ];
IPEndPoint^ ipLocalEndPoint = gcnew IPEndPoint( ipAddress,11000 );
TcpClient^ tcpClientA = gcnew TcpClient( ipLocalEndPoint );

.NET Framework
Available since 1.1
Return to top
Show:
© 2016 Microsoft