학습
모듈
C#을 사용하여 .NET 클래스 라이브러리의 메서드 호출 - Training
값 반환, 입력 매개 변수 허용 등을 수행하는 메서드를 호출하여 .NET 클래스 라이브러리의 기능을 사용합니다.
IAsyncResult 디자인 패턴을 사용하는 비동기 작업은 각각 비동기 작업 OperationName을 시작하고 종료하는 BeginOperationName
및 EndOperationName
이라는 두 개의 메서드로 구현됩니다. 예를 들어 FileStream 클래스는 파일에서 바이트를 비동기적으로 읽는 BeginRead 및 EndRead 메서드를 제공합니다. 이러한 메서드는 비동기 버전의 Read 메서드를 구현합니다.
참고
.NET Framework 4부터는 작업 병렬 라이브러리에서 비동기 및 병렬 프로그래밍을 위한 새로운 모델을 제공합니다. 자세한 내용은 TPL(작업 병렬 라이브러리) 및 TAP(작업 기반 비동기 패턴)을 참조하세요.
BeginOperationName
을 호출한 후에는 비동기 작업이 다른 스레드에서 발생되는 동안 애플리케이션에서 호출 스레드에 대한 명령을 계속 실행할 수 있습니다. BeginOperationName
에 대한 각 호출에 대해 애플리케이션도 EndOperationName
을 호출하여 작업 결과를 가져와야 합니다.
BeginOperationName
메서드는 비동기 작업 OperationName을 시작하고 IAsyncResult 인터페이스를 구현하는 개체를 반환합니다. IAsyncResult 개체는 비동기 작업에 대한 정보를 저장합니다. 다음 표에서는 비동기 작업에 대한 정보를 보여 줍니다.
멤버 | 설명 |
---|---|
AsyncState | 비동기 작업에 대한 정보를 포함하는 애플리케이션별 선택적 개체입니다. |
AsyncWaitHandle | 비동기 작업이 완료될 때까지 애플리케이션 실행을 차단하기 위해 사용할 수 있는 WaitHandle 입니다. |
CompletedSynchronously | 비동기 작업이 별도의 ThreadPool 스레드에서 완료되는 대신 BeginOperationName 을 호출하는 데 사용된 스레드에서 완료되었는지 여부를 나타내는 값입니다. |
IsCompleted | 비동기 작업이 완료되었는지 여부를 나타내는 값입니다. |
BeginOperationName
메서드에는 값 또는 참조로 전달되는 동기 버전의 메서드 시그니처에 선언된 매개 변수가 사용됩니다. out 매개 변수는 BeginOperationName
메서드 시그니처의 일부가 아닙니다. BeginOperationName
메서드 시그니처에는 두 개의 추가 매개 변수도 포함되어 있습니다. 그중 첫 번째 매개 변수는 비동기 작업이 완료될 때 호출되는 메서드를 참조하는 AsyncCallback 대리자를 정의합니다. 호출자는 작업이 완료될 때 호출되는 메서드를 원하지 않는 경우 null
(Visual Basic에서는Nothing
)을 지정할 수 있습니다. 두 번째 추가 매개 변수는 사용자 정의 개체입니다. 이 개체를 사용하여 비동기 작업이 완료될 때 호출되는 메서드로 애플리케이션별 상태 정보를 전달할 수 있습니다. 파일에서 읽은 바이트를 저장하는 바이트 배열과 같이 BeginOperationName
메서드에서 작업 관련 추가 매개 변수를 사용하는 경우 AsyncCallback 및 애플리케이션 상태 개체는 BeginOperationName
메서드 시그니처의 마지막 매개 변수가 됩니다.
BeginOperationName
은 호출 스레드에 대한 컨트롤을 즉시 반환합니다. BeginOperationName
메서드가 예외를 throw하면 이 예외는 이 비동기 작업이 시작되기 전에 throw됩니다. BeginOperationName
메서드가 예외를 throw하면 콜백 메서드는 호출되지 않습니다.
EndOperationName
메서드는 비동기 작업 OperationName을 종료합니다. EndOperationName
메서드의 반환 값은 이에 상응하는 동기 항목의 반환 값과 같은 유형으로서 비동기 작업에 대해서만 사용됩니다. 예를 들어 EndRead 메서드는 FileStream 에서 읽은 바이트 수를 반환하고 EndGetHostByName 메서드는 호스트 컴퓨터에 대한 정보를 포함하는 IPHostEntry 개체를 반환합니다. EndOperationName
메서드는 동기 버전의 메서드 시그니처에 선언된 out 또는 ref 매개 변수를 사용합니다. EndOperationName
메서드에는 동기 메서드의 매개 변수와 함께 IAsyncResult 매개 변수도 포함되어 있습니다. 호출자는 BeginOperationName
에 대한 해당 호출로 반환된 인스턴스를 전달해야 합니다.
EndOperationName
이 호출되었을 때 IAsyncResult 개체에 표시되는 비동기 작업이 완료되지 않은 경우에는 EndOperationName
에서 비동기 작업이 완료될 때까지 해당 호출 스레드를 차단합니다. 비동기 작업이 throw한 예외는 EndOperationName
메서드에서 throw됩니다. 같은 IAsyncResult로 EndOperationName
메서드를 여러 번 호출한 데 따른 효과는 정의되어 있지 않습니다. 마찬가지로 관련된 Begin 메서드에서 반환하지 않은 IAsyncResult로 EndOperationName
메서드를 호출하는 경우도 정의되어 있지 않습니다.
참고
정의되지 않은 두 시나리오 중 하나의 경우 구현자는 InvalidOperationException을 throw하는 것을 고려해야 합니다.
참고
이 디자인 패턴의 구현자는 IsCompleted 를 true로 설정하여 비동기 콜백 메서드(지정된 경우)를 호출하고 AsyncWaitHandle을 신호로 보내서 비동기 작업이 완료되었다는 것을 호출자에게 알려야 합니다.
애플리케이션 개발자는 비동기 작업의 결과에 액세스하기 위해 여러 디자인을 선택할 수 있습니다. 어떤 선택이 올바른 선택인지는 애플리케이션에 작업이 완료되는 동안 실행할 수 있는 지침이 있는지 여부에 따라 달라집니다. 비동기 작업의 결과를 받을 때까지 애플리케이션이 추가 작업을 수행할 수 없는 경우 결과를 사용할 수 있을 때까지 애플리케이션을 차단해야 합니다. 비동기 작업이 완료될 때까지 차단하려면 다음 방법 중 하나를 사용하면 됩니다.
애플리케이션의 주 스레드에서 EndOperationName
을 호출하여 작업이 완료될 때까지 애플리케이션 실행을 차단합니다. 이 기술을 설명하는 예제는 비동기 작업을 종료하여 애플리케이션 실행 차단을 참조하세요.
AsyncWaitHandle 을 사용하여 하나 이상의 작업이 완료될 때까지 애플리케이션 실행을 차단할 수 있습니다. 이 방법을 설명하는 예제는 Blocking Application Execution Using an AsyncWaitHandle을 참조하세요.
비동기 작업이 완료되는 동안 차단할 필요가 없는 애플리케이션은 다음 방법 중 하나를 사용할 수 있습니다.
주기적으로 IsCompleted 속성을 확인하고 작업이 완료되면 EndOperationName
을 호출하여 작업 완료 상태를 폴링합니다. 이 방법을 설명하는 예제는 비동기 작업의 상태에 대한 폴링을 참조하세요.
AsyncCallback 대리자를 사용하여 작업이 완료될 때 호출할 메서드를 지정합니다. 이 방법을 설명하는 예제는 AsyncCallback 대리자를 사용하여 비동기 작업 종료를 참조하세요.
.NET 피드백
.NET은(는) 오픈 소스 프로젝트입니다. 다음 링크를 선택하여 피드백을 제공해 주세요.
학습
모듈
C#을 사용하여 .NET 클래스 라이브러리의 메서드 호출 - Training
값 반환, 입력 매개 변수 허용 등을 수행하는 메서드를 호출하여 .NET 클래스 라이브러리의 기능을 사용합니다.