大网数据广告活动
.NET 与 C# 开发

异步程序中的控制流 (Visual Basic)

· 52CE 我爱测

可以使用 Async 和 Await 关键字更加轻松地编写和维护异步程序。 但是,如果不了解程序的运行方式,结果可能会让你大吃一惊。 此主题通过一个简单的异步程序跟踪控制流,以显示控制从一种方法移动到另一种方法的情况,以及每次所传输的信息。

可以使用 Async 和 Await 关键字更加轻松地编写和维护异步程序。 但是,如果不了解程序的运行方式,结果可能会让你大吃一惊。 此主题通过一个简单的异步程序跟踪控制流,以显示控制从一种方法移动到另一种方法的情况,以及每次所传输的信息。

Note: Async 和 Await 关键字是在 Visual Studio 2012 中引入的。

通常, 可通过Async修饰符标记包含异步代码的方法。 在使用 async 修饰符标记的方法中, 可以使用Await (Visual Basic)运算符来指定方法的暂停位置, 以等待调用的异步进程完成。 有关详细信息, 请参阅采用 Async 和 Await 的异步编程 (Visual Basic)。

下面的示例使用异步方法以字符串的形式下载指定网站的内容,并显示该字符串的长度。 此示例包含以下两种方法。

编号的显示行显示在整个程序的策略点处,以帮助你了解程序的运行方式和说明被标记的每个点处发生的情况。 显示行标记为“1”到“6”。 该标签表示程序到达这些代码行的顺序。

下面的代码显示该程序的概要。

Class MainWindow

    Private Async Sub StartButton_Click(sender As Object, e As RoutedEventArgs) Handles StartButton.Click

        ' ONE
        Dim getLengthTask As Task(Of Integer) = AccessTheWebAsync()

        ' FOUR
        Dim contentLength As Integer = Await getLengthTask

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

    End Sub

    Async Function AccessTheWebAsync() As Task(Of Integer)

        ' TWO
        Dim client As HttpClient = New HttpClient()
        Dim getStringTask As Task(Of String) =
            client.GetStringAsync("https://msdn.microsoft.com")

        ' THREE
        Dim urlContents As String = Await getStringTask

        ' FIVE
        Return urlContents.Length
    End Function

End Class

每个标记位置(“1”到“6”)显示有关该程序的当前状态的信息。 将生成以下输出。

ONE:   Entering startButton_Click.
           Calling AccessTheWebAsync.

TWO:   Entering AccessTheWebAsync.
           Calling HttpClient.GetStringAsync.

THREE: Back in AccessTheWebAsync.
           Task getStringTask is started.
           About to await getStringTask & return a Task<int> to startButton_Click.

FOUR:  Back in startButton_Click.
           Task getLengthTask is started.
           About to await getLengthTask -- no caller to return to.

FIVE:  Back in AccessTheWebAsync.
           Task getStringTask is complete.
           Processing the return statement.
           Exiting from AccessTheWebAsync.

SIX:   Back in startButton_Click.
           Task getLengthTask is finished.
           Result from AccessTheWebAsync is stored in contentLength.
           About to display contentLength and exit.

Length of the downloaded string: 33946.

设置程序

可以从 MSDN 下载本主题使用的代码,也可以自行生成该代码。

Note: 若要运行该示例, 必须在计算机上安装 Visual Studio 2012 或更高版本, 并安装 .NET Framework 4.5 或更高版本。

下载程序

可以从异步示例:异步程序中的控制流中下载此主题的应用。 以下步骤将打开并运行该程序。

  1. 解压缩下载的文件,然后启动 Visual Studio。

  2. 在菜单栏上,依次选择 “文件” 、 “打开” 和 “项目/解决方案” 。

  3. 导航到保存已解压缩的示例代码的文件夹,打开解决方案 (.sln) 文件,然后选择 F5 键以生成并运行项目。

您自行生成程序

以下 Windows Presentation Foundation (WPF) 项目包含本主题的代码示例。

若要运行项目,请执行下列步骤:

  1. 启动 Visual Studio。

  2. 在菜单栏上,依次选择“文件”、“新建”、“项目”。

    “新建项目” 对话框随即打开。

  3. 在 "已安装的模板" 窗格中选择 " Visual Basic", 然后从项目类型列表中选择 " WPF 应用程序"。

  4. 输入 AsyncTracer 作为项目名称,然后选择“确定” 按钮。

    新项目将出现在“解决方案资源管理器” 中。

  5. 在 Visual Studio 代码编辑器中,选择 “MainWindow.xaml” 选项卡。

    如果此选项卡不可见,则在“解决方案资源管理器” 中,打开 MainWindow.xaml 的快捷菜单,然后选择“查看代码” 。

  6. 在 MainWindow.xaml 的“XAML” 视图中,将代码替换为以下代码。

    <Window
        xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation"
        xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"
        xmlns:d="http://schemas.microsoft.com/expression/blend/2008" xmlns:mc="http://schemas.openxmlformats.org/markup-compatibility/2006" mc:Ignorable="d" x:Class="MainWindow"
        Title="Control Flow Trace" Height="350" Width="525">
        <Grid>
            <Button x:Name="StartButton" Content="Start" HorizontalAlignment="Left" Margin="221,10,0,0" VerticalAlignment="Top" Width="75"/>
            <TextBox x:Name="ResultsTextBox" HorizontalAlignment="Left" TextWrapping="Wrap" VerticalAlignment="Bottom" Width="510" Height="265" FontFamily="Lucida Console" FontSize="10" VerticalScrollBarVisibility="Visible" d:LayoutOverrides="HorizontalMargin"/>
    
        </Grid>
    </Window>
    

    MainWindow.xaml 的“设计” 视图中将显示一个简单的窗口,其中包含一个文本框和一个按钮。

  7. 对 xref:System.Net.Http 添加引用。

  8. 在解决方案资源管理器中, 打开 mainwindow.xaml 的快捷菜单, 然后选择 "查看代码"。

  9. 在 Mainwindow.xaml 中, 将代码替换为以下代码。

    ' Add an Imports statement and a reference for System.Net.Http.
    Imports System.Net.Http
    
    Class MainWindow
    
        Private Async Sub StartButton_Click(sender As Object, e As RoutedEventArgs) Handles StartButton.Click
    
            ' The display lines in the example lead you through the control shifts.
            ResultsTextBox.Text &= "ONE:   Entering StartButton_Click." & vbCrLf &
                "           Calling AccessTheWebAsync." & vbCrLf
    
            Dim getLengthTask As Task(Of Integer) = AccessTheWebAsync()
    
            ResultsTextBox.Text &= vbCrLf & "FOUR:  Back in StartButton_Click." & vbCrLf &
                "           Task getLengthTask is started." & vbCrLf &
                "           About to await getLengthTask -- no caller to return to." & vbCrLf
    
            Dim contentLength As Integer = Await getLengthTask
    
            ResultsTextBox.Text &= vbCrLf & "SIX:   Back in StartButton_Click." & vbCrLf &
                "           Task getLengthTask is finished." & vbCrLf &
                "           Result from AccessTheWebAsync is stored in contentLength." & vbCrLf &
                "           About to display contentLength and exit." & vbCrLf
    
            ResultsTextBox.Text &=
                String.Format(vbCrLf & "Length of the downloaded string: {0}." & vbCrLf, contentLength)
        End Sub
    
        Async Function AccessTheWebAsync() As Task(Of Integer)
    
            ResultsTextBox.Text &= vbCrLf & "TWO:   Entering AccessTheWebAsync."
    
            ' Declare an HttpClient object.
            Dim client As HttpClient = New HttpClient()
    
            ResultsTextBox.Text &= vbCrLf & "           Calling HttpClient.GetStringAsync." & vbCrLf
    
            ' GetStringAsync returns a Task(Of String).
            Dim getStringTask As Task(Of String) = client.GetStringAsync("https://msdn.microsoft.com")
    
            ResultsTextBox.Text &= vbCrLf & "THREE: Back in AccessTheWebAsync." & vbCrLf &
                "           Task getStringTask is started."
    
            ' AccessTheWebAsync can continue to work until getStringTask is awaited.
    
            ResultsTextBox.Text &=
                vbCrLf & "           About to await getStringTask & return a Task(Of Integer) to StartButton_Click." & vbCrLf
    
            ' Retrieve the website contents when task is complete.
            Dim urlContents As String = Await getStringTask
    
            ResultsTextBox.Text &= vbCrLf & "FIVE:  Back in AccessTheWebAsync." &
                vbCrLf & "           Task getStringTask is complete." &
                vbCrLf & "           Processing the return statement." &
                vbCrLf & "           Exiting from AccessTheWebAsync." & vbCrLf
    
            Return urlContents.Length
        End Function
    
    End Class
    
  10. 按 F5 键以运行程序,然后选择 “启动” 按钮。

    应出现以下输出。

    ONE:   Entering startButton_Click.
               Calling AccessTheWebAsync.
    
    TWO:   Entering AccessTheWebAsync.
               Calling HttpClient.GetStringAsync.
    
    THREE: Back in AccessTheWebAsync.
               Task getStringTask is started.
               About to await getStringTask & return a Task<int> to startButton_Click.
    
    FOUR:  Back in startButton_Click.
               Task getLengthTask is started.
               About to await getLengthTask -- no caller to return to.
    
    FIVE:  Back in AccessTheWebAsync.
               Task getStringTask is complete.
               Processing the return statement.
               Exiting from AccessTheWebAsync.
    
    SIX:   Back in startButton_Click.
               Task getLengthTask is finished.
               Result from AccessTheWebAsync is stored in contentLength.
               About to display contentLength and exit.
    
    Length of the downloaded string: 33946.
    

跟踪程序

步骤 1 和步骤 2

在 startButton_Click 调用 AccessTheWebAsync 及 AccessTheWebAsync 调用异步 xref:System.Net.Http.HttpClient 方法 xref:System.Net.Http.HttpClient.GetStringAsync(System.String) 时,前两个显示行会跟踪路径。 下图概述了从方法到方法的调用。

步骤 1 和步骤 2

AccessTheWebAsync 和 client.GetStringAsync 的返回类型都是 xref:System.Threading.Tasks.Task`1。 对于 AccessTheWebAsync,TResult 是一个整数。 对于 GetStringAsync,TResult 是一个字符串。 有关异步方法返回类型的详细信息, 请参阅异步返回类型 (Visual Basic)。

在控制切换回调用方时,任务返回异步方法将返回一个任务实例。 在调用的方法中遇到 Await 运算符或在调用的方法结束时,控制会从异步方法返回其调用方。 标记为“3”到“6”的显示行将跟踪过程的这一部分。

步骤 3

在 AccessTheWebAsync 中,调用异步方法 xref:System.Net.Http.HttpClient.GetStringAsync(System.String) 以下载目标网页的内容。 返回 client.GetStringAsync 时,控制将从 client.GetStringAsync 返回到 AccessTheWebAsync。

client.GetStringAsync 方法将返回分配给 AccessTheWebAsync 中的 getStringTask 变量的字符串任务。 该示例程序中的以下行说明了对 client.GetStringAsync 的调用和赋值。

Dim getStringTask As Task(Of String) = client.GetStringAsync("https://msdn.microsoft.com")

可以将任务视为 client.GetStringAsync 的一个承诺,用于最终生成实际字符串。 同时,如果 AccessTheWebAsync 有要执行的工作,且该工作不依赖于 client.GetStringAsync 中承诺的字符串,则可在 client.GetStringAsync 等待时继续此工作。 在示例中,以下标记为“3”的输出行表示执行独立工作的机会

THREE: Back in AccessTheWebAsync.
           Task getStringTask is started.
           About to await getStringTask & return a Task<int> to startButton_Click.

当 getStringTask 处于等待状态时,下面的语句将暂停 AccessTheWebAsync 中的进度。

Dim urlContents As String = Await getStringTask

下图显示了从client.GetStringAsync到的getStringTask赋值getStringTask以及从创建到 Await 运算符的应用程序的控制流。

步骤 3

Await 表达式将暂停 AccessTheWebAsync,直到返回 client.GetStringAsync。 同时,控件返回至 AccessTheWebAsync 的调用方 startButton_Click。

Note: 通常情况下,应立即等待对异步方法的调用。 例如,以下赋值可以替换前面创建的代码,然后等待 getStringTask:Dim urlContents As String = Await client.GetStringAsync("https://msdn.microsoft.com")

在本主题中,稍后将应用 await 运算符,以容纳通过程序标记控制流的输出行。

步骤 4

AccessTheWebAsync 的声明的返回类型是 Task(Of Integer)。 因此,当 AccessTheWebAsync 处于挂起状态时,它会将整数任务返回到 startButton_Click。 应该了解返回的任务不是 getStringTask。 返回的任务是一个新的整数任务,它表示挂起的方法 AccessTheWebAsync 中仍需完成的任务。 该任务是 AccessTheWebAsync 中的一个承诺,当任务完成时,将生成一个整数。

下列语句将此任务分配给 getLengthTask 变量。

Dim getLengthTask As Task(Of Integer) = AccessTheWebAsync()

如 AccessTheWebAsync 中一样,startButton_Click 可以继续执行不依赖于异步任务 (getLengthTask) 的结果的工作,直到该任务处于等待状态。 下面的输出行表示该工作。

FOUR:  Back in startButton_Click.
           Task getLengthTask is started.
           About to await getLengthTask -- no caller to return to.

当 getLengthTask 处于等待状态时,startButton_Click 中的进度将挂起。 下面的赋值语句将挂起 startButton_Click,直到完成 AccessTheWebAsync。

Dim contentLength As Integer = Await getLengthTask

下图中的箭头显示控制流,该控制流从 AccessTheWebAsync 中的 await 表达式到 getLengthTask 的赋值值,后跟 startButton_Click 中的正常处理,直到 getLengthTask 处于等待状态。

步骤 4

步骤 5

当 client.GetStringAsync 指示它已完成时,AccessTheWebAsync 中的处理将从挂起状态释放,且可以继续通过 await 语句。 下面的输出行表示继续处理。

FIVE:  Back in AccessTheWebAsync.
           Task getStringTask is complete.
           Processing the return statement.
           Exiting from AccessTheWebAsync.

return 语句 urlContents.Length 的操作数存储于 AccessTheWebAsync 返回的任务中。 Await 表达式从 startButton_Click 中的 getLengthTask 检索该值。

下图显示了完成 client.GetStringAsync(和 getStringTask)后控制的转移。

步骤 5

AccessTheWebAsync 将一直运行直到完成,且控制将返回到 startButton_Click,它正在等待完成。

步骤 6

当 AccessTheWebAsync 指示它已完成时,处理可以继续通过 startButton_Async 中的 await 语句。 事实上,该程序没有更多可执行的操作。

下面的输出行表示 startButton_Async 中处理的恢复:

SIX:   Back in startButton_Click.
           Task getLengthTask is finished.
           Result from AccessTheWebAsync is stored in contentLength.
           About to display contentLength and exit.

Await 表达式从 getLengthTask 中检索为 AccessTheWebAsync 中 return 语句的操作数的整数值。 下面的语句将该值赋给 contentLength 变量。

Dim contentLength As Integer = Await getLengthTask

下图显示从 AccessTheWebAsync 到 startButton_Click 的控制的返回。

步骤 6

请参阅

历史资料。此文对应 2019-08-18 的中文文档快照,适用产品版本和命令行为以原文为准。

来源与署名:Microsoft 和文档贡献者。固定版本原文。文档采用 CC BY 4.0,示例代码采用 MIT 授权。本站将 Markdown 转为 HTML,规范化链接,移除外部媒体和导航标记。

资料来源与适用范围

资料来源
Microsoft / .NET 中文文档历史快照
适用范围
历史中文快照 2019-08-18;详见原文产品版本;文档日期 07/20/2015
内容语言
中文;命令、路径和错误标识保留技术原文
本地收录日期
2026-11-16
授权说明
CC BY 4.0(文档)/ MIT(示例代码)

正文与所需资源由本站本地存储。查看来源及更新记录 ↗

请按适用版本和实际日志确认原因;本站没有对每一种系统或设备逐项执行文中的操作。