-
C#多线程(14)：任务基础②
上一篇，我们学习了任务的基础，学会多种方式场景任务和执行，异步获取返回结果等。上一篇讲述的知识比较多，这一篇只要是代码实践和示例操作。
判断任务状态
| 属性 | 说明 |
|---|---|
| IsCanceled | 获取此 Task 实例是否由于被取消的原因而已完成执行。 |
| IsCompleted | 获取一个值，它表示是否已完成任务。 |
| IsCompletedSuccessfully | 了解任务是否运行到完成。 |
| IsFaulted | 获取 Task是否由于未经处理异常的原因而完成。 |
| Status | 获取此任务的 TaskStatus。 |
要检测一个任务是否出错(指任务因未经处理的异常而导致工作终止)，要使用 IsCanceled 和 IsFaulted 两个属性，只要任务抛出异常，IsFaulted 为 true。但是取消任务本质是抛出 OperationCancelExcetion 异常，不代表任务出错。
即使任务抛出了未经处理的异常，也算是完成了任务，因此 IsCompleted 属性，会为 true。
示例如下：
代码有点多，不易观察，请复制到程序中运行。
class Program
{
static void Main()
{
// 正常任务
Task task1 = new Task(() =>
{
});
task1.Start();
Thread.Sleep(TimeSpan.FromSeconds(1));
GetResult(task1.IsCanceled, task1.IsFaulted);
Console.WriteLine("任务是否完成：" + task1.IsCompleted);
Console.WriteLine("-------------------");
// 异常任务
Task task2 = new Task(() =>
{
throw new Exception();
});
task2.Start();
Thread.Sleep(TimeSpan.FromSeconds(1));
GetResult(task2.IsCanceled, task2.IsFaulted);
Console.WriteLine("任务是否完成：" + task2.IsCompleted);
Console.WriteLine("-------------------");
Thread.Sleep(TimeSpan.FromSeconds(1));
CancellationTokenSource cts = new CancellationTokenSource();
// 取消任务
Task task3 = new Task(() =>
{
Thread.Sleep(TimeSpan.FromSeconds(3));
}, cts.Token);
task3.Start();
cts.Cancel();
Thread.Sleep(TimeSpan.FromSeconds(1));
GetResult(task3.IsCanceled, task3.IsFaulted);
Console.WriteLine("任务是否完成：" + task3.IsCompleted);
Console.ReadKey();
}
public static void GetResult(bool isCancel, bool isFault)
{
if (isCancel == false && isFault == false)
Console.WriteLine("没有异常发生");
else if (isCancel == true)
Console.WriteLine("任务被取消");
else
Console.WriteLine("任务引发了未经处理的异常");
}
}
再说父子任务
在上一篇文章中《C#多线程(13)：任务基础①》，我们学习了父子任务，父任务需要等待子任务完成后才算完成任务。
上一章只是给出示例，没有明确说明场景和实验结果，这里重新写一个示例来补充。
非父子任务：
外层任务不会等待内嵌的任务完成，直接完成或返回结果。
static void Main()
{
//两个任务没有从属关系，是独立的
Task<int> task = new Task<int>(() =>
{
// 非子任务
Task task1 = new Task(() =>
{
Thread.Sleep(TimeSpan.FromSeconds(1));
for (int i = 0; i < 5; i++)
{
Console.WriteLine(" 内层任务1");
Thread.Sleep(TimeSpan.FromSeconds(0.5));
}
});
task1.Start();
return 666;
});
task.Start();
Console.WriteLine($"任务运算结果是：{task.Result}");
Console.WriteLine("\n-------------------\n");
Console.ReadKey();
}
父子任务：
父任务等待子任务完成后，才能算完成任务，然后返回结果。
static void Main()
{
// 父子任务
Task<int> task = new Task<int>(() =>
{
// 子任务
Task task1 = new Task(() =>
{
Thread.Sleep(TimeSpan.FromSeconds(1));
for (int i = 0; i < 5; i++)
{
Console.WriteLine(" 内层任务1");
Thread.Sleep(TimeSpan.FromSeconds(0.5));
}
}, TaskCreationOptions.AttachedToParent);
task1.Start();
Console.WriteLine("最外层任务");
return 666;
});
task.Start();
Console.WriteLine($"任务运算结果是：{task.Result}");
Console.WriteLine("\n-------------------\n");
Console.ReadKey();
}
组合任务/延续任务
Task.ContinueWith() 方法创建一个在 任务(Task)实例 完成时异步执行的延续任务。
Task.ContinueWith() 的重载方法非常多，可以参考：https://docs.microsoft.com/zh-cn/dotnet/api/system.threading.tasks.task.continuewith?view=netcore-3.1#--
这里我们使用的构造函数定义如下：
public Task ContinueWith(Action<Task> continuationAction);
一个简单的示例：
Task task = new Task(() =>
{
Console.WriteLine(" 第一个任务");
Thread.Sleep(TimeSpan.FromSeconds(2));
});
// 接下来第二个任务
task.ContinueWith(t =>
{
Console.WriteLine($" 第二个任务}");
Thread.Sleep(TimeSpan.FromSeconds(2));
});
task.Start();
一个任务(Task) 是可以设置多个延续任务的，这些任务是并行的，例如：
static void Main()
{
Task task = new Task(() =>
{
Console.WriteLine(" 第一个任务");
Thread.Sleep(TimeSpan.FromSeconds(1));
});
// 任务①
task.ContinueWith(t =>
{
for (int i = 0; i < 5; i++)
{
Console.WriteLine($" 任务① ");
Thread.Sleep(TimeSpan.FromSeconds(1));
}
});
// 任务②
task.ContinueWith(t =>
{
for (int i = 0; i < 5; i++)
{
Console.WriteLine($" 任务②");
Thread.Sleep(TimeSpan.FromSeconds(1));
}
});
// 任务① 和 任务② 属于同级并行任务
task.Start();
}
通过多次实现延续/组合任务，会实现强有力的任务流程。
复杂的延续任务
经过上一小节，我们学习了 ContinueWith() 来延续任务，现在我们来学习更多的重载方法，实现更加复杂的延续。
ContinueWith() 重载方法很多，它们的参数都含有下面几种参数之一或多个。
-
continuationAction
类型：Action 或 Func
一个要执行的任务。
-
state
类型：Object
给延续任务传递的参数。
-
cancellationToken
类型：CancellationToken
取消标记。
-
continuationOptions
类型：TaskContinuationOptions
控制延续任务的创建和特性。
-
scheduler
类型：TaskScheduler
要与延续任务关联并用于其执行过程的 TaskScheduler。
前面四个参数(类型)，在以往的文章中已经出现过，这里就不再赘述；TaskScheduler 类型，这里先讲解，后面再说。
注意 TaskCreationOptions 和 TaskContinuationOptions 的区别，在前一篇我们学习过 TaskCreationOptions。这里来学习 TaskContinuationOptions 。
TaskContinuationOptions 可以在以下重载上使用：
ContinueWith(Action, CancellationToken, TaskContinuationOptions, TaskScheduler)
ContinueWith(Action>, TaskContinuationOptions
在延续中，这样使用是无效的：
Task task = new Task(() =>
{
Console.WriteLine(" 第一个任务");
Thread.Sleep(TimeSpan.FromSeconds(1));
});
task.ContinueWith(t =>
{
for (int i = 0; i < 5; i++)
{
Console.WriteLine($" 任务① ");
Thread.Sleep(TimeSpan.FromSeconds(1));
}
},TaskContinuationOptions.AttachedToParent);
因为 TaskContinuationOptions 需要有嵌套关系的父子任务，才能生效。
正确使用方法：
static void Main()
{
// 父子任务
Task<int> task = new Task<int>(() =>
{
// 子任务
Task task1 = new Task(() =>
{
Thread.Sleep(TimeSpan.FromSeconds(1));
Console.WriteLine(" 内层任务1");
Thread.Sleep(TimeSpan.FromSeconds(0.5));
}, TaskCreationOptions.AttachedToParent);
task1.ContinueWith(t =>
{
Thread.Sleep(TimeSpan.FromSeconds(1));
Console.WriteLine("内层延续任务，也属于子任务");
Thread.Sleep(TimeSpan.FromSeconds(0.5));
}, TaskContinuationOptions.AttachedToParent);
task1.Start();
Console.WriteLine("最外层任务");
return 666;
});
task.Start();
Console.WriteLine($"任务运算结果是：{task.Result}");
Console.WriteLine("\n-------------------\n");
Console.ReadKey();
}
并行(异步)处理任务
这里我们来学习 Task.WhenAll() 方法的使用。
Task.WhenAll() ：等待提供的所有 Task 对象完成执行过程
使用示例如下：
static void Main()
{
List<Task> tasks = new List<Task>();
for (int i = 0; i < 5; i++)
tasks.Add(Task.Run(() =>
{
Console.WriteLine($"任务开始执行");
}));
// public static Task WhenAll(IEnumerable<Task> tasks);
// 相当于多个任务，生成一个任务
Task taskOne = Task.WhenAll(tasks);
// 不需要等待的话就去除
taskOne.Wait();
Console.ReadKey();
}
Task taskOne = Task.WhenAll(tasks); 可以写成 Task.WhenAll(tasks);，返回的 Task 对象可以用来判断任务执行情况。
要注意，下面这样是无效的：
你可以修改上面的代码进行测试。
tasks.Add(new Task(() =>
{
Console.WriteLine($"任务开始执行");
}));
我也不知道为啥 new Task() 不行。。。
如果任务有返回值，则可以使用下面这种方法
static void Main()
{
List<Task<int>> tasks = new List<Task<int>>();
for (int i = 0; i < 5; i++)
tasks.Add(Task.Run<int>(() =>
{
Console.WriteLine($"任务开始执行");
return new Random().Next(0,10);
}));
Task<int[]> taskOne = Task.WhenAll(tasks);
foreach (var item in taskOne.Result)
Console.WriteLine(item);
Console.ReadKey();
}
并行(同步)处理任务
Task.WaitAll()：等待提供的所有 Task 对象完成执行过程。
我们来看看 Task.WaitAll() 其中一个重载方法的定义：
public static bool WaitAll (Task[] tasks, int millisecondsTimeout, CancellationToken cancellationToken);
- tasks 类型：Task[]
要执行的所有任务。
- millisecondsTimeout 任务：Int32
等待的毫秒数，-1 表示无限期等待。
- cancellationToken 类型：CancellationToken
等待任务完成期间要观察的 CancellationToken。
Task.WaitAll() 的示例如下：
static void Main()
{
List<Task> tasks = new List<Task>();
for (int i = 0; i < 5; i++)
tasks.Add(Task.Run(() =>
{
Console.WriteLine($"任务开始执行");
}));
Task.WaitAll(tasks.ToArray());
Console.ReadKey();
}
Task.WaitAll() 会让当前线程等待所有任务执行完毕。并且 Task.WaitAll() 是没有泛型的，也么没有返回结果。
并行任务的 Task.WhenAny
Task.WhenAny() 和 Task.WhenAll() 使用上差不多，Task.WhenAll() 当所有任务都完成时，才算完成，而 Task.WhenAny() 只要其中一个任务完成，都算完成。
这一点可以参考上面的 父子任务。
参考使用示例如下：
static void Main()
{
List<Task> tasks = new List<Task>();
for (int i = 0; i < 5; i++)
tasks.Add(Task.Run(() =>
{
Thread.Sleep(TimeSpan.FromSeconds(new Random().Next(0, 5)));
Console.WriteLine(" 正在执行任务");
}));
Task taskOne = Task.WhenAny(tasks);
taskOne.Wait(); // 任意一个任务完成，就可以解除等待
Console.WriteLine("有任务已经完成了");
Console.ReadKey();
}
当然，Task.WhenAny() 也有泛型方法，可以返回结果。
并行任务状态
Task.Status 属性可以获取任务的状态。其属性类型是一个 TaskStatus 枚举，其定义如下：
| 枚举 | 值 | 说明 |
|---|---|---|
| Canceled | 6 | 已经通过 CancellationToken 取消任务。 |
| Created | 0 | 该任务已初始化，但尚未被计划。 |
| Faulted | 7 | 由于未处理异常的原因而完成的任务。 |
| RanToCompletion | 5 | 已成功完成执行的任务。 |
| Running | 3 | 该任务正在运行，但尚未完成。 |
| WaitingForActivation | 1 | 该任务正在等待 .NET Framework 基础结构在内部将其激活并进行计划。 |
| WaitingForChildrenToComplete | 4 | 该任务已完成执行，正在隐式等待附加的子任务完成。 |
| WaitingToRun | 2 | 该任务已被计划执行，但尚未开始执行。 |
在使用并行任务时，Task.Status 的值，有一定规律：
-
如果有其中一个任务出现未经处理的异常，那么返回
TaskStatus.Faulted； -
如果所有任务都出现未经处理的异常，会返回
TaskStatus. RanToCompletion； -
如果其中一个任务被取消(即使出现未经处理的异常)，会返回
TaskStaus.Canceled；
循环中值变化问题
请运行测试下面两个示例：
static void Main()
{
for (int i = 0; i < 5; i++)
new Thread(() =>
{
Console.WriteLine($"i = {i}");
}).Start();
Console.ReadKey();
}
static void Main()
{
List<Task> tasks = new List<Task>();
for (int i = 0; i < 5; i++)
tasks.Add(Task.Run(() =>
{
Console.WriteLine($"i = {i}");
}));
Task taskOne = Task.WhenAll(tasks);
taskOne.Wait();
Console.ReadKey();
}
你会发现，两个示例的结果并不是 1,2,3,4,5，而是 5,5,5,5,5。
这个问题称为 Race condition(竞争条件)，可以参考维基百科：
https://en.wikipedia.org/wiki/Race_condition
微软文档里面也有关于此问题的说明，请参考：
https://docs.microsoft.com/zh-cn/archive/blogs/ericlippert/closing-over-the-loop-variable-considered-harmful
由于 i 在整个生命周期，内存都是在同一个位置，每个线程或任务对其值得使用，都是指向相同位置的。
这样就行了：
static void Main()
{
for (int i = 0; i < 5; i++)
{
int tmp = i;
new Thread(() =>
{
Console.WriteLine($"i = {tmp}");
}).Start();
}
Console.ReadKey();
}
这样是无效的：
for (int i = 0; i < 5; i++)
new Thread(() =>
{
int tmp = i;
Console.WriteLine($"i = {tmp}");
}).Start();
定时任务 TaskScheduler 类
TaskScheduler 类：表示一个处理将任务排队到线程中的低级工作的对象。
网上大多数示例是 Wpf 、WinForm的，微软文档也是很复杂的样子： https://docs.microsoft.com/zh-cn/dotnet/api/system.threading.tasks.taskscheduler?view=netcore-3.1#properties
貌似 TaskScheduler 主要对 SynchronizationContext 进行控制，也就是说是对 UI 起作用。
笔者不写 WPF 和 WinForm ，所以，这个东西，跳过。哈哈哈哈。
