TcpListener.AcceptTcpClientAsync 메서드

정의

네임스페이스:

System.Net.Sockets

어셈블리:

System.Net.Sockets.dll

오버로드

AcceptTcpClientAsync()	보류 중인 연결 요청을 비동기 작업으로 허용합니다.
AcceptTcpClientAsync(CancellationToken)	보류 중인 연결 요청을 취소 가능한 비동기 작업으로 허용합니다.

AcceptTcpClientAsync()

Source:

TCPListener.cs

보류 중인 연결 요청을 비동기 작업으로 허용합니다.

public:
 System::Threading::Tasks::Task<System::Net::Sockets::TcpClient ^> ^ AcceptTcpClientAsync();

public System.Threading.Tasks.Task<System.Net.Sockets.TcpClient> AcceptTcpClientAsync ();

member this.AcceptTcpClientAsync : unit -> System.Threading.Tasks.Task<System.Net.Sockets.TcpClient>

Public Function AcceptTcpClientAsync () As Task(Of TcpClient)

반환

Task<TcpClient>

비동기 작업(operation)을 나타내는 작업(task) 개체입니다. 작업 개체의 Result 속성은 데이터를 보내고 받는 데 사용하는 TcpClient을 반환합니다.

예외

InvalidOperationException

Start()의 호출과 함께 수신기가 시작하지 않은 경우

SocketException

ErrorCode 속성을 사용하여 특정 오류 코드를 가져오십시오. 이 코드를 가져온 다음, Windows 소켓 버전 2 API 오류 코드 설명서에서 오류에 대한 자세한 설명을 참조할 수 있습니다.

설명

이 작업은 차단되지 않습니다. 반환 Task<TResult> 된 개체는 TCP 연결이 수락된 후 완료됩니다.

메서드를 TcpClient.GetStream 사용하여 에서 반환 TcpClient 된 의 기본 NetworkStream 을 Task<TResult>가져옵니다. 는 NetworkStream 원격 호스트를 사용하여 보내고 받는 메서드를 제공합니다. 를 사용하는 경우 메서드 Close 를 TcpClient호출해야 합니다. 제안보다 TcpClient 더 많은 유연성을 원하는 경우 또는 AcceptSocketAsync를 사용하는 AcceptSocket 것이 좋습니다.

참고

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

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

추가 정보

• TcpClient
• AcceptSocket()
• Socket
• NetworkStream

AcceptTcpClientAsync(CancellationToken)

Source:

TCPListener.cs

보류 중인 연결 요청을 취소 가능한 비동기 작업으로 허용합니다.

public:
 System::Threading::Tasks::ValueTask<System::Net::Sockets::TcpClient ^> AcceptTcpClientAsync(System::Threading::CancellationToken cancellationToken);

public System.Threading.Tasks.ValueTask<System.Net.Sockets.TcpClient> AcceptTcpClientAsync (System.Threading.CancellationToken cancellationToken);

member this.AcceptTcpClientAsync : System.Threading.CancellationToken -> System.Threading.Tasks.ValueTask<System.Net.Sockets.TcpClient>

Public Function AcceptTcpClientAsync (cancellationToken As CancellationToken) As ValueTask(Of TcpClient)

매개 변수

cancellationToken

CancellationToken

비동기 작업을 취소하는 데 사용할 수 있는 취소 토큰

반환

ValueTask<TcpClient>

비동기 작업(operation)을 나타내는 작업(task) 개체입니다. 작업 개체의 Result 속성은 데이터를 보내고 받는 데 사용하는 TcpClient을 반환합니다.

예외

OperationCanceledException

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

설명

이 작업은 차단되지 않습니다. 반환 Task<TResult> 된 개체는 TCP 연결이 수락된 후 완료됩니다.

메서드를 TcpClient.GetStream 사용하여 에서 반환 TcpClient 된 의 기본 NetworkStream 을 Task<TResult>가져옵니다. 는 NetworkStream 원격 호스트를 사용하여 보내고 받는 메서드를 제공합니다. 를 사용하는 경우 메서드 Close 를 TcpClient호출해야 합니다. 제안보다 TcpClient 더 많은 유연성을 원하는 경우 또는 AcceptSocketAsync를 사용하는 AcceptSocket 것이 좋습니다.

참고

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

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