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

Parameters

remoteEP

The IPEndPoint to which you intend to connect.

Exception typeCondition

ArgumentNullException

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

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


//Uses a remote end point to establish a socket connection.
TcpClient tcpClient = new TcpClient();
IPAddress ipAddress =
    Dns.Resolve("www.contoso.com").get_AddressList()[0];
IPEndPoint ipEndPoint = new IPEndPoint(ipAddress, 11004);

tcpClient.Connect(ipEndPoint);

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

Community Additions

ADD
Show:
© 2015 Microsoft