Task<TResult> 类
定义
重要
一些信息与预发行产品相关,相应产品在发行之前可能会进行重大修改。 对于此处提供的信息,Microsoft 不作任何明示或暗示的担保。
表示一个可以返回值的异步操作。
generic <typename TResult>
public ref class Task : System::Threading::Tasks::Task
public class Task<TResult> : System.Threading.Tasks.Task
type Task<'Result> = class
inherit Task
Public Class Task(Of TResult)
Inherits Task
类型参数
- TResult
此 Task<TResult> 生成的结果的类型。
- 继承
注解
类 Task<TResult> 表示返回值且通常以异步方式执行的单个操作。 Task<TResult>对象是.NET Framework 4 中首次引入的基于任务的异步模式的核心组件之一。 由于 对象执行Task<TResult>的工作通常在线程池线程上异步执行,而不是在main应用程序线程上同步执行,因此可以使用 Status 属性以及 IsCanceled、 IsCompleted和 IsFaulted 属性来确定任务的状态。 大多数情况下,lambda 表达式用于指定任务要执行的工作。
Task<TResult> 可以通过多种方式创建实例。 从 .NET Framework 4.5 开始,最常见的方法是调用静态 Task.Run<TResult>(Func<TResult>) 或 Task.Run<TResult>(Func<TResult>, CancellationToken) 方法。 这些方法提供了一种使用默认值启动任务的简单方法,无需获取其他参数。 以下示例使用 Task.Run<TResult>(Func<TResult>) 方法启动循环任务,然后显示循环迭代次数:
using System;
using System.Threading.Tasks;
public class Example
{
public static void Main()
{
var t = Task<int>.Run( () => {
// Just loop.
int max = 1000000;
int ctr = 0;
for (ctr = 0; ctr <= max; ctr++) {
if (ctr == max / 2 && DateTime.Now.Hour <= 12) {
ctr++;
break;
}
}
return ctr;
} );
Console.WriteLine("Finished {0:N0} iterations.", t.Result);
}
}
// The example displays output like the following:
// Finished 1,000,001 loop iterations.
Imports System.Threading.Tasks
Module Example
Public Sub Main()
Dim t As Task(Of Integer) = Task.Run(Function()
Dim max As Integer = 1000000
Dim ctr As Integer
For ctr = 0 to max
If ctr = max \ 2 And Date.Now.Hour <= 12 Then
ctr += 1
Exit For
End If
Next
Return ctr
End Function)
Console.WriteLine("Finished {0:N0} iterations.", t.Result)
End Sub
End Module
' The example displays the following output:
' Finished 1,000,001 loop iterations
在 .NET Framework 4 中启动任务的一种替代方法是调用静态 TaskFactory.StartNew 或 TaskFactory<TResult>.StartNew 方法。 属性 Task.Factory 返回 对象 TaskFactory ,属性 Task<TResult>.Factory 返回 TaskFactory<TResult> 对象。 其 StartNew
方法的重载允许传递参数、定义任务创建选项以及指定任务计划程序。 以下示例使用 TaskFactory<TResult>.StartNew(Func<TResult>) 方法启动任务。 它在功能上等效于上一示例中的代码。
using System;
using System.Threading.Tasks;
public class Example
{
public static void Main()
{
var t = Task<int>.Factory.StartNew( () => {
// Just loop.
int max = 1000000;
int ctr = 0;
for (ctr = 0; ctr <= max; ctr++) {
if (ctr == max / 2 && DateTime.Now.Hour <= 12) {
ctr++;
break;
}
}
return ctr;
} );
Console.WriteLine("Finished {0:N0} iterations.", t.Result);
}
}
// The example displays the following output:
// Finished 1000001 loop iterations
Imports System.Threading.Tasks
Module Example
Public Sub Main()
Dim t = Task(Of Integer).Factory.StartNew(Function()
Dim max As Integer = 1000000
Dim ctr As Integer
For ctr = 0 to max
If ctr = max \ 2 And Date.Now.Hour <= 12 Then
ctr += 1
Exit For
End If
Next
Return ctr
End Function)
Console.WriteLine("Finished {0:N0} iterations.", t.Result)
End Sub
End Module
' The example displays output like the following:
' Finished 1,000,001 iterations
有关更完整的示例,请参阅 基于任务的异步编程。
类 Task<TResult> 还提供用于初始化任务但不计划任务的构造函数以供执行。 出于性能原因, Task.Run 和 Task.Factory.StartNew
方法是用于创建和计划计算任务的首选机制,但对于必须分离任务创建和计划的方案,可以使用构造函数,然后可以使用任务的 Start 方法来计划稍后执行的任务。
从面向 .NET Framework 4.6 的桌面应用开始,创建和调用任务的线程区域性将成为线程上下文的一部分。 也就是说,无论执行任务的线程的当前区域性如何,任务的当前区域性都是调用线程的区域性。 对于面向 .NET Framework 4.6 之前的 .NET Framework 版本的应用,任务的区域性是执行任务的线程的区域性。 有关详细信息,请参阅主题中的“区域性和基于任务的异步操作”部分 CultureInfo 。 请注意,应用商店应用遵循设置和获取默认区域性Windows 运行时。
对于不返回值的操作,请使用 Task 类。 从 C# 7.0 开始,对于作为值类型而不是引用类型的更轻量级的任务,请使用 System.Threading.Tasks.ValueTask<TResult> 结构。
构造函数
Task<TResult>(Func<Object,TResult>, Object) |
使用指定的函数和状态初始化新的 Task<TResult>。 |
Task<TResult>(Func<Object,TResult>, Object, CancellationToken) |
使用指定的操作、状态和选项初始化新的 Task<TResult>。 |
Task<TResult>(Func<Object,TResult>, Object, CancellationToken, TaskCreationOptions) |
使用指定的操作、状态和选项初始化新的 Task<TResult>。 |
Task<TResult>(Func<Object,TResult>, Object, TaskCreationOptions) |
使用指定的操作、状态和选项初始化新的 Task<TResult>。 |
Task<TResult>(Func<TResult>) |
使用指定的函数初始化新的 Task<TResult>。 |
Task<TResult>(Func<TResult>, CancellationToken) |
使用指定的函数初始化新的 Task<TResult>。 |
Task<TResult>(Func<TResult>, CancellationToken, TaskCreationOptions) |
使用指定的函数和创建选项初始化新的 Task<TResult>。 |
Task<TResult>(Func<TResult>, TaskCreationOptions) |
使用指定的函数和创建选项初始化新的 Task<TResult>。 |
属性
AsyncState |
获取在创建 Task 时提供的状态对象,如果未提供,则为 null。 (继承自 Task) |
CreationOptions |
获取用于创建此任务的 TaskCreationOptions。 (继承自 Task) |
Exception |
获取导致 AggregateException 提前结束的 Task。 如果 Task 成功完成或尚未引发任何异常,这将返回 |
Factory |
获取用于创建和配置 Task<TResult> 实例的工厂方法。 |
Id |
获取此 Task 实例的 ID。 (继承自 Task) |
IsCanceled |
获取此 Task 实例是否由于被取消的原因而已完成执行。 (继承自 Task) |
IsCompleted |
获取一个值,它表示是否已完成任务。 (继承自 Task) |
IsCompletedSuccessfully |
了解任务是否运行到完成。 (继承自 Task) |
IsFaulted |
获取 Task 是否由于未经处理异常的原因而完成。 (继承自 Task) |
Result |
获取此 Task<TResult> 的结果值。 |
Status |
获取此任务的 TaskStatus。 (继承自 Task) |
方法
显式接口实现
IAsyncResult.AsyncWaitHandle |
获取可用于等待任务完成的 WaitHandle。 (继承自 Task) |
IAsyncResult.CompletedSynchronously |
获取操作是否已同步完成的指示。 (继承自 Task) |
扩展方法
适用于
线程安全性
除 之外Dispose()的所有 成员Task<TResult>都是线程安全的,并且可以同时从多个线程使用。
另请参阅
反馈
https://aka.ms/ContentUserFeedback。
即将发布:在整个 2024 年,我们将逐步淘汰作为内容反馈机制的“GitHub 问题”,并将其取代为新的反馈系统。 有关详细信息,请参阅:提交和查看相关反馈