이 문서는 기계 번역을 이용하여 번역되었습니다. 문서를 영문으로 보려면 영문 확인란을 선택하세요. 마우스 포인터를 텍스트 위로 이동시켜 팝업 창에서 영문 텍스트를 표시할 수도 있습니다.
번역
영문

TcpClient.ConnectAsync 메서드 (String, Int32)

.NET Framework (current version)
 

게시 날짜: 2016년 11월

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

네임스페이스:   System.Net.Sockets
어셈블리:  System(System.dll에 있음)

[HostProtectionAttribute(SecurityAction.LinkDemand, ExternalThreading = true)]
public Task ConnectAsync(
	string host,
	int port
)

매개 변수

host
Type: System.String

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

port
Type: System.Int32

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

반환 값

Type: System.Threading.Tasks.Task

Task를 반환합니다.

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

Exception Condition
ArgumentNullException

hostname 매개 변수가 null인 경우

ArgumentOutOfRangeException

port 매개 변수가 MinPortMaxPort 사이에 없습니다.

SocketException

소켓에 액세스할 때 오류가 발생했습니다. 자세한 내용은 설명 부분을 참조하세요.

ObjectDisposedException

TcpClient가 닫혀 있습니다.

This operation will not block. The returned Returns T:System.Threading.Tasks.Task object will complete after the TCP connection has been established. This method does not block the calling thread while the connection request is underway.

Call this method to establish a synchronous remote host connection to the specified host name and port number as an asynchronous operation. After connecting with the remote host, use the M:System.Net.Sockets.TcpClient.GetStream method to obtain the underlying T:System.Net.Sockets.NetworkStream. Use this T:System.Net.Sockets.NetworkStream to send and receive data.

If IPv6 is enabled and the M:System.Net.Sockets.TcpClient.ConnectAsync(System.String,System.Int32) method is called to connect to a host that resolves to both IPv6 and IPv4 addresses, the connection to the IPv6 address will be attempted first before the IPv4 address. This may have the effect of delaying the time to establish the connection if the host is not listening on the IPv6 address.

System_CAPS_note참고

If you receive a T:System.Net.Sockets.SocketException, use P:System.Net.Sockets.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.

System_CAPS_note참고

This member outputs trace information when you enable network tracing in your application. For more information, see [<topic://conUsingNetworkTracing>].

.NET Framework
4.5 이후 사용 가능
맨 위로 이동
표시: