TcpListener.AcceptTcpClientAsync 메서드

정의

오버로드

AcceptTcpClientAsync()

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

AcceptTcpClientAsync(CancellationToken)

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

AcceptTcpClientAsync()

Source:
TCPListener.cs
Source:
TCPListener.cs
Source:
TCPListener.cs

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

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

반환

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

예외

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

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

설명

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

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

참고

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

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

추가 정보

적용 대상

.NET 9 및 기타 버전
제품 버전
.NET Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 1.3, 1.4, 1.6, 2.0, 2.1

AcceptTcpClientAsync(CancellationToken)

Source:
TCPListener.cs
Source:
TCPListener.cs
Source:
TCPListener.cs

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

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

매개 변수

cancellationToken
CancellationToken

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

반환

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

예외

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

설명

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

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

참고

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

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

적용 대상

.NET 9 및 기타 버전
제품 버전
.NET 6, 7, 8, 9