Export (0) Print
Expand All

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
)

Parameters

remoteEP
Type: System.Net.IPEndPoint
The IPEndPoint to which you intend to connect.

ExceptionCondition
ArgumentNullException

The remoteEp parameter is null.

SocketException

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

ObjectDisposedException

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.

NoteNote

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.

NoteNote

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 ("www.contoso.com").AddressList[0];
            IPEndPoint ipEndPoint = new IPEndPoint (ipAddress, 11004);

            tcpClient.Connect (ipEndPoint);



.NET Framework

Supported in: 4, 3.5, 3.0, 2.0, 1.1, 1.0

.NET Framework Client Profile

Supported in: 4, 3.5 SP1

Windows 7, Windows Vista SP1 or later, Windows XP SP3, Windows XP SP2 x64 Edition, Windows Server 2008 (Server Core not supported), Windows Server 2008 R2 (Server Core supported with SP1 or later), Windows Server 2003 SP2

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

Community Additions

ADD
Show:
© 2015 Microsoft