async(C# 참조)

아티클
03/22/2023

async 한정자를 사용하여 메서드, 람다 식 또는 무명 메서드를 비동기로 지정합니다. 메서드 또는 식에 이 한정자를 사용하면 비동기 메서드라고 합니다. 다음 예제에서는 ExampleMethodAsync라는 비동기 메서드를 정의합니다.

public async Task<int> ExampleMethodAsync()
{
    //...
}

비동기 프로그래밍이 처음이거나 비동기 메서드가 await 연산자를 사용하여 호출자의 스레드를 차단하지 않고 장기 실행 작업을 수행할 수 있는 방법을 잘 모르겠으면 async 및 await를 사용한 비동기 프로그래밍의 소개 내용을 참조하세요. 다음 코드는 비동기 메서드 안에 있으며 HttpClient.GetStringAsync 메서드를 호출합니다.

string contents = await httpClient.GetStringAsync(requestUrl);

비동기 메서드는 대기 중인 작업이 완료될 때까지 메서드가 일시 중단되는 지점인 첫 번째 await 식에 도달하기 전에는 동기적으로 실행됩니다. 다음 단원의 예제에서처럼 그 동안에는 제어가 메서드 호출자에게 반환됩니다.

async 키워드에서 수정하는 메서드에 await 식 또는 문이 없는 경우 해당 메서드가 동기적으로 실행됩니다. await 문이 포함되지 않은 모든 비동기 메서드에서는 오류가 발생할 수 있으므로 컴파일러 경고가 나타납니다. 컴파일러 경고(수준 1) CS4014를 참조하세요.

async 키워드는 메서드, 람다 식 또는 무명 메서드를 수정할 때만 키워드로 사용됩니다. 다른 모든 컨텍스트에서는 식별자로 해석됩니다.

예제

다음 예제에서는 비동기 이벤트 처리기, StartButton_Click, 비동기 메서드 및 ExampleMethodAsync 간의 제어 흐름과 구조를 보여 줍니다. 비동기 메서드의 결과는 웹 페이지의 문자 수입니다. 이 코드는 Visual Studio에서 만든 WPF(Windows Presentation Foundation) 앱 또는 Windows 스토어 앱에 적합합니다. 앱을 설정하는 방법은 코드 주석을 참조하세요.

Visual Studio에서 이 코드를 WPF(Windows Presentation Foundation) 앱 또는 Windows 스토어 앱으로 실행할 수 있습니다. StartButton이라는 Button 컨트롤과 ResultsTextBox라는 Textbox 컨트롤이 필요합니다. 다음과 같이 작성되도록 이름과 처리기를 설정해야 합니다.

<Button Content="Button" HorizontalAlignment="Left" Margin="88,77,0,0" VerticalAlignment="Top" Width="75"
        Click="StartButton_Click" Name="StartButton"/>
<TextBox HorizontalAlignment="Left" Height="137" Margin="88,140,0,0" TextWrapping="Wrap"
         Text="&lt;Enter a URL&gt;" VerticalAlignment="Top" Width="310" Name="ResultsTextBox"/>

코드를 WPF 앱으로 실행하려면

이 코드를 MainWindow.xaml.cs의 MainWindow 클래스에 붙여넣습니다.
System.Net.Http에 대한 참조를 추가합니다.
System.Net.Http에 대한 using 지시문을 추가합니다.

코드를 Windows 스토어 앱으로 실행하려면

이 코드를 MainPage.xaml.cs의 MainPage 클래스에 붙여넣습니다.
System.Net.Http 및 System.Threading.Tasks에 대한 using 지시문을 추가합니다.

private async void StartButton_Click(object sender, RoutedEventArgs e)
{
    // ExampleMethodAsync returns a Task<int>, which means that the method
    // eventually produces an int result. However, ExampleMethodAsync returns
    // the Task<int> value as soon as it reaches an await.
    ResultsTextBox.Text += "\n";

    try
    {
        int length = await ExampleMethodAsync();
        // Note that you could put "await ExampleMethodAsync()" in the next line where
        // "length" is, but due to when '+=' fetches the value of ResultsTextBox, you
        // would not see the global side effect of ExampleMethodAsync setting the text.
        ResultsTextBox.Text += String.Format("Length: {0:N0}\n", length);
    }
    catch (Exception)
    {
        // Process the exception if one occurs.
    }
}

public async Task<int> ExampleMethodAsync()
{
    var httpClient = new HttpClient();
    int exampleInt = (await httpClient.GetStringAsync("http://msdn.microsoft.com")).Length;
    ResultsTextBox.Text += "Preparing to finish ExampleMethodAsync.\n";
    // After the following return statement, any method that's awaiting
    // ExampleMethodAsync (in this case, StartButton_Click) can get the
    // integer result.
    return exampleInt;
}
// The example displays the following output:
// Preparing to finish ExampleMethodAsync.
// Length: 53292

중요

작업 및 작업 완료를 기다리는 동안 실행되는 코드에 관한 자세한 내용은 async 및 await를 사용한 비동기 프로그래밍을 참조하세요. 비슷한 요소를 사용하는 전체 콘솔 예제는 완료되면 비동기 작업 처리(C#)를 참조하세요.

반환 형식

비동기 메서드의 반환 형식은 다음과 같을 수 있습니다.

Task
Task<TResult>
void. async void 메서드는 호출자가 await 해당 메서드를 사용할 수 없으며 성공적으로 완료 또는 오류 조건을 보고하는 다른 메커니즘을 구현해야 하기 때문에 이벤트 처리기 이외의 코드에 대해 일반적으로 사용되지 않습니다.
액세스 가능한 GetAwaiter 메서드가 있는 모든 형식. System.Threading.Tasks.ValueTask<TResult> 형식은 이러한 구현 중 하나입니다. NuGet 패키지 System.Threading.Tasks.Extensions를 추가하면 사용할 수 있습니다.

비동기 메서드는 모든 in, ref 또는 out 매개 변수를 선언할 수 없고 참조 반환 값을 가질 수도 없지만, 이러한 매개 변수가 있는 메서드를 호출할 수는 있습니다.

메서드의 return 문에서 TResult 형식의 피연산자를 지정할 경우 비동기 메서드의 반환 형식으로 Task<TResult>를 지정합니다. 메서드가 완료되었을 때 의미 있는 값이 반환되지 않을 경우 Task를 사용합니다. 즉, 이 메서드를 호출하면 Task가 반환되지만 Task가 완료되면 await를 기다리는 모든 Task 식이 void가 됩니다.

void 반환 형식은 주로 해당 반환 형식이 필요한 이벤트 처리기를 정의할 때 사용합니다. void 반환 비동기 메서드의 호출자는 기다릴 수 없으므로 메서드가 throw하는 예외를 catch할 수 없습니다.

GetAwaiter 메서드가 있는 다른 형식(일반적으로 값 형식)을 반환하여 성능이 중요한 코드 섹션에서 메모리 할당을 최소화합니다.

자세한 내용과 예제는 비동기 반환 형식을 참조하세요.

async(C# 참조)

예제

반환 형식

참고 항목

피드백

추가 리소스