TcpListener.AcceptSocketAsync 메서드

  • 참조

정의

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

오버로드

AcceptSocketAsync()

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

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

AcceptSocketAsync()

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

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

public:
 System::Threading::Tasks::Task<System::Net::Sockets::Socket ^> ^ AcceptSocketAsync();
public System.Threading.Tasks.Task<System.Net.Sockets.Socket> AcceptSocketAsync ();
member this.AcceptSocketAsync : unit -> System.Threading.Tasks.Task<System.Net.Sockets.Socket>
Public Function AcceptSocketAsync () As Task(Of Socket)

반환

Task<Socket>

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

예외

InvalidOperationException

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

설명

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

에서 Task<TResult> 반환된 는 Socket 원격 호스트의 IP 주소 및 포트 번호로 초기화됩니다. 클래스에서 Send 사용할 수 있는 및 Receive 메서드를 Socket 사용하여 원격 호스트와 통신할 수 있습니다. 사용을 마치면 메서드 Close 를 Socket호출해야 합니다. 애플리케이션이 비교적 단순한 경우 사용을 고려 합니다 AcceptTcpClient 메서드 대신 AcceptSocketAsync 메서드. TcpClient 는 동기 모드를 차단하여 네트워크를 통해 데이터를 보내고 받는 간단한 방법을 제공합니다.

참고

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

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

추가 정보

적용 대상

AcceptSocketAsync(CancellationToken)

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

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

public:
 System::Threading::Tasks::ValueTask<System::Net::Sockets::Socket ^> AcceptSocketAsync(System::Threading::CancellationToken cancellationToken);
public System.Threading.Tasks.ValueTask<System.Net.Sockets.Socket> AcceptSocketAsync (System.Threading.CancellationToken cancellationToken);
member this.AcceptSocketAsync : System.Threading.CancellationToken -> System.Threading.Tasks.ValueTask<System.Net.Sockets.Socket>
Public Function AcceptSocketAsync (cancellationToken As CancellationToken) As ValueTask(Of Socket)

매개 변수

cancellationToken
CancellationToken

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

반환

ValueTask<Socket>

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

예외

OperationCanceledException

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

설명

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

에서 Task<TResult> 반환된 는 Socket 원격 호스트의 IP 주소 및 포트 번호로 초기화됩니다. 클래스에서 Send 사용할 수 있는 및 Receive 메서드를 Socket 사용하여 원격 호스트와 통신할 수 있습니다. 사용을 마치면 메서드 Close 를 Socket호출해야 합니다. 애플리케이션이 비교적 단순한 경우 사용을 고려 합니다 AcceptTcpClient 메서드 대신 AcceptSocketAsync 메서드. TcpClient 는 동기 모드를 차단하여 네트워크를 통해 데이터를 보내고 받는 간단한 방법을 제공합니다.

참고

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

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

적용 대상