Socket.EndReceive 메서드

정의

네임스페이스:

System.Net.Sockets

어셈블리:

netstandard.dll, System.Net.Sockets.dll

보류 중인 비동기 읽기를 종료합니다.

오버로드

Name	Description
EndReceive(IAsyncResult)	보류 중인 비동기 읽기를 종료합니다.
EndReceive(IAsyncResult, SocketError)	보류 중인 비동기 읽기를 종료합니다.

EndReceive(IAsyncResult)

Source:

Socket.cs

보류 중인 비동기 읽기를 종료합니다.

public:
 int EndReceive(IAsyncResult ^ asyncResult);

public int EndReceive(IAsyncResult asyncResult);

member this.EndReceive : IAsyncResult -> int

Public Function EndReceive (asyncResult As IAsyncResult) As Integer

매개 변수

asyncResult

IAsyncResult

IAsyncResult 이 비동기 작업에 대한 상태 정보 및 사용자 정의 데이터를 저장하는 것입니다.

반환

Int32

받은 총 바이트 수입니다. 이 메서드는 0바이트가 요청되었거나 피어 소켓이 정상적인 종료를 수행했기 때문에 더 이상 바이트를 사용할 수 없는 경우에만 0을 반환합니다. 0바이트가 요청되면 수신 작업이 즉시 완료되거나 하나 이상의 바이트를 사용할 수 있을 때까지 완료되지 않을 수 있습니다(데이터를 사용하지 않음).

예외

ArgumentNullException

asyncResult은 null입니다.

ArgumentException

asyncResult 가 메서드 호출에 BeginReceive(Byte[], Int32, Int32, SocketFlags, AsyncCallback, Object) 의해 반환되지 않았습니다.

InvalidOperationException

EndReceive(IAsyncResult) 는 이전에 비동기 읽기에 대해 호출되었습니다.

SocketException

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

-또는-

.NET 7 이상만: Socket 닫혔습니다.

ObjectDisposedException

.NET Framework, .NET Core 및 .NET 5-6만 해당: Socket 닫혔습니다.

설명

중요합니다

호환성 API입니다. 새 개발에 APM (Begin* 및 End*) 메서드를 사용하지 않는 것이 좋습니다. 대신에 -based equivalents Task를 사용합니다.

EndReceive 에서 시작한 작업을 완료합니다 BeginReceive. 일치하는 BeginReceive 호출을 IAsyncResult 통해 만든 항목을 전달해야 합니다.

이 메서드는 EndReceive 데이터를 사용할 수 있을 때까지 차단됩니다. 연결 없는 프로토콜 EndReceive 을 사용하는 경우 들어오는 네트워크 버퍼에서 사용할 수 있는 첫 번째 큐에 추가된 데이터그램을 읽습니다. 연결 지향 프로토콜 EndReceive 을 사용하는 경우 메서드는 메서드의 매개 변수에 지정한 바이트 수까지 사용할 수 있는 size 만큼의 BeginReceive 데이터를 읽습니다. 원격 호스트가 메서드와의 Shutdown 연결을 종료 Socket 하고 사용 가능한 모든 데이터를 받은 EndReceive 경우 메서드는 즉시 완료되고 0바이트를 반환합니다.

메모

받는 SocketException경우 속성을 사용하여 SocketException.ErrorCode 특정 오류 코드를 가져옵니다.

메모

지정된 스레드에서 시작한 모든 I/O는 해당 스레드가 종료될 때 취소됩니다. 작업이 완료되기 전에 스레드가 종료되면 보류 중인 비동기 작업이 실패할 수 있습니다.

메모

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

추가 정보

• BeginReceive(Byte[], Int32, Int32, SocketFlags, AsyncCallback, Object)
• AsyncCallback
• IAsyncResult
• AsyncState
• Shutdown(SocketShutdown)

EndReceive(IAsyncResult, SocketError)

Source:

Socket.cs

보류 중인 비동기 읽기를 종료합니다.

public:
 int EndReceive(IAsyncResult ^ asyncResult, [Runtime::InteropServices::Out] System::Net::Sockets::SocketError % errorCode);

public int EndReceive(IAsyncResult asyncResult, out System.Net.Sockets.SocketError errorCode);

member this.EndReceive : IAsyncResult * SocketError -> int

Public Function EndReceive (asyncResult As IAsyncResult, ByRef errorCode As SocketError) As Integer

매개 변수

asyncResult

IAsyncResult

IAsyncResult 이 비동기 작업에 대한 상태 정보 및 사용자 정의 데이터를 저장하는 것입니다.

errorCode

SocketError

SocketError 소켓 오류를 저장하는 개체입니다.

반환

Int32

받은 총 바이트 수입니다. 이 메서드는 0바이트가 요청되었거나 피어 소켓이 정상적인 종료를 수행했기 때문에 더 이상 바이트를 사용할 수 없는 경우에만 0을 반환합니다. 0바이트가 요청되면 수신 작업이 즉시 완료되거나 하나 이상의 바이트를 사용할 수 있을 때까지 완료되지 않을 수 있습니다(데이터를 사용하지 않음).

예외

ArgumentNullException

asyncResult은 null입니다.

ArgumentException

asyncResult 가 메서드 호출에 BeginReceive(Byte[], Int32, Int32, SocketFlags, AsyncCallback, Object) 의해 반환되지 않았습니다.

InvalidOperationException

EndReceive(IAsyncResult) 는 이전에 비동기 읽기에 대해 호출되었습니다.

SocketException

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

-또는-

.NET 7 이상만: Socket 닫혔습니다.

ObjectDisposedException

.NET Framework, .NET Core 및 .NET 5-6만 해당: Socket 닫혔습니다.

설명

중요합니다

호환성 API입니다. 새 개발에 APM (Begin* 및 End*) 메서드를 사용하지 않는 것이 좋습니다. 대신에 -based equivalents Task를 사용합니다.

EndReceive 에서 시작한 작업을 완료합니다 BeginReceive. 일치하는 BeginReceive 호출을 IAsyncResult 통해 만든 항목을 전달해야 합니다.

이 메서드는 EndReceive 데이터를 사용할 수 있을 때까지 차단됩니다. 연결 없는 프로토콜 EndReceive 을 사용하는 경우 들어오는 네트워크 버퍼에서 사용할 수 있는 첫 번째 큐에 추가된 데이터그램을 읽습니다. 연결 지향 프로토콜 EndReceive 을 사용하는 경우 메서드는 메서드의 매개 변수에 지정한 바이트 수까지 사용할 수 있는 size 만큼의 BeginReceive 데이터를 읽습니다. 원격 호스트가 메서드와의 Shutdown 연결을 종료 Socket 하고 사용 가능한 모든 데이터를 받은 EndReceive 경우 메서드는 즉시 완료되고 0바이트를 반환합니다.

메모

받는 SocketException경우 속성을 사용하여 SocketException.ErrorCode 특정 오류 코드를 가져옵니다.

메모

지정된 스레드에서 시작한 모든 I/O는 해당 스레드가 종료될 때 취소됩니다. 작업이 완료되기 전에 스레드가 종료되면 보류 중인 비동기 작업이 실패할 수 있습니다.

메모

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

추가 정보

• BeginReceive(Byte[], Int32, Int32, SocketFlags, AsyncCallback, Object)
• AsyncCallback
• IAsyncResult
• AsyncState
• Shutdown(SocketShutdown)