Async 및 Await를 사용한 비동기 프로그래밍(C# 및 Visual Basic)

비동기 프로그래밍을 사용하여 성능 병목 현상을 방지하고 응용 프로그램의 전체적인 응답성을 향상할 수 있습니다. 그러나 비동기 응용 프로그램을 쓰는 일반적인 기술이 복잡하여 해당 응용 프로그램을 쓰고, 디버깅하고, 유지 관리하기 어려울 수 있습니다.

Visual Studio 2012은 .NET Framework 4.5 및 Windows 런타임의 비동기 지원을 활용하는 간단한 비동기 프로그래밍을 새로 도입했습니다. 컴파일러는 개발자가 하던 어려운 작업을 수행하고, 응용 프로그램은 동기 코드와 비슷한 논리 구조를 유지합니다. 따라서 약간의 노력만으로도 비동기 프로그래밍의 모든 장점을 누릴 수 있습니다.

이 항목에는 다음 단원이 포함되어 있습니다.

• 반응성을 향상시키는 Async
• 작성이 간편한 Async 메서드
• Async 메서드에서 수행되는 작업
• API Async 메서드
• 스레드
• Async 및 Await
• 반환 형식 및 매개 변수
• 명명 규칙
• 관련 항목
• 완성된 예제
• 관련 항목

이 항목에서는 비동기 프로그래밍을 사용하는 시기 및 방법에 대한 개요를 제공하고 특정 세부 정보 및 예제가 포함된 지원 항목에 대한 링크가 포함되어 있습니다.

반응성을 향상시키는 Async

비동기는 응용 프로그램이 웹에 액세스하는 경우와 같이 차단 가능성이 있는 작업에 반드시 필요합니다. 웹 리소스에 대한 액세스 속도가 느리거나 지연됩니다. 동기 프로세스 안에서 이러한 활동이 차단되면 전체 응용 프로그램이 기다려야 합니다. 비동기 프로세스에서 응용 프로그램은 잠재적인 차단 작업이 완료될 때까지 웹 리소스에 의존하지 않는 다른 작업을 계속 수행할 수 있습니다.

다음 표에는 비동기 프로그래밍으로 응답성이 향상되는 일반적인 영역이 나와 있습니다. .NET Framework 4.5 및 Windows 런타임에서 나열된 API에는 비동기 프로그래밍을 지원하는 메서드가 포함되어 있습니다.

모든 UI 관련 작업이 대체로 스레드 한 개를 공유하므로 비동기는 특히 UI 스레드에 액세스하는 응용 프로그램의 변수를 증명합니다. 동기 응용 프로그램에서 임의의 프로세스가 차단되면 모든 프로세스가 차단됩니다. 응용 프로그램이 응답을 중지하면 기다리지 않고 응용 프로그램이 실패한 것으로 결론을 내릴 것입니다.

비동기 메서드를 사용하면 응용 프로그램이 UI에 계속 응답합니다. 예를 들어 창의 크기를 조정하거나 최소화할 수 있습니다. 또는 응용 프로그램이 완료될 때까지 기다리지 않으려면 응용 프로그램을 종료할 수 있습니다.

비동기 기반 접근 방식을 사용하면 비동기 작업을 디자인할 때 선택할 수 있는 옵션 목록에 자동 전송과 동일한 기능을 추가할 수 있습니다. 즉, 기존 비동기 프로그래밍의 이점을 모두 활용할 수 있지만 개발자의 활동이 크게 줄어듭니다.

작성이 간편한 Async 메서드

Visual Basic의 Async 및 Await 키워드와 C#의 async 및 await 키워드는 비동기 프로그래밍의 핵심입니다. 이 키워드 두 개를 사용하면 .NET Framework의 리소스 또는 Windows 런타임를 사용하여 동기 메서드를 만드는 것만큼 쉽게 비동기 메서드를 만들 수 있습니다. async 및 await를 사용하여 정의하는 비동기 메서드를 비동기 메서드라고 합니다.

다음 예제에서는 비동기 메서드를 보여줍니다. 코드의 거의 모든 내용이 익숙할 것입니다. 주석은 비동기를 만들 때 추가하는 기능을 호출합니다.

이 항목의 마지막에 완전한 예제 파일이 있으며, Async 샘플: "Async 및 Await를 사용하는 비동기 프로그래밍"의 예제에서 샘플을 다운로드할 수 있습니다.

' Three things to note in the signature: 
'  - The method has an Async modifier.  
'  - The return type is Task or Task(Of T). (See "Return Types" section.) 
'    Here, it is Task(Of Integer) because the return statement returns an integer. 
'  - The method name ends in "Async."
Async Function AccessTheWebAsync() As Task(Of Integer)

    ' You need to add a reference to System.Net.Http to declare client. 
    Dim client As HttpClient = New HttpClient()

    ' GetStringAsync returns a Task(Of String). That means that when you await the 
    ' task you'll get a string (urlContents). 
    Dim getStringTask As Task(Of String) = client.GetStringAsync("https://msdn.microsoft.com")


    ' You can do work here that doesn't rely on the string from GetStringAsync.
    DoIndependentWork()

    ' The Await operator suspends AccessTheWebAsync. 
    '  - AccessTheWebAsync can't continue until getStringTask is complete. 
    '  - Meanwhile, control returns to the caller of AccessTheWebAsync. 
    '  - Control resumes here when getStringTask is complete.  
    '  - The Await operator then retrieves the string result from getStringTask. 
    Dim urlContents As String = Await getStringTask

    ' The return statement specifies an integer result. 
    ' Any methods that are awaiting AccessTheWebAsync retrieve the length value. 
    Return urlContents.Length
End Function

// Three things to note in the signature: 
//  - The method has an async modifier.  
//  - The return type is Task or Task<T>. (See "Return Types" section.)
//    Here, it is Task<int> because the return statement returns an integer. 
//  - The method name ends in "Async."
async Task<int> AccessTheWebAsync()
{ 
    // You need to add a reference to System.Net.Http to declare client.
    HttpClient client = new HttpClient();

    // GetStringAsync returns a Task<string>. That means that when you await the 
    // task you'll get a string (urlContents).
    Task<string> getStringTask = client.GetStringAsync("https://msdn.microsoft.com");

    // You can do work here that doesn't rely on the string from GetStringAsync.
    DoIndependentWork();

    // The await operator suspends AccessTheWebAsync. 
    //  - AccessTheWebAsync can't continue until getStringTask is complete. 
    //  - Meanwhile, control returns to the caller of AccessTheWebAsync. 
    //  - Control resumes here when getStringTask is complete.  
    //  - The await operator then retrieves the string result from getStringTask. 
    string urlContents = await getStringTask;

    // The return statement specifies an integer result. 
    // Any methods that are awaiting AccessTheWebAsync retrieve the length value. 
    return urlContents.Length;
}

AccessTheWebAsync에 GetStringAsync 호출과 해당 완료 대기 사이에 수행할 수 있는 작업이 없는 경우 다음 단일 문을 호출하고 대기하여 코드를 단순화할 수 있습니다.

Dim urlContents As String = Await client.GetStringAsync()

string urlContents = await client.GetStringAsync();

이전 예제가 비동기 메서드인 이유는 다음과 같은 특성 때문입니다.

• 메서드 시그니처에 Async 또는 async 한정자가 포함됩니다.

• 비동기 메서드의 이름은 규칙에 따라 "Async" 접미사로 끝납니다.

• 반환 형식은 다음 형식 중 하나입니다.

  • 메서드에 연산자 형식이 TResult인 Return 문이 있는 경우 Task입니다.

  • 메서드에 반환 문이 포함되지 않았거나 피연산자가 없는 반환 문이 포함된 경우 Task입니다.

  • 비동기 이벤트를 작성하는 경우 무효입니다(Visual Basic의 Sub).

  자세한 내용은 이 항목 뒷부분의 "반환 형식 및 매개 변수"를 참조하십시오.

• 메서드는 일반적으로 비동기 작업이 완료될 때까지 메서드가 계속될 수 없는 지점을 표시하는 하나 이상의 대기 표현을 포함하고 있습니다. 한편, 메서드가 일시 중단되고 컨트롤이 메서드의 호출자로 반환됩니다. 이 항목의 다음 단원은 일시 중단 지점에서 발생하는 상황을 보여줍니다.

비동기 메서드에서는 제공된 키워드 및 형식을 사용해서 수행하려는 작업을 나타내고, 컴파일러는 일시 중단된 메서드에서 컨트롤이 대기 지점으로 반환될 때 수행되어야 하는 항목을 추적하는 등의 나머지 작업을 수행합니다. 루프 및 예외 처리와 같은 일부 루틴 프로세스는 기존의 비동기 코드에서 처리하기 어려울 수 있습니다. 비동기 메서드에서는 동기 솔루션에서와 같이 필요한 만큼 이러한 요소를 작성하여 문제를 해결합니다.

.NET Framework 이전 버전의 비동기에 대한 자세한 내용은 TPL 및 일반적인 .NET Framework 비동기 프로그래밍을 참조하십시오.

Async 메서드에서 수행되는 작업

비동기 프로그래밍을 이해하는 데 있어 가장 중요한 점은 메서드에서 메서드로 제어 흐름을 이동하는 방법입니다. 다음 다이어그램이 과정을 안내합니다.

다이어그램의 번호는 다음 단계에 해당합니다.

1. 이벤트 처리기가 호출되어 AccessTheWebAsync 비동기 메서드를 기다립니다.

2. AccessTheWebAsync는 HttpClient 인스턴스를 만들고 GetStringAsync 비동기 메서드를 호출하여 웹 사이트의 내용을 문자열로 다운로드합니다.

3. GetStringAsync에서 특정 작업이 발생하여 진행이 일시 중단됩니다. 웹 사이트에서 다운로드 또는 다른 차단 작업을 수행할 때까지 기다려야 할 수 있습니다. 리소스를 차단하지 않기 위해 GetStringAsync는 해당 호출자인 AccessTheWebAsync에 제어 권한을 양도합니다.

   GetStringAsync는 TResult가 문자열인 Task를 반환하고 AccessTheWebAsync는 getStringTask 변수에 작업을 할당합니다. 이 작업은 작업이 완료될 때 실제 문자열 값을 생성하기 위한 코드와 함께 GetStringAsync를 호출하는 지속적인 프로세스를 나타냅니다.

4. getStringTask가 아직 대기되지 않았으므로 AccessTheWebAsync가 GetStringAsync의 최종 결과에 무관한 다른 작업을 계속할 수 있습니다. 이 작업은 동기 메서드 DoIndependentWork를 호출하여 나타냅니다.

5. DoIndependentWork는 작업을 수행하고 호출자에게 반환하는 동기 메서드입니다.

6. AccessTheWebAsync에 getStringTask 결과 없이 수행할 수 있는 작업이 없습니다. 다음으로 AccessTheWebAsync는 다운로드한 문자열의 길이를 계산하여 반환하려 하지만, 메서드가 문자열을 확인할 때까지 해당 값을 계산할 수 없습니다.

   따라서 AccessTheWebAsync는 await 연산자를 사용해서 해당 프로세스를 일시 중단하고 AccessTheWebAsync를 호출한 메서드에 제어 권한을 양도합니다. AccessTheWebAsync는 Task(Of Integer) 또는 Task<int>를 호출자에게 반환합니다. 작업은 다운로드한 문자열의 길이인 정수 결과를 만든다는 약속을 나타냅니다.

   참고

   AccessTheWebAsync가 대기하기 전에 GetStringAsync(및 getStringTask)가 완료되면 AccessTheWebAsync에 컨트롤이 유지됩니다.일시 중단 및 AccessTheWebAsync의 반환 비용은 호출된 비동기 프로세스(getStringTask)가 이미 완료되었고 AccessTheWebSync가 최종 결과를 기다릴 필요가 없다면 낭비됩니다.

   호출자(이 예제의 이벤트 처리기) 내에서 처리 패턴이 계속됩니다. 호출자가 해당 결과를 기다리거나 즉시 기다리기 전에 AccessTheWebAsync에서 결과에 의존하지 않는 다른 작업을 수행할 수 있습니다. AccessTheWebAsync에 대한 이벤트가 대기 중이며 AccessTheWebAsync가 GetStringAsync를 대기 중입니다.

7. GetStringAsync가 완료되고 문자열 결과를 생성합니다. GetStringAsync를 호출할 경우 문자열 결과가 예상대로 반환되지 않습니다. (3단계에서 메서드가 이미 반환된 것을 기억하십시오.) 대신, 문자열 결과가 getStringTask 메서드의 완료를 나타내는 작업에 저장됩니다. await 연산자가 getStringTask에서 결과를 검색합니다. 할당 문은 검색된 결과를 urlContents에 할당합니다.

8. AccessTheWebAsync에 문자열 결과가 있는 경우 메서드가 문자열 길이를 계산할 수 있습니다. 그런 다음 AccessTheWebAsync 작업도 완료되고 대기 이벤트 처리기를 다시 시작할 수 있습니다. 이 항목 뒷부분의 전체 예에서는 이벤트 처리기가 길이 결과 값을 검색하고 출력하는지 확인할 수 있습니다.

비동기 프로그래밍을 처음 접하는 사용자인 경우 동기 동작과 비동기 동작의 차이점을 살펴보십시오. 비동기 메서드는 작업이 완료될 때 반환되지만(5단계) 비동기 메서드는 작업이 일시 중단될 때 반환됩니다. 비동기 메서드가 해당 작업을 완료하면 작업이 완료된 것으로 표시되고 결과가 있을 경우 작업에 저장됩니다.

제어 흐름에 대한 자세한 내용은 비동기 프로그램의 제어 흐름(C# 및 Visual Basic)을 참조하십시오.

API Async 메서드

GetStringAsync와 같이 비동기 프로그래밍을 지원하는 메서드를 어디에서 검색해야 할지 궁금했을 것입니다. .NET Framework 4.5에는 async 및 await를 사용하는 여러 멤버가 포함되어 있습니다. 멤버 이름에 붙는 "Async" 접미사로 이러한 멤버와 Task 또는 Task의 반환 형식을 인식할 수 있습니다. 예를 들어, System.IO.Stream 클래스는 동기 메서드인 CopyTo, Read 및 Write와 함께 CopyToAsync, ReadAsync 및 WriteAsync와 같은 메서드를 포함합니다.

Windows 런타임에는 Windows 스토어 응용 프로그램에서 async 및 await와 함께 사용할 수 있는 여러 메서드도 포함되어 있습니다. 자세한 내용 및 예제 메서드를 보려면 빠른 시작: 비동기 프로그래밍에 await 연산자 사용, 비동기 프로그래밍(Windows 스토어 앱) 및 WhenAny: .NET Framework와 Windows 런타임 간 브리징(C# 및 Visual Basic)를 참조하십시오.

스레드

비동기 메서드는 비차단 작업입니다. 비동기 메서드의 await 식은 대기한 작업이 실행되는 동안 현재 스레드를 차단하지 않습니다. 대신에 이 식은 메서드의 나머지를 연속으로 등록하고 제어 기능을 비동기 메서드 호출자에게 반환합니다.

async 및 await 키워드로 인해 추가 스레드가 생성되지 않습니다. 비동기 메서드는 자체 스레드에서 실행되지 않으므로 다중 스레드가 필요하지 않습니다. 메서드는 현재 동기화 컨텍스트에서 실행되고 메서드가 활성화된 경우에만 스레드에서 시간을 사용합니다. Task.Run을 사용하여 CPU 바인딩 작업을 백그라운드 스레드로 이동할 수 있지만 백그라운드 스레드는 프로세스를 지원하지 않고 결과를 사용할 수 있을 때까지 기다립니다.

비동기 프로그래밍에 대한 비동기 기반 접근 방법은 거의 모든 경우에 기존 방법보다 선호됩니다. 특히, 이 접근 방식은 코드가 더 간단하고 경합 조건을 방지할 필요가 없기 때문에 IO 바인딩 작업의 BackgroundWorker보다 효과적입니다. 비동기 프로그래밍은 코드 실행에 대한 조합 세부 정보를 Task.Run이 스레드 풀로 변환하는 작업과 구분하기 때문에 Task.Run을 함께 사용하는 비동기 프로그래밍은 CPU 바인딩 작업을 위한 BackgroundWorker보다 효과가 뛰어납니다.

Async 및 Await

Async 또는 async 한정자를 사용해서 메서드를 비동기 메서드로 지정하면 다음 두 기능이 활성화됩니다.

• 표시된 비동기 메서드는 Await 또는 await를 사용하여 일시 중단 지점을 지정할 수 있습니다. Await 연산자는 비동기 프로세스가 완료될 때까지 비동기 메서드가 해당 지점을 계속할 수 없다고 지시합니다. 한편, 컨트롤이 비동기 메서드의 호출자로 반환됩니다.

  await 식에서 비동기 메서드를 일시 중단하더라도 메서드가 종료되지는 않으며 finally 블록이 실행되지 않습니다.

• 표시된 비동기 메서드는 이 메서드를 호출한 다른 메서드에 의해 대기할 수 있습니다.

비동기 메서드는 일반적으로 await 연산자를 하나 이상 가지고 있지만, await 식이 없을 경우 컴파일러 오류가 발생하지 않습니다. 비동기 메서드에서 await 연산자를 사용하여 일시 중단 시점을 표시하지 않는 경우 메서드가 async 한정자에 상관없이 동기 메서드가 실행되는 방식으로 실행됩니다. 컴파일러는 다음 메서드에 대해 경고를 생성합니다.

Async, async, Await 및 await은 상황별 키워드입니다. 자세한 내용과 예제는 다음 항목을 참조하십시오.

• Async(Visual Basic)

• async(C# 참조)

• Await 연산자(Visual Basic)

• await(C# 참조)

반환 형식 및 매개 변수

.NET Framework 프로그래밍에서 비동기 메서드는 일반적으로 Task 또는 Task를 반환합니다. 비동기 메서드 내에서 'await' 연산자는 호출에서 다른 비동기 메서드로 전환되는 작업에 적용됩니다.

메서드에 TResult 형식의 피연산자를 지정하는 Return(Visual Basic) 또는 return(C#) 문이 포함되어 있을 경우Task를 반환 형식으로 지정합니다.

메서드에 return 문이 없거나 피연산자를 반환하지 않는 return 문이 있을 경우 반환 형식으로 Task를 사용합니다.

다음 예제는 Task 또는 Task를 반환하는 메서드를 선언하고 호출하는 방법을 보여줍니다.

' Signature specifies Task(Of Integer)
Async Function TaskOfTResult_MethodAsync() As Task(Of Integer)

    Dim hours As Integer
    ' . . .
    ' Return statement specifies an integer result.
    Return hours
End Function

' Calls to TaskOfTResult_MethodAsync
Dim returnedTaskTResult As Task(Of Integer) = TaskOfTResult_MethodAsync()
Dim intResult As Integer = Await returnedTaskTResult
' or, in a single statement
Dim intResult As Integer = Await TaskOfTResult_MethodAsync()


' Signature specifies Task
Async Function Task_MethodAsync() As Task

    ' . . .
    ' The method has no return statement.
End Function

' Calls to Task_MethodAsync
Task returnedTask = Task_MethodAsync()
Await returnedTask
' or, in a single statement
Await Task_MethodAsync()

// Signature specifies Task<TResult>
async Task<int> TaskOfTResult_MethodAsync()
{
    int hours;
    // . . .
    // Return statement specifies an integer result.
    return hours;
}

// Calls to TaskOfTResult_MethodAsync
Task<int> returnedTaskTResult = TaskOfTResult_MethodAsync();
int intResult = await returnedTaskTResult;
// or, in a single statement
int intResult = await TaskOfTResult_MethodAsync();


// Signature specifies Task
async Task Task_MethodAsync()
{
    // . . .
    // The method has no return statement.  
}

// Calls to Task_MethodAsync
Task returnedTask = Task_MethodAsync();
await returnedTask;
// or, in a single statement
await Task_MethodAsync();

반환된 각 작업은 진행 중인 작업을 나타냅니다. 작업은 비동기 프로세스 상태에 대한 정보를 캡슐화하며, 결과적으로 프로세스의 최종 결과 또는 성공하지 못한 경우 프로세스가 발생시키는 예외에 대한 정보를 캡슐화합니다.

비동기 메서드는 Sub 메서드(Visual Basic)도 가능하며 void 반환 형식(C#)을 가질 수 있습니다. 이 반환 형식은 기본적으로 void 반환 형식이 필요할 때 이벤트 처리기를 정의하는 데 사용합니다. 비동기 이벤트 처리기는 비동기 프로그램의 시작점 역할을 하는 경우가 많습니다.

Sub 프로시저이거나 void 반환 형식을 가진 비동기 메서드는 대기할 수 없습니다. 또한 void를 반환하는 메서드의 호출자는 메서드가 throw하는 예외를 catch할 수 없습니다.

비동기 메서드는 Visual Basic에서 ByRef 매개 변수를 선언할 수 없거나, C#에서 ref 또는 out 매개 변수를 선언할 수 없지만, 그러한 매개 변수를 가진 메서드를 호출할 수 있습니다.

자세한 내용과 예제를 보려면 비동기 반환 형식(C# 및 Visual Basic)을 참조하십시오. 비동기 메서드에서 예외를 catch하는 방법에 대한 자세한 내용은 try-catch(C# 참조) 또는 Try...Catch...Finally 문(Visual Basic)를 참조하십시오.

Windows 런타임 프로그래밍의 비동기 API에는 작업과 유사한 다음 반환 형식 중 하나가 있습니다.

• Task에 해당하는 IAsyncOperation

• Task에 해당하는 IAsyncAction

• IAsyncActionWithProgress

• IAsyncOperationWithProgress

자세한 내용 및 예제를 보려면 빠른 시작: 비동기 프로그래밍에 await 연산자 사용을 참조하십시오.

명명 규칙

규칙에 따라 Async 또는 async 한정자가 있는 메서드 이름에 "Async"를 추가합니다.

여기서 이벤트, 기본 클래스 또는 인터페이스 계약으로 다른 이름을 제안하는 규칙을 무시할 수 있습니다. 예를 들어, Button1_Click과 같은 공용 이벤트 처리기의 이름을 변경할 수 없습니다.

관련 항목

완성된 예제

다음 코드는 이 항목에서 설명하는 WPF(Windows Presentation Foundation) 응용 프로그램의 MainWindow.xaml.vb 또는 MainWindow.xaml.cs 파일입니다. Async 샘플: "Async 및 Await를 사용하는 비동기 프로그래밍"의 예제에서 샘플을 다운로드할 수 있습니다.

' Add an Imports statement and a reference for System.Net.Http 
Imports System.Net.Http

Class MainWindow

    ' Mark the event handler with async so you can use Await in it. 
    Private Async Sub StartButton_Click(sender As Object, e As RoutedEventArgs)

        ' Call and await separately. 
        'Task<int> getLengthTask = AccessTheWebAsync(); 
        '' You can do independent work here. 
        'int contentLength = await getLengthTask; 

        Dim contentLength As Integer = Await AccessTheWebAsync()

        ResultsTextBox.Text &=
            String.Format(vbCrLf & "Length of the downloaded string: {0}." & vbCrLf, contentLength)
    End Sub 


    ' Three things to note in the signature: 
    '  - The method has an Async modifier.  
    '  - The return type is Task or Task(Of T). (See "Return Types" section.) 
    '    Here, it is Task(Of Integer) because the return statement returns an integer. 
    '  - The method name ends in "Async."
    Async Function AccessTheWebAsync() As Task(Of Integer)

        ' You need to add a reference to System.Net.Http to declare client. 
        Dim client As HttpClient = New HttpClient()

        ' GetStringAsync returns a Task(Of String). That means that when you await the 
        ' task you'll get a string (urlContents). 
        Dim getStringTask As Task(Of String) = client.GetStringAsync("https://msdn.microsoft.com")


        ' You can do work here that doesn't rely on the string from GetStringAsync.
        DoIndependentWork()

        ' The Await operator suspends AccessTheWebAsync. 
        '  - AccessTheWebAsync can't continue until getStringTask is complete. 
        '  - Meanwhile, control returns to the caller of AccessTheWebAsync. 
        '  - Control resumes here when getStringTask is complete.  
        '  - The Await operator then retrieves the string result from getStringTask. 
        Dim urlContents As String = Await getStringTask

        ' The return statement specifies an integer result. 
        ' Any methods that are awaiting AccessTheWebAsync retrieve the length value. 
        Return urlContents.Length
    End Function 


    Sub DoIndependentWork()
        ResultsTextBox.Text &= "Working . . . . . . ." & vbCrLf
    End Sub 
End Class 

' Sample Output: 

' Working . . . . . . . 

' Length of the downloaded string: 41763.

using System;
using System.Collections.Generic;
using System.Linq;
using System.Text;
using System.Threading.Tasks;
using System.Windows;
using System.Windows.Controls;
using System.Windows.Data;
using System.Windows.Documents;
using System.Windows.Input;
using System.Windows.Media;
using System.Windows.Media.Imaging;
using System.Windows.Navigation;
using System.Windows.Shapes;

// Add a using directive and a reference for System.Net.Http; 
using System.Net.Http;

namespace AsyncFirstExample
{
    public partial class MainWindow : Window
    {
        // Mark the event handler with async so you can use await in it. 
        private async void StartButton_Click(object sender, RoutedEventArgs e)
        {
            // Call and await separately. 
            //Task<int> getLengthTask = AccessTheWebAsync(); 
            //// You can do independent work here. 
            //int contentLength = await getLengthTask; 

            int contentLength = await AccessTheWebAsync();

            resultsTextBox.Text +=
                String.Format("\r\nLength of the downloaded string: {0}.\r\n", contentLength);
        }


        // Three things to note in the signature: 
        //  - The method has an async modifier.  
        //  - The return type is Task or Task<T>. (See "Return Types" section.)
        //    Here, it is Task<int> because the return statement returns an integer. 
        //  - The method name ends in "Async."
        async Task<int> AccessTheWebAsync()
        { 
            // You need to add a reference to System.Net.Http to declare client.
            HttpClient client = new HttpClient();

            // GetStringAsync returns a Task<string>. That means that when you await the 
            // task you'll get a string (urlContents).
            Task<string> getStringTask = client.GetStringAsync("https://msdn.microsoft.com");

            // You can do work here that doesn't rely on the string from GetStringAsync.
            DoIndependentWork();

            // The await operator suspends AccessTheWebAsync. 
            //  - AccessTheWebAsync can't continue until getStringTask is complete. 
            //  - Meanwhile, control returns to the caller of AccessTheWebAsync. 
            //  - Control resumes here when getStringTask is complete.  
            //  - The await operator then retrieves the string result from getStringTask. 
            string urlContents = await getStringTask;

            // The return statement specifies an integer result. 
            // Any methods that are awaiting AccessTheWebAsync retrieve the length value. 
            return urlContents.Length;
        }


        void DoIndependentWork()
        {
            resultsTextBox.Text += "Working . . . . . . .\r\n";
        }
    }
}

// Sample Output: 

// Working . . . . . . . 

// Length of the downloaded string: 41564.

참고 항목

참조

async(C# 참조)

await(C# 참조)

Await 연산자(Visual Basic)

Async(Visual Basic)

기타 리소스

샘플: Windows 스토어 앱을 위한 .NET 비동기 프로그래밍

샘플: await WebClient 만들기

샘플(C#): 응용 프로그램 저장 공간에 컬렉션 저장

샘플(Visual Basic): 응용 프로그램 저장 공간에 컬렉션 저장