TcpClient.ConnectAsync 메서드

정의

네임스페이스:

System.Net.Sockets

어셈블리:

System.Net.Sockets.dll

지정된 호스트 이름과 포트 번호를 사용하여 비동기 작업으로 원격 TCP 호스트에 클라이언트를 연결합니다.

오버로드

ConnectAsync(String, Int32, CancellationToken)	지정된 호스트의 지정된 TCP 포트에 클라이언트를 비동기 작업으로 연결합니다.
ConnectAsync(IPAddress[], Int32, CancellationToken)	지정된 IP 주소와 포트 번호를 사용하여 비동기 작업으로 원격 TCP 호스트에 클라이언트를 연결합니다.
ConnectAsync(IPAddress, Int32, CancellationToken)	지정된 IP 주소와 포트 번호를 사용하여 비동기 작업으로 원격 TCP 호스트에 클라이언트를 연결합니다.
ConnectAsync(String, Int32)	지정된 호스트의 지정된 TCP 포트에 클라이언트를 비동기 작업으로 연결합니다.
ConnectAsync(IPEndPoint, CancellationToken)	지정된 엔드포인트를 비동기 작업으로 사용하여 클라이언트를 원격 TCP 호스트에 연결합니다.
ConnectAsync(IPAddress[], Int32)	지정된 IP 주소와 포트 번호를 사용하여 비동기 작업으로 원격 TCP 호스트에 클라이언트를 연결합니다.
ConnectAsync(IPAddress, Int32)	지정된 IP 주소와 포트 번호를 사용하여 비동기 작업으로 원격 TCP 호스트에 클라이언트를 연결합니다.
ConnectAsync(IPEndPoint)	지정된 엔드포인트를 비동기 작업으로 사용하여 클라이언트를 원격 TCP 호스트에 연결합니다.

ConnectAsync(String, Int32, CancellationToken)

Source:

TCPClient.cs

지정된 호스트의 지정된 TCP 포트에 클라이언트를 비동기 작업으로 연결합니다.

public:
 System::Threading::Tasks::ValueTask ConnectAsync(System::String ^ host, int port, System::Threading::CancellationToken cancellationToken);

public System.Threading.Tasks.ValueTask ConnectAsync (string host, int port, System.Threading.CancellationToken cancellationToken);

member this.ConnectAsync : string * int * System.Threading.CancellationToken -> System.Threading.Tasks.ValueTask

Public Function ConnectAsync (host As String, port As Integer, cancellationToken As CancellationToken) As ValueTask

매개 변수

host

String

원격 호스트의 DNS 이름입니다.

port

Int32

원격 호스트의 포트 번호입니다.

cancellationToken

CancellationToken

비동기 작업에 신호를 보내는 데 사용될 수 있는 취소 토큰은 취소되어야 합니다.

반환

ValueTask

비동기 연결 작업(operation)을 나타내는 작업(task)입니다.

예외

ArgumentNullException

host 매개 변수가 null인 경우

ArgumentOutOfRangeException

port 매개 변수가 MinPort와 MaxPort 사이에 없습니다.

SocketException

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

ObjectDisposedException

TcpClient가 닫혀 있습니다.

OperationCanceledException

취소 토큰이 취소되었습니다. 이 예외는 반환된 작업에 저장됩니다.

설명

이 작업은 차단되지 않습니다. 반환된 작업은 TCP 연결이 설정된 후에 완료됩니다. 이 메서드는 연결 요청이 진행되는 동안 호출 스레드를 차단하지 않습니다.

지정된 호스트 이름 및 포트 번호에 대한 동기 원격 호스트 연결을 비동기 작업으로 설정하려면 이 메서드를 호출합니다. 원격 호스트와 연결한 후 메서드를 GetStream 사용하여 기본 NetworkStream를 가져옵니다. 데이터를 NetworkStream 보내고 받는 데 사용합니다.

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

참고

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

참고

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

이 메서드는 메서드의 동기 대응에서 throw할 수 있는 모든 비사용 예외를 반환하는 작업에 저장됩니다. 예외가 반환된 작업에 저장되면 작업이 대기될 때 해당 예외가 throw됩니다. 와 같은 ArgumentException사용 예외는 여전히 동기적으로 throw됩니다. 저장된 예외는 에서 throw Connect(String, Int32)된 예외를 참조하세요.

추가 정보

• Connect(EndPoint)
• GetStream()

ConnectAsync(IPAddress[], Int32, CancellationToken)

Source:

TCPClient.cs

지정된 IP 주소와 포트 번호를 사용하여 비동기 작업으로 원격 TCP 호스트에 클라이언트를 연결합니다.

public:
 System::Threading::Tasks::ValueTask ConnectAsync(cli::array <System::Net::IPAddress ^> ^ addresses, int port, System::Threading::CancellationToken cancellationToken);

public System.Threading.Tasks.ValueTask ConnectAsync (System.Net.IPAddress[] addresses, int port, System.Threading.CancellationToken cancellationToken);

member this.ConnectAsync : System.Net.IPAddress[] * int * System.Threading.CancellationToken -> System.Threading.Tasks.ValueTask

Public Function ConnectAsync (addresses As IPAddress(), port As Integer, cancellationToken As CancellationToken) As ValueTask

매개 변수

addresses

IPAddress[]

원격 호스트의 IP 주소 배열입니다.

port

Int32

원격 호스트의 포트 번호입니다.

cancellationToken

CancellationToken

비동기 작업에 신호를 보내는 데 사용될 수 있는 취소 토큰은 취소되어야 합니다.

반환

ValueTask

비동기 연결 작업(operation)을 나타내는 작업(task)입니다.

예외

ArgumentNullException

ipAddresses 매개 변수가 null인 경우

ArgumentOutOfRangeException

포트 번호가 잘못된 경우

SocketException

소켓에 액세스하는 동안 오류가 발생했습니다.

ObjectDisposedException

Socket이 닫혔습니다.

SecurityException

호출 스택의 상위 호출자에게 요청된 작업을 수행할 권한이 없는 경우

NotSupportedException

이 메서드는 InterNetwork 플래그 또는 InterNetworkV6 플래그를 사용하는 소켓에 대해서만 사용할 수 있습니다.

OperationCanceledException

취소 토큰이 취소되었습니다. 이 예외는 반환된 작업에 저장됩니다.

설명

이 작업은 차단되지 않습니다. 반환된 작업은 TCP 연결이 설정된 후에 완료됩니다. 이 메서드는 연결 요청이 진행되는 동안 호출 스레드를 차단하지 않습니다.

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

참고

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

참고

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

참고

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

이 메서드는 메서드의 동기 대응에서 throw할 수 있는 모든 비사용 예외를 반환하는 작업에 저장됩니다. 예외가 반환된 작업에 저장되면 작업이 대기될 때 해당 예외가 throw됩니다. 와 같은 ArgumentException사용 예외는 여전히 동기적으로 throw됩니다. 저장된 예외는 에서 throw Connect(IPAddress[], Int32)된 예외를 참조하세요.

추가 정보

• TcpListener

ConnectAsync(IPAddress, Int32, CancellationToken)

Source:

TCPClient.cs

지정된 IP 주소와 포트 번호를 사용하여 비동기 작업으로 원격 TCP 호스트에 클라이언트를 연결합니다.

public:
 System::Threading::Tasks::ValueTask ConnectAsync(System::Net::IPAddress ^ address, int port, System::Threading::CancellationToken cancellationToken);

public System.Threading.Tasks.ValueTask ConnectAsync (System.Net.IPAddress address, int port, System.Threading.CancellationToken cancellationToken);

member this.ConnectAsync : System.Net.IPAddress * int * System.Threading.CancellationToken -> System.Threading.Tasks.ValueTask

Public Function ConnectAsync (address As IPAddress, port As Integer, cancellationToken As CancellationToken) As ValueTask

매개 변수

address

IPAddress

원격 호스트의 IP 주소입니다.

port

Int32

원격 호스트의 포트 번호입니다.

cancellationToken

CancellationToken

비동기 작업에 신호를 보내는 데 사용될 수 있는 취소 토큰은 취소되어야 합니다.

반환

ValueTask

비동기 연결 작업(operation)을 나타내는 작업(task)입니다.

예외

ArgumentNullException

address 매개 변수가 null인 경우

ArgumentOutOfRangeException

port가 MinPort와 MaxPort 사이에 없는 경우

SocketException

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

ObjectDisposedException

TcpClient가 닫혀 있습니다.

OperationCanceledException

취소 토큰이 취소되었습니다. 이 예외는 반환된 작업에 저장됩니다.

설명

이 작업은 차단되지 않습니다. 반환된 작업은 TCP 연결이 설정된 후에 완료됩니다. 이 메서드는 연결 요청이 진행되는 동안 호출 스레드를 차단하지 않습니다.

이 메서드를 호출하여 지정된 IP 주소 및 포트 번호에 대한 동기 원격 호스트 연결을 비동기 작업으로 설정합니다. 원격 호스트와 연결한 후 메서드를 GetStream 사용하여 기본 NetworkStream를 가져옵니다. 데이터를 NetworkStream 보내고 받는 데 사용합니다.

참고

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

참고

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

참고

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

이 메서드는 메서드의 동기 대응에서 throw할 수 있는 모든 비사용 예외를 반환하는 작업에 저장됩니다. 예외가 반환된 작업에 저장되면 작업이 대기될 때 해당 예외가 throw됩니다. 와 같은 ArgumentException사용 예외는 여전히 동기적으로 throw됩니다. 저장된 예외는 에서 throw Connect(IPAddress, Int32)된 예외를 참조하세요.

추가 정보

• GetStream()

ConnectAsync(String, Int32)

Source:

TCPClient.cs

지정된 호스트의 지정된 TCP 포트에 클라이언트를 비동기 작업으로 연결합니다.

public:
 System::Threading::Tasks::Task ^ ConnectAsync(System::String ^ host, int port);

public System.Threading.Tasks.Task ConnectAsync (string host, int port);

member this.ConnectAsync : string * int -> System.Threading.Tasks.Task

Public Function ConnectAsync (host As String, port As Integer) As Task

매개 변수

host

String

연결할 원격 호스트의 DNS 이름입니다.

port

Int32

연결한 원격 호스트의 포트 번호입니다.

반환

Task

비동기 작업(operation)을 나타내는 작업(task) 개체입니다.

예외

ArgumentNullException

host 매개 변수가 null인 경우

ArgumentOutOfRangeException

port 매개 변수가 MinPort와 MaxPort 사이에 없습니다.

SocketException

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

ObjectDisposedException

TcpClient가 닫혀 있습니다.

설명

이 작업은 차단되지 않습니다. 반환된 Returns Task 개체는 TCP 연결이 설정된 후에 완료됩니다. 이 메서드는 연결 요청이 진행되는 동안 호출 스레드를 차단하지 않습니다.

지정된 호스트 이름 및 포트 번호에 대한 동기 원격 호스트 연결을 비동기 작업으로 설정하려면 이 메서드를 호출합니다. 원격 호스트와 연결한 후 메서드를 GetStream 사용하여 기본 NetworkStream를 가져옵니다. 데이터를 NetworkStream 보내고 받는 데 사용합니다.

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

참고

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

참고

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

이 메서드는 메서드의 동기 대응에서 throw할 수 있는 모든 비사용 예외를 반환하는 작업에 저장됩니다. 예외가 반환된 작업에 저장되면 작업이 대기될 때 해당 예외가 throw됩니다. 와 같은 ArgumentException사용 예외는 여전히 동기적으로 throw됩니다. 저장된 예외는 에서 throw Connect(String, Int32)된 예외를 참조하세요.

추가 정보

• Connect(EndPoint)
• GetStream()

ConnectAsync(IPEndPoint, CancellationToken)

Source:

TCPClient.cs

지정된 엔드포인트를 비동기 작업으로 사용하여 클라이언트를 원격 TCP 호스트에 연결합니다.

public:
 System::Threading::Tasks::ValueTask ConnectAsync(System::Net::IPEndPoint ^ remoteEP, System::Threading::CancellationToken cancellationToken);

public System.Threading.Tasks.ValueTask ConnectAsync (System.Net.IPEndPoint remoteEP, System.Threading.CancellationToken cancellationToken);

member this.ConnectAsync : System.Net.IPEndPoint * System.Threading.CancellationToken -> System.Threading.Tasks.ValueTask

Public Function ConnectAsync (remoteEP As IPEndPoint, cancellationToken As CancellationToken) As ValueTask

매개 변수

remoteEP

IPEndPoint

연결할 IPEndPoint입니다.

cancellationToken

CancellationToken

이 작업을 취소해야 한다는 알림을 전파하는 데 사용되는 취소 토큰입니다.

반환

ValueTask

비동기 작업(operation)을 나타내는 작업(task)입니다.

예외

OperationCanceledException

취소 토큰이 취소되었습니다. 이 예외는 반환된 작업에 저장됩니다.

설명

이 작업은 차단되지 않습니다. 반환된 Returns Task 개체는 TCP 연결이 설정된 후에 완료됩니다. 이 메서드는 연결 요청이 진행되는 동안 호출 스레드를 차단하지 않습니다.

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

참고

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

참고

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

참고

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

이 메서드는 메서드의 동기 대응에서 throw할 수 있는 모든 비사용 예외를 반환하는 작업에 저장됩니다. 예외가 반환된 작업에 저장되면 작업이 대기될 때 해당 예외가 throw됩니다. 와 같은 ArgumentException사용 예외는 여전히 동기적으로 throw됩니다. 저장된 예외는 에서 throw Connect(IPEndPoint)된 예외를 참조하세요.

ConnectAsync(IPAddress[], Int32)

Source:

TCPClient.cs

지정된 IP 주소와 포트 번호를 사용하여 비동기 작업으로 원격 TCP 호스트에 클라이언트를 연결합니다.

public:
 System::Threading::Tasks::Task ^ ConnectAsync(cli::array <System::Net::IPAddress ^> ^ addresses, int port);

public System.Threading.Tasks.Task ConnectAsync (System.Net.IPAddress[] addresses, int port);

member this.ConnectAsync : System.Net.IPAddress[] * int -> System.Threading.Tasks.Task

Public Function ConnectAsync (addresses As IPAddress(), port As Integer) As Task

매개 변수

addresses

IPAddress[]

연결할 호스트의 IPAddress 배열입니다.

port

Int32

연결할 포트 번호입니다.

반환

Task

비동기 작업(operation)을 나타내는 작업(task) 개체입니다.

예외

ArgumentNullException

ipAddresses 매개 변수가 null인 경우

ArgumentOutOfRangeException

포트 번호가 잘못된 경우

SocketException

소켓에 액세스하는 동안 오류가 발생했습니다.

ObjectDisposedException

Socket이 닫혔습니다.

SecurityException

호출 스택의 상위 호출자에게 요청된 작업을 수행할 권한이 없는 경우

NotSupportedException

이 메서드는 InterNetwork 플래그 또는 InterNetworkV6 플래그를 사용하는 소켓에 대해서만 사용할 수 있습니다.

설명

이 작업은 차단되지 않습니다. 반환된 Returns Task 개체는 TCP 연결이 설정된 후에 완료됩니다. 이 메서드는 연결 요청이 진행되는 동안 호출 스레드를 차단하지 않습니다.

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

참고

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

참고

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

참고

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

이 메서드는 메서드의 동기 대응에서 throw할 수 있는 모든 비사용 예외를 반환하는 작업에 저장됩니다. 예외가 반환된 작업에 저장되면 작업이 대기될 때 해당 예외가 throw됩니다. 와 같은 ArgumentException사용 예외는 여전히 동기적으로 throw됩니다. 저장된 예외는 에서 throw Connect(IPAddress[], Int32)된 예외를 참조하세요.

추가 정보

• TcpListener

ConnectAsync(IPAddress, Int32)

Source:

TCPClient.cs

지정된 IP 주소와 포트 번호를 사용하여 비동기 작업으로 원격 TCP 호스트에 클라이언트를 연결합니다.

public:
 System::Threading::Tasks::Task ^ ConnectAsync(System::Net::IPAddress ^ address, int port);

public System.Threading.Tasks.Task ConnectAsync (System.Net.IPAddress address, int port);

member this.ConnectAsync : System.Net.IPAddress * int -> System.Threading.Tasks.Task

Public Function ConnectAsync (address As IPAddress, port As Integer) As Task

매개 변수

address

IPAddress

연결할 호스트의 IPAddress입니다.

port

Int32

연결할 포트 번호입니다.

반환

Task

비동기 작업(operation)을 나타내는 작업(task) 개체입니다.

예외

ArgumentNullException

address 매개 변수가 null인 경우

ArgumentOutOfRangeException

port가 MinPort와 MaxPort 사이에 없는 경우

SocketException

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

ObjectDisposedException

TcpClient가 닫혀 있습니다.

설명

이 작업은 차단되지 않습니다. 반환된 Returns Task 개체는 TCP 연결이 설정된 후에 완료됩니다. 이 메서드는 연결 요청이 진행되는 동안 호출 스레드를 차단하지 않습니다.

지정된 IPAddress 및 포트 번호에 대한 동기 원격 호스트 연결을 비동기 작업으로 설정하려면 이 메서드를 호출합니다. 원격 호스트와 연결한 후 메서드를 GetStream 사용하여 기본 NetworkStream를 가져옵니다. 이를 NetworkStream 사용하여 데이터를 보내고 받습니다.

참고

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

참고

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

참고

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

이 메서드는 메서드의 동기 대응에서 throw할 수 있는 모든 비사용 예외를 반환하는 태스크에 저장됩니다. 예외가 반환된 작업에 저장되면 작업이 대기될 때 해당 예외가 throw됩니다. 와 같은 ArgumentException사용 예외는 여전히 동기적으로 throw됩니다. 저장된 예외는 에서 throw Connect(IPAddress, Int32)된 예외를 참조하세요.

추가 정보

• GetStream()

ConnectAsync(IPEndPoint)

Source:

TCPClient.cs

지정된 엔드포인트를 비동기 작업으로 사용하여 클라이언트를 원격 TCP 호스트에 연결합니다.

public:
 System::Threading::Tasks::Task ^ ConnectAsync(System::Net::IPEndPoint ^ remoteEP);

public System.Threading.Tasks.Task ConnectAsync (System.Net.IPEndPoint remoteEP);

member this.ConnectAsync : System.Net.IPEndPoint -> System.Threading.Tasks.Task

Public Function ConnectAsync (remoteEP As IPEndPoint) As Task

매개 변수

remoteEP

IPEndPoint

연결할 IPEndPoint입니다.

반환

Task

비동기 작업(operation)을 나타내는 작업(task)입니다.

설명

이 작업은 차단되지 않습니다. 반환 Task 된 개체는 TCP 연결이 설정된 후 완료됩니다. 이 메서드는 연결 요청이 진행되는 동안 호출 스레드를 차단하지 않습니다.

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

참고

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

참고

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

참고

IPv6 주소를 사용하는 동안 "이 프로토콜 버전은 지원되지 않습니다"라는 메시지가 포함된 를 수신 NotSupportedException 하는 경우 를 전달 InterNetworkV6하여 생성자에서 IPv6을 사용하도록 설정했는지 확인합니다.

이 메서드는 메서드의 동기 대응에서 throw할 수 있는 모든 비사용 예외를 반환하는 태스크에 저장됩니다. 예외가 반환된 작업에 저장되면 작업이 대기될 때 해당 예외가 throw됩니다. 와 같은 ArgumentException사용 예외는 여전히 동기적으로 throw됩니다. 저장된 예외는 에서 throw Connect(IPEndPoint)된 예외를 참조하세요.