逐步解說：搭配非同步方法使用偵錯工具

發行項
06/10/2015

使用 Async 功能，您就可以呼叫非同步方法，而不需要使用回呼或將您的程式碼分散到多種方法或 lambda 運算式上。若要讓同步程式碼變成非同步，請呼叫非同步方法，而不要呼叫同步方法，然後再加入幾個關鍵字到程式碼中。如需詳細資訊，請參閱使用 Async 和 Await 設計非同步程式 (C# 和 Visual Basic)。

在 Visual Studio 偵錯工具中，您可以使用 [逐步執行]、[不進入函式] 和 [跳離函式] 命令搭配 Async 功能。您也可以繼續使用中斷點，特別是在包含 await 運算子的陳述式中檢視控制流程。在這個逐步解說中，您將完成下列工作，這些工作可依任意順序執行。

使用中斷點示範 await 陳述式中的控制流程。
了解 [逐步執行] 和 [不進入函式] 命令在包含 await 運算子之陳述式中的行為。
了解從非同步方法內部使用 [跳離函式] 命令時，該命令的行為。

顯示控制流程的中斷點

如果您以 Async (Visual Basic) 或 async (C#) 修飾詞標記方法，就可以在該方法中使用 Await (Visual Basic) 或 await (C#) 運算子。若要建立 await 運算式，請將 await 運算子與工作產生關聯。針對工作呼叫 await 運算式時，目前方法會立即結束，並傳回不同的工作。與 await 運算子相關聯的工作完成時，就會在相同方法中繼續執行。如需詳細資訊，請參閱非同步程式中的控制流程 (C# 和 Visual Basic)。

注意事項
非同步方法會在遇到第一個不完整的等候物件或是到達非同步方法的結尾時 (以先發生者為準)，返回呼叫端。

注意事項
這些範例中的主控台應用程式會使用 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;
    }
}

在以「設定中斷點」註解結尾的三個程式行上設定偵錯中斷點。
選擇 F5 鍵，或是在功能表列上選擇 [偵錯]、[開始偵錯] 執行應用程式。

應用程式會進入 ProcessAsync 方法，並且在包含 await 運算子的程式行上中斷。
再次選擇 F5 鍵。

因為應用程式在包含 await 運算子的陳述式上停止，所以應用程式會立即結束非同步方法並傳回工作。因此，應用程式會結束 ProcessAsync 方法，並且在呼叫方法 (Main) 中的中斷點處中斷。
再次選擇 F5 鍵。

當 DoSomethingAsync 方法完成時，程式碼會在呼叫方法中的 await 陳述式之後繼續。因此，應用程式會在 ProcessAsync 方法中的中斷點處中斷。

當 DoSomethingAsync 初次等候時，ProcessAsync 方法會結束並傳回工作。接著等候的 DoSomethingAsync 方法就會完成，await 陳述式的評估會產生 DoSomethingAsync 的傳回值。 DoSomethingAsync 方法定義為傳回 Task (Of Integer) (Visual Basic 中) 或 Task<int> (C# 中)，因此其傳回陳述式中的值為整數。如需詳細資訊，請參閱非同步方法的傳回類型 (C# and 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 運算子相關聯的工作完成時，程式碼會在方法 (ProcessAsync) 中的 await 陳述式之後繼續。

當 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#) 中斷。「之前」訊息出現在 [輸出] 視窗中，但是「之後」訊息尚未出現。
選擇 F5 鍵，繼續執行應用程式。

應用程式會繼續執行，而且陳述式會接在呼叫的非同步函式 (DoSomethingAsync) 中的 await 陳述式後面。「之後」訊息會出現在 [輸出] 視窗中。

請參閱

概念

在 Visual Studio 中啟動、中斷、逐步執行、執行程式碼以及停止偵錯

共用方式為

逐步解說：搭配非同步方法使用偵錯工具

顯示控制流程的中斷點

取得然後等候工作

逐步執行和不進入函式

跳離函式

請參閱

概念

其他資源