TcpClient.ConnectAsync 메서드

정의

네임스페이스:
System.Net.Sockets
어셈블리:
netstandard.dll, System.Net.Sockets.dll
어셈블리:
System.Net.Sockets.dll
어셈블리:
System.dll
어셈블리:
netstandard.dll

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

오버로드

Name Description
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
Source:
TCPClient.cs
Source:
TCPClient.cs
Source:
TCPClient.cs
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

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

예외

ArgumentNullException

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

ArgumentOutOfRangeException

매개 변수가 port 사이 MinPort 와 MaxPort.

SocketException

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

ObjectDisposedException

TcpClient 가 닫혀 있습니다.

OperationCanceledException

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

설명

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

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

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

메모

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

메모

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

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

추가 정보

적용 대상

ConnectAsync(IPAddress[], Int32, CancellationToken)

Source:
TCPClient.cs
Source:
TCPClient.cs
Source:
TCPClient.cs
Source:
TCPClient.cs
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

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

예외

ArgumentNullException

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

ArgumentOutOfRangeException

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

SocketException

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

ObjectDisposedException

Socket 닫혔습니다.

SecurityException

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

NotSupportedException

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

OperationCanceledException

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

설명

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

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

메모

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

메모

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

메모

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

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

추가 정보

적용 대상

ConnectAsync(IPAddress, Int32, CancellationToken)

Source:
TCPClient.cs
Source:
TCPClient.cs
Source:
TCPClient.cs
Source:
TCPClient.cs
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

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

예외

ArgumentNullException

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

ArgumentOutOfRangeException

는 port 사이 MinPort 가 아닙니다.MaxPort

SocketException

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

ObjectDisposedException

TcpClient 가 닫혀 있습니다.

OperationCanceledException

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

설명

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

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

메모

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

메모

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

메모

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

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

추가 정보

적용 대상

ConnectAsync(String, Int32)

Source:
TCPClient.cs
Source:
TCPClient.cs
Source:
TCPClient.cs
Source:
TCPClient.cs
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

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

예외

ArgumentNullException

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

ArgumentOutOfRangeException

매개 변수가 port 사이 MinPort 와 MaxPort.

SocketException

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

ObjectDisposedException

TcpClient 가 닫혀 있습니다.

설명

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

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

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

메모

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

메모

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

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

추가 정보

적용 대상

ConnectAsync(IPEndPoint, CancellationToken)

Source:
TCPClient.cs
Source:
TCPClient.cs
Source:
TCPClient.cs
Source:
TCPClient.cs
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

비동기 작업을 나타내는 작업입니다.

예외

OperationCanceledException

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

설명

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

이 메서드를 호출하여 지정된 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을 사용하도록 설정했는지 확인합니다.

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

적용 대상

ConnectAsync(IPAddress[], Int32)

Source:
TCPClient.cs
Source:
TCPClient.cs
Source:
TCPClient.cs
Source:
TCPClient.cs
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

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

예외

ArgumentNullException

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

ArgumentOutOfRangeException

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

SocketException

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

ObjectDisposedException

Socket 닫혔습니다.

SecurityException

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

NotSupportedException

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

설명

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

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

메모

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

메모

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

메모

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

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

추가 정보

적용 대상

ConnectAsync(IPAddress, Int32)

Source:
TCPClient.cs
Source:
TCPClient.cs
Source:
TCPClient.cs
Source:
TCPClient.cs
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

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

예외

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의Network 추적 참조하세요.

메모

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

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

추가 정보

적용 대상

ConnectAsync(IPEndPoint)

Source:
TCPClient.cs
Source:
TCPClient.cs
Source:
TCPClient.cs
Source:
TCPClient.cs
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

비동기 작업을 나타내는 작업입니다.

설명

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

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

메모

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

메모

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

메모

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

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

적용 대상