参考地址：https://docs.microsoft.com/zh-cn/dotnet/csharp/programming-guide/concepts/async/task-asynchronous-programming-model#BKMK_ReturnTypesandParameters
通过使用异步编程，你可以避免性能瓶颈并增强应用程序的总体响应能力。 但是，编写异步应用程序的传统技术可能比较复杂，使它们难以编写、调试和维护。
C# 5 引入了一种简便方法，即异步编程。此方法利用了 .NET Framework 4.5 及更高版本、.NET Core 和 Windows 运行时中的异步支持。 编译器可执行开发人员曾进行的高难度工作，且应用程序保留了一个类似于同步代码的逻辑结构。 因此，你只需做一小部分工作就可以获得异步编程的所有好处。
本主题概述了何时以及如何使用异步编程，并包括指向包含详细信息和示例的支持主题的链接。
异步编程提升响应能力
异步对可能会被屏蔽的活动（如 Web 访问）至关重要。 对 Web 资源的访问有时很慢或会延迟。 如果此类活动在同步过程中被屏蔽，整个应用必须等待。 在异步过程中，应用程序可继续执行不依赖 Web 资源的其他工作，直至潜在阻止任务完成。
下表显示了异步编程提高响应能力的典型区域。 列出的 .NET 和 Windows 运行时 API 包含支持异步编程的方法。
| 应用程序区域 | 包含异步方法的 .NET 类型 | 包含异步方法的 Windows 运行时类型 |
|---|---|---|
| Web 访问 | HttpClient | SyndicationClient |
| 使用文件 | StreamWriter, StreamReader, XmlReader | StorageFile |
| 使用图像 | MediaCapture, BitmapEncoder, BitmapDecoder | |
| WCF 编程 | 同步和异步操作 |
由于所有与用户界面相关的活动通常共享一个线程，因此，异步对访问 UI 线程的应用程序来说尤为重要。 如果任何进程在同步应用程序中受阻，则所有进程都将受阻。 你的应用程序停止响应，因此，你可能在其等待过程中认为它已经失败。
使用异步方法时，应用程序将继续响应 UI。 例如，你可以调整窗口的大小或最小化窗口；如果你不希望等待应用程序结束，则可以将其关闭。
当设计异步操作时，该基于异步的方法将自动传输的等效对象添加到可从中选择的选项列表中。 开发人员只需要投入较少的工作量即可使你获取传统异步编程的所有优点。
异步方法更容易编写
C# 中的 Async 和 Await 关键字是异步编程的核心。 通过这两个关键字，可以使用 .NET Framework、.NET Core 或 Windows 运行时中的资源，轻松创建异步方法（几乎与创建同步方法一样轻松）。 使用 async 关键字定义的异步方法简称为“异步方法” 。
下面的示例演示了一种异步方法。 你应对代码中的几乎所有内容都非常熟悉。
本主题的末尾提供完整的 Windows Presentation Foundation (WPF) 示例文件，可以从异步示例：“使用 Async 和 Await 的异步编程”示例下载此示例。
async Task<int> AccessTheWebAsync() { // You need to add a reference to System.Net.Http to declare client. var 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://docs.microsoft.com/dotnet"); // 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; }
可以从前面的示例中了解几种做法。 从方法签名开始。 它包含 async 修饰符。 返回类型为 Task<int>（有关更多选项，请参阅“返回类型”部分）。 方法名称以 Async 结尾。 在方法的主体中，GetStringAsync 返回 Task<string>。 这意味着在 await 任务时，将获得 string (urlContents)。 在等待任务之前，可以通过 GetStringAsync 执行不依赖于 string 的工作。
密切注意 await 运算符。 它将暂停 AccessTheWebAsync；
- 在
getStringTask完成之前，AccessTheWebAsync无法继续。 - 同时，控件返回至
AccessTheWebAsync的调用方。 - 当
getStringTask完成时，控件将在此处继续。 - 然后，
await运算符会从getStringTask检索string结果。
return 语句指定整数结果。 任何等待 AccessTheWebAsync 的方法都会检索长度值。
如果 AccessTheWebAsync 在调用 GetStringAsync 和等待其完成期间不能进行任何工作，则你可以通过在下面的单个语句中调用和等待来简化代码。
string urlContents = await client.GetStringAsync("https://docs.microsoft.com/dotnet");
以下特征总结了使上一个示例成为异步方法的原因：
-
方法签名包含
async修饰符。 -
按照约定，异步方法的名称以“Async”后缀结尾。
-
返回类型为下列类型之一：
- 如果你的方法有操作数为
TResult类型的返回语句，则为 Task<TResult>。 - 如果你的方法没有返回语句或具有没有操作数的返回语句，则为 Task。
void：如果要编写异步事件处理程序。- 包含
GetAwaiter方法的其他任何类型（自 C# 7.0 起）。
有关详细信息，请参阅返回类型和参数部分。
- 如果你的方法有操作数为
-
方法通常包含至少一个
await表达式，该表达式标记一个点，在该点上，直到等待的异步操作完成方法才能继续。 同时，将方法挂起，并且控件返回到方法的调用方。 本主题的下一节将解释悬挂点发生的情况。
在异步方法中，可使用提供的关键字和类型来指示需要完成的操作，且编译器会完成其余操作，其中包括持续跟踪控件以挂起方法返回等待点时发生的情况。 一些常规流程（例如，循环和异常处理）在传统异步代码中处理起来可能很困难。 在异步方法中，元素的编写频率与同步解决方案相同且此问题得到解决。
若要详细了解旧版 .NET Framework 中的异步性，请参阅 TPL 和传统 .NET Framework 异步编程。
异步方法的运行机制
异步编程中最需弄清的是控制流是如何从方法移动到方法的。 下图可引导你完成此过程：
关系图中的数字对应于以下步骤，在用户单击“开始”按钮时启动。
-
事件处理程序调用并等待
AccessTheWebAsync异步方法。 -
AccessTheWebAsync可创建 HttpClient 实例并调用 GetStringAsync 异步方法以下载网站内容作为字符串。 -
GetStringAsync中发生了某种情况，该情况挂起了它的进程。 可能必须等待网站下载或一些其他阻止活动。 为避免阻止资源，GetStringAsync会将控制权出让给其调用方AccessTheWebAsync。GetStringAsync返回 Task<TResult>，其中TResult为字符串，并且AccessTheWebAsync将任务分配给getStringTask变量。该任务表示调用GetStringAsync的正在进行的进程，其中承诺当工作完成时产生实际字符串值。 -
由于尚未等待
getStringTask，因此，AccessTheWebAsync可以继续执行不依赖于GetStringAsync得出的最终结果的其他工作。 该任务由对同步方法DoIndependentWork的调用表示。 -
DoIndependentWork是完成其工作并返回其调用方的同步方法。 -
AccessTheWebAsync已运行完毕，可以不受getStringTask的结果影响。 接下来，AccessTheWebAsync需要计算并返回已下载的字符串的长度，但该方法只有在获得字符串的情况下才能计算该值。因此，
AccessTheWebAsync使用一个 await 运算符来挂起其进度，并把控制权交给调用AccessTheWebAsync的方法。AccessTheWebAsync将Task<int>返回给调用方。 该任务表示对产生下载字符串长度的整数结果的一个承诺。备注
如果
GetStringAsync（因此getStringTask）在AccessTheWebAsync等待前完成，则控制会保留在AccessTheWebAsync中。 如果异步调用过程 (getStringTask) 已完成，并且AccessTheWebAsync不必等待最终结果，则挂起然后返回到AccessTheWebAsync将造成成本浪费。在调用方内部（此示例中的事件处理程序），处理模式将继续。 在等待结果前，调用方可以开展不依赖于
AccessTheWebAsync结果的其他工作，否则就需等待片刻。 事件处理程序等待AccessTheWebAsync，而AccessTheWebAsync等待GetStringAsync。 -
GetStringAsync完成并生成一个字符串结果。 字符串结果不是通过按你预期的方式调用GetStringAsync所返回的。 （记住，该方法已返回步骤 3 中的一个任务）。相反，字符串结果存储在表示getStringTask方法完成的任务中。 await 运算符从getStringTask中检索结果。 赋值语句将检索到的结果赋给urlContents。 -
当
AccessTheWebAsync具有字符串结果时，该方法可以计算字符串长度。 然后，AccessTheWebAsync工作也将完成，并且等待事件处理程序可继续使用。 在此主题结尾处的完整示例中，可确认事件处理程序检索并打印长度结果的值。 如果你不熟悉异步编程，请花 1 分钟时间考虑同步行为和异步行为之间的差异。 当其工作完成时（第 5 步）会返回一个同步方法，但当其工作挂起时（第 3 步和第 6 步），异步方法会返回一个任务值。 在异步方法最终完成其工作时，任务会标记为已完成，而结果（如果有）将存储在任务中。
若要详细了解控制流，请参阅异步程序中的控制流 (C#)。
API 异步方法
你可能想知道从何处可以找到 GetStringAsync 等支持异步编程的方法。 .NET Framework 4.5 或更高版本以及 .NET Core 包含许多可与 async 和 await 结合使用的成员。 可以通过追加到成员名称的“Async”后缀和 Task 或 Task<TResult> 的返回类型，识别这些成员。 例如，System.IO.Stream 类包含 CopyToAsync、ReadAsync 和 WriteAsync 等方法，以及同步方法 CopyTo、Read 和 Write。
Windows 运行时也包含许多可以在 Windows 应用中与 async 和 await 结合使用的方法。 有关详细信息，请参阅线程处理和异步编程进行 UWP 开发；如果使用的是旧版 Windows 运行时，还请参阅异步编程（Windows 应用商店应用）和快速入门：在 C# 或 Visual Basic 中调用异步 API。
线程
异步方法旨在成为非阻止操作。 异步方法中的 await 表达式在等待的任务正在运行时不会阻止当前线程。 相反，表达式在继续时注册方法的其余部分并将控件返回到异步方法的调用方。
async 和 await 关键字不会创建其他线程。 因为异步方法不会在其自身线程上运行，因此它不需要多线程。 只有当方法处于活动状态时，该方法将在当前同步上下文中运行并使用线程上的时间。 可以使用 Task.Run 将占用大量 CPU 的工作移到后台线程，但是后台线程不会帮助正在等待结果的进程变为可用状态。
对于异步编程而言，该基于异步的方法优于几乎每个用例中的现有方法。 具体而言，此方法比 BackgroundWorker 类更适用于 I/O 绑定操作，因为此代码更简单且无需防止争用条件。 结合 Task.Run 方法使用时，异步编程比 BackgroundWorker 更适用于 CPU 绑定操作，因为异步编程将运行代码的协调细节与 Task.Run 传输至线程池的工作区分开来。
async 和 await
如果使用 async 修饰符将某种方法指定为异步方法，即启用以下两种功能。
-
标记的异步方法可以使用 await 来指定暂停点。
await运算符通知编译器异步方法：在等待的异步过程完成后才能继续通过该点。 同时，控制返回至异步方法的调用方。异步方法在
await表达式执行时暂停并不构成方法退出，只会导致finally代码块不运行。 -
标记的异步方法本身可以通过调用它的方法等待。
异步方法通常包含 await 运算符的一个或多个实例，但缺少 await 表达式也不会导致生成编译器错误。 如果异步方法未使用 await运算符标记暂停点，则该方法会作为同步方法执行，即使有 async 修饰符，也不例外。 编译器将为此类方法发布一个警告。
async 和 await 都是上下文关键字。 有关更多信息和示例，请参见以下主题：
返回类型和参数
异步方法通常返回 Task 或 Task<TResult>。 在异步方法中，await 运算符应用于通过调用另一个异步方法返回的任务。
如果方法包含指定 TResult 类型操作数的 return 语句，将 Task<TResult> 指定为返回类型。
如果方法不含任何 return 语句或包含不返回操作数的 return 语句，将 Task 用作返回类型。
自 C# 7.0 起，还可以指定任何其他返回类型，前提是类型包含 GetAwaiter 方法。 例如，ValueTask<TResult> 就是这种类型。 可用于 System.Threading.Tasks.Extension NuGet 包。
下面的示例演示如何声明并调用可返回 Task<TResult> 或 Task 的方法：
// Signature specifies Task<TResult> async Task<int> GetTaskOfTResultAsync() { int hours = 0; await Task.Delay(0); // Return statement specifies an integer result. return hours; } // Calls to GetTaskOfTResultAsync Task<int> returnedTaskTResult = GetTaskOfTResultAsync(); int intResult = await returnedTaskTResult; // or, in a single statement int intResult = await GetTaskOfTResultAsync(); // Signature specifies Task async Task GetTaskAsync() { await Task.Delay(0); // The method has no return statement. } // Calls to GetTaskAsync Task returnedTask = GetTaskAsync(); await returnedTask; // or, in a single statement await GetTaskAsync();
每个返回的任务表示正在进行的工作。 任务可封装有关异步进程状态的信息，如果未成功，则最后会封装来自进程的最终结果或进程引发的异常。
异步方法也可以具有 void 返回类型。 该返回类型主要用于定义需要 void 返回类型的事件处理程序。 异步事件处理程序通常用作异步程序的起始点。
无法等待具有 void 返回类型的异步方法，并且无效返回方法的调用方捕获不到异步方法引发的任何异常。
异步方法无法声明 in、ref 或 out 参数，但可以调用包含此类参数的方法。 同样，异步方法无法通过引用返回值，但可以调用包含 ref 返回值的方法。
有关详细信息和示例，请参阅异步返回类型 (C#)。 若要详细了解如何在异步方法中捕获异常，请参阅 try-catch。
Windows 运行时编程中的异步 API 具有下列返回类型之一（类似于任务）：
- IAsyncOperation<TResult>（对应于 Task<TResult>）
- IAsyncAction（对应于 Task）
- IAsyncActionWithProgress<TProgress>
- IAsyncOperationWithProgress<TResult, TProgress>
命名约定
按照约定，返回常规可等待类型的方法（例如 Task、Task<T>、ValueTask 和 ValueTask<T>）应具有以“Async”结束的名称。 启动异步操作但不返回可等待类型的方法不得具有以“Async”结尾的名称，但其开头可以为“Begin”、“Start”或其他表明此方法不返回或引发操作结果的动词。
如果某一约定中的事件、基类或接口协定建议其他名称，则可以忽略此约定。 例如，你不应重命名常用事件处理程序，例如 Button1_Click。
相关主题和示例 (Visual Studio)
| 标题 | 说明 | 示例 |
|---|---|---|
| 演练：使用 Async 和 Await 访问 Web (C#) | 演示如何将一个同步 WPF 解决方案转换成一个异步 WPF 解决方案。 应用程序下载一系列网站。 | 异步示例：“访问 Web”演练 |
| 如何使用 Task.WhenAll 扩展异步演练 (C#) | 将 Task.WhenAll 添加到上一个演练。 使用 WhenAll 同时启动所有下载。 |
|
| 如何使用 Async 和 Await 并行发出多个 Web 请求 (C#) | 演示如何同时开始几个任务。 | 异步示例：并行发出多个 Web 请求 |
| 异步返回类型 (C#) | 描述异步方法可返回的类型，并解释每种类型适用于的情况。 | |
| 异步程序中的控制流 (C#) | 通过异步程序中的一系列 await 表达式来详细跟踪控制流。 | 异步示例：异步程序中的控制流 |
| 微调异步应用程序 (C#) | 演示如何将以下功能添加到异步解决方案： - 取消一个异步任务或一组任务(C#) - 在一段时间后取消异步任务 (C#) - 在完成一个异步任务后取消剩余任务 (C#) - 启动多个异步任务并在其完成时进行处理 (C#) |
异步示例：微调应用程序 |
| 在异步应用程序中处理重入 (C#) | 演示如何处理有效的异步操作在运行时重启的情况。 | |
| WhenAny：综合运用 .NET Framework 和 Windows 运行时 | 展示了如何在 .NET Framework 与 Windows 运行时中的 IAsyncOperations 之间桥接任务类型，以便可以将 WhenAny 与 Windows 运行时方法结合使用。 | 异步示例：综合运用 .NET 和 Windows 运行时（AsTask 和 WhenAny） |
| 异步取消：综合运用 .NET Framework 和 Windows 运行时 | 展示了如何在 .NET Framework 与 Windows 运行时中的 IAsyncOperations 之间桥接任务类型，以便可以将 CancellationTokenSource 与 Windows 运行时方法结合使用。 | 异步示例：综合运用 .NET 和 Windows 运行时（AsTask 和 Cancellation） |
| 使用 Async 进行文件访问 (C#) | 列出并演示使用 async 和 await 访问文件的好处。 | |
| 基于任务的异步模式 (TAP) | 描述 .NET Framework 中异步的新模式。 该模式基于 Task 和 Task<TResult> 类型。 | |
| Channel 9 上的异步相关视频 | 提供指向有关异步编程的各种视频的链接。 |
完整示例
下面的代码来自于本文介绍的 WPF 应用程序的“MainWindow.xaml.cs”文件 。 可以从异步示例：“使用 Async 和 Await 的异步编程”示例下载此示例。
using System; using System.Threading.Tasks; using System.Windows; // 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 += $" Length of the downloaded string: {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. var 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://docs.microsoft.com/dotnet"); // 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 . . . . . . . "; } } } // Sample Output: // Working . . . . . . . // Length of the downloaded string: 41564.