演练：将调试器与异步方法一起使用

项目
06/09/2015

通过使用异步功能，您可以调用异步方法而无需使用回调，也不需要跨多个方法或 lambda 表达式来拆分代码。若要使同步代码异步，请调用异步方法而非同步方法，并向代码中添加几个关键字。有关详细信息，请参阅使用 Async 和 Await 的异步编程（C# 和 Visual Basic）。

在 Visual Studio 调试器中，您可将**“单步执行”、“逐过程”和“跳出”**命令与 Async 功能结合使用。还可继续使用断点，特别是查看包含 await 运算符的语句处的控制流。在本演练中，您将完成下列任务，可按任意顺序运行这些任务。

使用断点演示 await 语句处的控制流。
了解**“单步执行”和“逐过程”**命令在包含 await 运算符的语句处的行为。
了解从异步方法使用**“跳出”**命令时，该命令的行为。

用于显示控制流的断点

如果您使用 Async (Visual Basic) 或 async (C#) 修饰符标记方法，则可在方法中使用 Await (Visual Basic) 或 await (C#) 运算符。若要创建 await 表达式，请将 operator 运算符与任务关联。为任务调用 await 表达式时，当前方法将立即存在并返回不同的任务。在与 await 运算符关联的任务完成时，在同一方法中继续执行。有关详细信息，请参阅异步程序中的控制流（C# 和 Visual Basic）。

备注

异步方法在遇到第一个尚未完成的 awaited 对象或到达异步方法的末尾（以先发生者为准）时将返回调用方。

备注

这些示例中的控制台应用程序使用 Wait 方法阻止应用程序在 Main 中终止。您不应在控制台应用程序之外使用 Wait 方法，因为这会出现死锁情况。

以下过程将断点设置演示应用程序到达 await 语句时发生的情况。您还可通过添加 Debug.WriteLine 语句来演示控制流。

创建控制台应用程序，然后将以下代码粘贴到该应用程序中：

' Breakpoints to show control flow. 
Imports System.Threading.Tasks

Module Module1
    Sub Main()
        Dim theTask = ProcessAsync()
        Dim x = 0 ' set breakpoint
        theTask.Wait()
    End Sub

    Async Function ProcessAsync() As Task
        Dim result = Await DoSomethingAsync()  ' set breakpoint

        Dim y = 0 ' set breakpoint
    End Function

    Async Function DoSomethingAsync() As Task(Of Integer)
        Await Task.Delay(1000)
        Return 5
    End Function 
End Module

// Breakpoints to show control flow. 
using System.Threading.Tasks;

class Program
{
    static void Main(string[] args)
    {
        Task theTask = ProcessAsync();
        int x = 0;  // set breakpoint
        theTask.Wait();
    }

    static async Task ProcessAsync()
    {
        var result = await DoSomethingAsync();  // set breakpoint 

        int y = 0;  // set breakpoint
    }

    static async Task<int> DoSomethingAsync()
    {
        await Task.Delay(1000);
        return 5;
    }
}

在以“set breakpoint”注释结束的三个行上设置调试断点。
选择 F5 键，或选择菜单栏上的**“调试”和“启动调试”**来运行应用程序。

应用程序将进入 ProcessAsync 方法并在包含 await 运算符的行上中断。
再次选择 F5 键。

由于应用程序已在包含 await 运算符的语句上停止，因此应用程序将立即退出异步方法并返回一个任务。因此，应用程序将退出 ProcessAsync 方法并在调用方法 (Main) 中的断点处中断。
再次选择 F5 键。

在 DoSomethingAsync 方法完成后，代码将在调用方法中的 await 语句后继续。因此，应用程序将在 ProcessAsync 方法中的断点处中断。

在最初等待 DoSomethingAsync 后，ProcessAsync 方法将退出并返回一个任务。之后，在等待的 DoSomethingAsync 方法完成后，计算 await 语句将生成 DoSomethingAsync 的返回值。将定义 DoSomethingAsync 方法以在 Visual Basic 中返回 Task (Of Integer) 或在 C# 中返回 Task<int>，因此其返回语句中的值为整数。有关详细信息，请参阅异步返回类型（C# 和 Visual Basic）。

获取并等待任务

在 ProcessAsync 方法中，语句 Dim result = Await DoSomethingAsync() (Visual Basic) 或 var result = await DoSomethingAsync(); (C#) 是下列两个语句的缩写式：

Dim theTask = DoSomethingAsync()
Dim result = Await theTask

var theTask = DoSomethingAsync();
var result = await theTask;

第一行代码将调用异步方法并返回一个任务。该任务将与下一行代码中的 await 运算符关联。 await 语句将退出方法 (ProcessAsync) 并返回一个不同的任务。在与 await 运算符关联的任务完成后，代码将在 await 语句后的方法 (ProcessAsync) 中继续。

当 await 语句立即返回不同的任务时，该任务是包含 await 运算符的异步方法 (ProcessAsync) 的返回参数。 await 返回的任务包括出现在同一方法中的 await 之后的代码执行，这是此任务不同于与 await 关联的任务的原因。

单步执行和逐过程

**“单步执行”命令将单步执行方法，而“逐过程”**命令将执行方法调用，然后在调用方法的下一行上中断。有关详细信息，请参阅单步执行代码、逐过程执行代码或跳出代码。

以下过程演示当您在 await 语句处选择**“单步执行”或“逐过程”**命令后将发生的情况。

将控制台应用程序中的代码替换为以下代码。

' Step Into and Step Over Example 
Imports System.Threading.Tasks

Module Module1
    Sub Main()
        ProcessAsync.Wait()
    End Sub

    Async Function ProcessAsync() As Task
        Dim result = Await DoSomethingAsync()  ' Step Into or Step Over from here

        Dim y = 0
    End Function

    Async Function DoSomethingAsync() As Task(Of Integer)
        Await Task.Delay(1000)
        Return 5
    End Function 
End Module

// Step Into and Step Over Example. 
using System.Threading.Tasks;

class Program
{
    static void Main(string[] args)
    {
        ProcessAsync().Wait();
    }

    static async Task ProcessAsync()
    {
        var result = await DoSomethingAsync();  // Step Into or Step Over from here 

        int y = 0;
    }

    static async Task<int> DoSomethingAsync()
    {
        await Task.Delay(1000);
        return 5;
    }
}

选择 F11 键，或选择菜单栏上的**“调试”和“单步执行”**，以在包含 await 运算符的语句处开始演示 Step Into 命令。

应用程序将启动并在第一行（在 Visual Basic 中为 Sub Main() 或在 C# 中为 Main 方法的左大括号）上中断。
再选择 F11 键三次。

应用程序现在应位于 ProcessAsync 方法中的 await 语句处。
选择 F11 键。

应用程序将进入 DoSomethingAsync 方法并在第一行上中断。即使应用程序将立即返回到 await 语句处的调用方法 (Main)，此行为也将出现。
一直选择 F11 键，直至应用程序返回到 ProcessAsync 方法中的 await 语句。
选择 F11 键。

应用程序将在 await 语句后面的行上中断。
在菜单栏上，选择**“调试”和“停止调试”**来停止执行应用程序。

后续步骤演示 await 语句处的**“逐过程”**命令。
选择 F11 键四次，或选择菜单栏上的**“调试”和“单步执行”**四次。

应用程序现在应位于 ProcessAsync 方法中的 await 语句处。
选择 F10 键，或选择菜单栏上的**“调试”和“逐过程”**。

执行将在 await 语句后面的行上中断。即使应用程序立即返回到 await 语句处的调用方法 (Main)，此行为也将出现。 Step Over 命令还将按预期跳出 DoSomethingAsync 方法的执行。
在菜单栏上，选择**“调试”和“停止调试”**来停止执行应用程序。

如下列步骤所示，当 await 运算符位于与对异步方法的调用不同的行上时，**“单步执行”和“逐过程”**命令的行为会略有不同。
在 ProcessAsync 方法中，将 await 语句替换为以下代码。原始 await 语句是下面两个语句的缩写式。
```
Dim theTask = DoSomethingAsync()
Dim result = Await theTask
```
```
var theTask = DoSomethingAsync();
var result = await theTask;
```
选择 F11 键或选择菜单栏上的**“调试”和“单步执行”**多次，以开始执行并单步执行代码。

在对 DoSomethingAsync 的调用中，**“单步执行”命令在 DoSomethingAsync 方法中中断，而“逐过程”**命令按预期进入下一语句。在 await 语句中，这两种命令都在 await 后面的语句处中断。

跳出

在非异步方法中，**“跳出”命令将在方法调用后面的代码上的调用方法中中断。对于异步方法，其中执行将在调用方法中中断的逻辑更复杂，此逻辑取决于“跳出”**命令是否位于异步方法的第一行。

将控制台应用程序中的代码替换为以下代码。

' Step Out Example 
Imports System.Threading.Tasks

Module Module1
    Sub Main()
        ProcessAsync.Wait()
    End Sub

    Async Function ProcessAsync() As Task
        Dim theTask = DoSomethingAsync()
        Dim z = 0
        Dim result = Await theTask
    End Function

    Async Function DoSomethingAsync() As Task(Of Integer)
        Debug.WriteLine("before")  ' Step Out from here
        Await Task.Delay(1000)
        Debug.WriteLine("after")
        Return 5
    End Function 
End Module

// Step Out Example. 
using System.Diagnostics;
using System.Threading.Tasks;

class Program
{
    static void Main(string[] args)
    {
        ProcessAsync().Wait();
    }

    static async Task ProcessAsync()
    {
        var theTask = DoSomethingAsync();
        int z = 0;
        var result = await theTask;
    }

    static async Task<int> DoSomethingAsync()
    {
        Debug.WriteLine("before");  // Step Out from here
        await Task.Delay(1000);
        Debug.WriteLine("after");
        return 5;
    }
}

在 DoSomethingAsync 方法中的 Debug.WriteLine("before") 行上设置断点。

这是为了从不是异步方法中的第一行的某个行中演示**“跳出”**命令的行为。
选择 F5 键，或选择菜单栏上的**“调试”和“启动调试”**来启动应用程序。

代码将在 DoSomethingAsync 方法中的 Debug.WriteLine("before") 上中断。
选择 Shift+F11 键，或选择菜单栏上的**“调试”和“跳出”**。

应用程序将在与当前方法关联的任务的 await 语句处的调用方法中中断。因此，应用程序将在 ProcessAsync 方法中的 await 语句上中断。应用程序不会在 Dim z = 0 (Visual Basic) 或 int z = 0; (C#) 上中断，它是对 DoSomethingAsync 方法的调用后面的代码。
选择菜单栏上的**“调试”和“停止调试”**来停止执行应用程序。

后续步骤演示在从异步方法的第一行**“跳出”**时将发生的情况。
移除现有断点，并在 DoSomethingAsync 方法的第一行上添加断点。

在 C# 中，在 DoSomethingAsync 方法的左大括号处添加断点。在 Visual Basic 中，在包含 Async Function DoSomethingAsync() As Task(Of Integer) 的行上添加断点。
选择 F5 键以启动应用程序。

代码将在 DoSomethingAsync 方法的第一行上中断。
在菜单栏上，依次选择**“调试”、“窗口”和“输出”**。

将打开**“输出”**窗口。
选择 Shift+F11 键，或选择菜单栏上的**“调试”和“跳出”**。

应用程序将继续执行，直到异步方法到达其第一个 await，然后应用程序将在调用语句处中断。因此，应用程序将在 Dim the Task = DoSomethingAsync() (Visual Basic) 或 var theTask = DoSomethingAsync(); (C#) 上中断。 “before”消息已显示在“输出”窗口中，而“after”消息尚未显示。
选择 F5 键以继续运行应用程序。

应用程序将继续执行已调用的异步函数 (DoSomethingAsync) 中的 await 语句后面的语句。 “after”消息将显示在“输出”窗口中。

请参见

概念

在 Visual Studio 中启动、中断、单步执行、通过代码运行和停止调试

通过

演练：将调试器与异步方法一起使用

用于显示控制流的断点

获取并等待任务

单步执行和逐过程

跳出

请参见

概念

其他资源