TcpClient.Connect 메서드

정의

지정된 호스트 이름 및 포트 번호를 사용하여 클라이언트를 원격 TCP 호스트에 연결합니다.

오버로드

Name Description
Connect(IPEndPoint)

지정된 원격 네트워크 엔드포인트를 사용하여 클라이언트를 원격 TCP 호스트에 연결합니다.

Connect(IPAddress, Int32)

지정된 IP 주소 및 포트 번호를 사용하여 클라이언트를 원격 TCP 호스트에 연결합니다.

Connect(IPAddress[], Int32)

지정된 IP 주소 및 포트 번호를 사용하여 클라이언트를 원격 TCP 호스트에 연결합니다.

Connect(String, Int32)

지정된 호스트의 지정된 포트에 클라이언트를 연결합니다.

Connect(IPEndPoint)

지정된 원격 네트워크 엔드포인트를 사용하여 클라이언트를 원격 TCP 호스트에 연결합니다.

public:
 void Connect(System::Net::IPEndPoint ^ remoteEP);
public void Connect(System.Net.IPEndPoint remoteEP);
member this.Connect : System.Net.IPEndPoint -> unit
Public Sub Connect (remoteEP As IPEndPoint)

매개 변수

remoteEP
IPEndPoint

IPEndPoint 연결하려는 대상입니다.

예외

매개 변수는 remoteEP .입니다 null.

소켓에 액세스할 때 오류가 발생했습니다.

TcpClient 닫혀 있습니다.

예제

다음 코드 예제에서는 원격 호스트와 연결 하는 데 사용 IPEndPoint 합니다.

//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 endpoint to establish a socket connection.
Dim tcpClient As New TcpClient
Dim ipAddress As IPAddress = Dns.GetHostEntry("www.contoso.com").AddressList(0)
Dim ipEndPoint As New IPEndPoint(ipAddress, 11004)

tcpClient.Connect(ipEndPoint)

설명

이 메서드를 호출하여 지정된 IPEndPoint원격 호스트에 대한 동기 원격 호스트 연결을 설정합니다. 호출 Connect하기 전에 IP 주소와 포트 번호를 사용하여 클래스의 IPEndPoint 인스턴스를 만들어야 합니다. 이를 IPEndPoint 매개 변수로 remoteEP 사용합니다. 메서드는 Connect 연결되거나 실패할 때까지 차단됩니다. 원격 호스트와 연결한 후 이 메서드를 GetStream 사용하여 기본 NetworkStream호스트를 가져옵니다. 데이터를 NetworkStream 보내고 받는 데 사용합니다.

메모

수신되는 SocketException경우 특정 오류 코드를 가져오는 데 사용합니다 SocketException.ErrorCode . 이 코드를 가져온 후에는 Windows 소켓 버전 2 API 오류 코드 설명서에서 오류에 대한 자세한 설명을 참조할 수 있습니다.

메모

이 멤버는 애플리케이션에서 네트워크 추적을 사용하도록 설정할 때 추적 정보를 출력합니다. 자세한 내용은 .NET Framework의Network 추적 참조하세요.

메모

IPv6 주소를 사용하는 동안 메시지 This protocol version is not supported 와 함께 NotSupportedException을 수신하는 경우 전달하여 InterNetworkV6생성자에서 IPv6을 사용하도록 설정했는지 확인합니다.

추가 정보

적용 대상

Connect(IPAddress, Int32)

지정된 IP 주소 및 포트 번호를 사용하여 클라이언트를 원격 TCP 호스트에 연결합니다.

public:
 void Connect(System::Net::IPAddress ^ address, int port);
public void Connect(System.Net.IPAddress address, int port);
member this.Connect : System.Net.IPAddress * int -> unit
Public Sub Connect (address As IPAddress, port As Integer)

매개 변수

address
IPAddress

IPAddress 연결하려는 호스트의 수입니다.

port
Int32

연결하려는 포트 번호입니다.

예외

매개 변수는 address .입니다 null.

port 사이 MinPort 가 아닙니다.MaxPort

소켓에 액세스할 때 오류가 발생했습니다.

TcpClient 가 닫혀 있습니다.

예제

다음 코드 예제에서는 IP 주소 및 포트 번호를 사용하여 원격 호스트와 연결합니다.

//Uses the IP address and port number to establish a socket connection.
TcpClient tcpClient = new TcpClient ();
IPAddress ipAddress = Dns.GetHostEntry ("www.contoso.com").AddressList[0];

tcpClient.Connect (ipAddress, 11003);
'Uses the IP address and port number to establish a socket connection.
Dim tcpClient As New TcpClient
Dim ipAddress As IPAddress = Dns.GetHostEntry("www.contoso.com").AddressList(0)
tcpClient.Connect(ipAddress, 11003)

설명

이 메서드를 호출하여 지정된 IPAddress 포트 번호와 포트 번호에 대한 동기 원격 호스트 연결을 설정합니다. 메서드는 Connect 연결되거나 실패할 때까지 차단됩니다. 원격 호스트와 연결한 후 이 메서드를 GetStream 사용하여 기본 NetworkStream호스트를 가져옵니다. 데이터를 NetworkStream 보내고 받는 데 사용합니다.

메모

수신되는 SocketException경우 특정 오류 코드를 가져오는 데 사용합니다 SocketException.ErrorCode . 이 코드를 가져온 후에는 Windows 소켓 버전 2 API 오류 코드 설명서에서 오류에 대한 자세한 설명을 참조할 수 있습니다.

메모

이 멤버는 애플리케이션에서 네트워크 추적을 사용하도록 설정할 때 추적 정보를 출력합니다. 자세한 내용은 .NET Framework의Network 추적 참조하세요.

메모

IPv6 주소를 사용하는 동안 메시지 This protocol version is not supported 와 함께 NotSupportedException을 수신하는 경우 전달하여 InterNetworkV6생성자에서 IPv6을 사용하도록 설정했는지 확인합니다.

추가 정보

적용 대상

Connect(IPAddress[], Int32)

지정된 IP 주소 및 포트 번호를 사용하여 클라이언트를 원격 TCP 호스트에 연결합니다.

public:
 void Connect(cli::array <System::Net::IPAddress ^> ^ ipAddresses, int port);
public void Connect(System.Net.IPAddress[] ipAddresses, int port);
member this.Connect : System.Net.IPAddress[] * int -> unit
Public Sub Connect (ipAddresses As IPAddress(), port As Integer)

매개 변수

ipAddresses
IPAddress[]

IPAddress 연결하려는 호스트의 배열입니다.

port
Int32

연결하려는 포트 번호입니다.

예외

매개 변수는 ipAddresses .입니다 null.

포트 번호가 잘못되었습니다.

소켓에 액세스하려고 할 때 오류가 발생했습니다.

Socket 닫혔습니다.

호출 스택의 상위 호출자에는 요청된 작업에 대한 권한이 없습니다.

이 메서드는 플래그 또는 플래그를 사용하는 소켓에 InterNetworkInterNetworkV6 유효합니다.

예제

다음 코드 예제에서는 IP 주소 및 포트 번호를 사용하여 원격 호스트와 연결합니다.

static void DoConnect(string host, int port)
{
    // Connect to the specified host.
    TcpClient t = new TcpClient(AddressFamily.InterNetwork);

    IPAddress[] IPAddresses = Dns.GetHostAddresses(host);

    Console.WriteLine("Establishing connection to {0}", host);
    t.Connect(IPAddresses, port);

    Console.WriteLine("Connection established");
}

설명

이 메서드는 일반적으로 단일 호스트에 대해 여러 IP 주소를 반환할 BeginGetHostAddresses 수 있는 메서드를 호출한 직후에 사용됩니다. 메서드를 Connect 호출하여 요소 배열 IPAddress 및 포트 번호로 지정된 호스트에 대한 동기 원격 호스트 연결을 설정합니다. 메서드는 Connect 연결되거나 실패할 때까지 차단됩니다. 원격 호스트와 연결한 후 이 메서드를 GetStream 사용하여 기본 NetworkStream호스트를 가져옵니다. 데이터를 NetworkStream 보내고 받는 데 사용합니다.

메모

수신되는 SocketException경우 특정 오류 코드를 가져오는 데 사용합니다 SocketException.ErrorCode . 이 코드를 가져온 후에는 Windows 소켓 버전 2 API 오류 코드 설명서에서 오류에 대한 자세한 설명을 참조할 수 있습니다.

메모

이 멤버는 애플리케이션에서 네트워크 추적을 사용하도록 설정할 때 추적 정보를 출력합니다. 자세한 내용은 .NET Framework의Network 추적 참조하세요.

메모

IPv6 주소를 사용하는 동안 메시지 This protocol version is not supported 와 함께 NotSupportedException을 수신하는 경우 전달하여 InterNetworkV6생성자에서 IPv6을 사용하도록 설정했는지 확인합니다.

추가 정보

적용 대상

Connect(String, Int32)

지정된 호스트의 지정된 포트에 클라이언트를 연결합니다.

public:
 void Connect(System::String ^ hostname, int port);
public void Connect(string hostname, int port);
member this.Connect : string * int -> unit
Public Sub Connect (hostname As String, port As Integer)

매개 변수

hostname
String

연결하려는 원격 호스트의 DNS 이름입니다.

port
Int32

연결하려는 원격 호스트의 포트 번호입니다.

예외

매개 변수는 hostname .입니다 null.

매개 변수가 port 사이 MinPortMaxPort.

소켓에 액세스할 때 오류가 발생했습니다.

TcpClient 가 닫혀 있습니다.

예제

다음 코드 예제에서는 호스트 이름 및 포트 번호를 사용하여 원격 호스트와 연결합니다.

//Uses a host name and port number to establish a socket connection.
TcpClient tcpClient = new TcpClient ();
tcpClient.Connect ("www.contoso.com", 11002);
'Uses a host name and port number to establish a socket connection.
Dim tcpClient As New TcpClient()

   tcpClient.Connect("www.contoso.com", 11002)

설명

이 메서드를 호출하여 지정된 호스트 이름 및 포트 번호에 대한 동기 원격 호스트 연결을 설정합니다. 메서드는 Connect 연결되거나 실패할 때까지 차단됩니다. 원격 호스트와 연결한 후 이 메서드를 GetStream 사용하여 기본 NetworkStream호스트를 가져옵니다. 데이터를 NetworkStream 보내고 받는 데 사용합니다.

IPv6을 사용하도록 설정하고 IPv6 및 Connect(String, Int32) IPv4 주소 둘 다로 확인되는 호스트에 연결하기 위해 메서드를 호출하는 경우 IPv4 주소 전에 먼저 IPv6 주소에 대한 연결이 시도됩니다. 호스트가 IPv6 주소에서 수신 대기하지 않는 경우 연결 설정 시간이 지연되는 효과가 있을 수 있습니다.

메모

수신되는 SocketException경우 특정 오류 코드를 가져오는 데 사용합니다 SocketException.ErrorCode . 이 코드를 가져온 후에는 Windows 소켓 버전 2 API 오류 코드 설명서에서 오류에 대한 자세한 설명을 참조할 수 있습니다.

메모

이 멤버는 애플리케이션에서 네트워크 추적을 사용하도록 설정할 때 추적 정보를 출력합니다. 자세한 내용은 .NET Framework의Network 추적 참조하세요.

추가 정보

적용 대상