TaskStatus Enum
Definitie
Belangrijk
Bepaalde informatie heeft betrekking op een voorlopige productversie die aanzienlijk kan worden gewijzigd voordat deze wordt uitgebracht. Microsoft biedt geen enkele expliciete of impliciete garanties met betrekking tot de informatie die hier wordt verstrekt.
Vertegenwoordigt de huidige fase in de levenscyclus van een Task.
public enum class TaskStatuspublic enum TaskStatustype TaskStatus = Public Enum TaskStatus- Overname
Velden
| Name | Waarde | Description |
|---|---|---|
| Created | 0 | De taak is geïnitialiseerd, maar is nog niet gepland. |
| WaitingForActivation | 1 | De taak wacht op geactiveerd en intern gepland door de .NET-infrastructuur. |
| WaitingToRun | 2 | De taak is gepland voor uitvoering, maar is nog niet gestart met uitvoeren. |
| Running | 3 | De taak wordt uitgevoerd, maar is nog niet voltooid. |
| WaitingForChildrenToComplete | 4 | De taak is voltooid en wacht impliciet tot de gekoppelde onderliggende taken zijn voltooid. |
| RanToCompletion | 5 | De uitvoering van de taak is voltooid. |
| Canceled | 6 | De taak heeft annulering bevestigd door een OperationCanceledException met een eigen CancellationToken te genereren terwijl het token in de gesignaleerde status stond of dat het CancellationToken van de taak al werd gesignaleerd voordat de taak werd uitgevoerd. Zie Taakannuleringvoor meer informatie. |
| Faulted | 7 | De taak is voltooid vanwege een onverwerkte uitzondering. |
Voorbeelden
In het volgende voorbeeld worden 20 taken gemaakt die worden herhaald totdat een teller wordt verhoogd tot een waarde van 2 miljoen. Wanneer de eerste 10 taken 2 miljoen bereiken, wordt het annuleringstoken geannuleerd en alle taken waarvan de tellers niet 2 miljoen hebben bereikt, worden geannuleerd. In het voorbeeld wordt vervolgens de Task.Status eigenschap van elke taak onderzocht om aan te geven of de taak is voltooid of geannuleerd. Voor degenen die zijn voltooid, wordt de waarde weergegeven die door de taak wordt geretourneerd.
using System;
using System.Collections.Generic;
using System.Threading;
using System.Threading.Tasks;
public class Example
{
public static void Main()
{
var tasks = new List<Task<int>>();
var source = new CancellationTokenSource();
var token = source.Token;
int completedIterations = 0;
for (int n = 0; n <= 19; n++)
tasks.Add(Task.Run( () => { int iterations = 0;
for (int ctr = 1; ctr <= 2000000; ctr++) {
token.ThrowIfCancellationRequested();
iterations++;
}
Interlocked.Increment(ref completedIterations);
if (completedIterations >= 10)
source.Cancel();
return iterations; }, token));
Console.WriteLine("Waiting for the first 10 tasks to complete...\n");
try {
Task.WaitAll(tasks.ToArray());
}
catch (AggregateException) {
Console.WriteLine("Status of tasks:\n");
Console.WriteLine("{0,10} {1,20} {2,14:N0}", "Task Id",
"Status", "Iterations");
foreach (var t in tasks)
Console.WriteLine("{0,10} {1,20} {2,14}",
t.Id, t.Status,
t.Status != TaskStatus.Canceled ? t.Result.ToString("N0") : "n/a");
}
}
}
// The example displays output like the following:
// Waiting for the first 10 tasks to complete...
// Status of tasks:
//
// Task Id Status Iterations
// 1 RanToCompletion 2,000,000
// 2 RanToCompletion 2,000,000
// 3 RanToCompletion 2,000,000
// 4 RanToCompletion 2,000,000
// 5 RanToCompletion 2,000,000
// 6 RanToCompletion 2,000,000
// 7 RanToCompletion 2,000,000
// 8 RanToCompletion 2,000,000
// 9 RanToCompletion 2,000,000
// 10 Canceled n/a
// 11 Canceled n/a
// 12 Canceled n/a
// 13 Canceled n/a
// 14 Canceled n/a
// 15 Canceled n/a
// 16 RanToCompletion 2,000,000
// 17 Canceled n/a
// 18 Canceled n/a
// 19 Canceled n/a
// 20 Canceled n/a
Imports System.Collections.Generic
Imports System.Threading
Imports System.Threading.Tasks
Module Example
Public Sub Main()
Dim tasks As New List(Of Task(Of Integer))()
Dim source As New CancellationTokenSource
Dim token As CancellationToken = source.Token
Dim completedIterations As Integer = 0
For n As Integer = 0 To 19
tasks.Add(Task.Run( Function()
Dim iterations As Integer= 0
For ctr As Long = 1 To 2000000
token.ThrowIfCancellationRequested()
iterations += 1
Next
Interlocked.Increment(completedIterations)
If completedIterations >= 10 Then source.Cancel()
Return iterations
End Function, token))
Next
Console.WriteLine("Waiting for the first 10 tasks to complete... ")
Try
Task.WaitAll(tasks.ToArray())
Catch e As AggregateException
Console.WriteLine("Status of tasks:")
Console.WriteLine()
Console.WriteLine("{0,10} {1,20} {2,14}", "Task Id",
"Status", "Iterations")
For Each t In tasks
Console.WriteLine("{0,10} {1,20} {2,14}",
t.Id, t.Status,
If(t.Status <> TaskStatus.Canceled,
t.Result.ToString("N0"), "n/a"))
Next
End Try
End Sub
End Module
' The example displays output like the following:
' Waiting for the first 10 tasks to complete...
' Status of tasks:
'
' Task Id Status Iterations
' 1 RanToCompletion 2,000,000
' 2 RanToCompletion 2,000,000
' 3 RanToCompletion 2,000,000
' 4 RanToCompletion 2,000,000
' 5 RanToCompletion 2,000,000
' 6 RanToCompletion 2,000,000
' 7 RanToCompletion 2,000,000
' 8 RanToCompletion 2,000,000
' 9 RanToCompletion 2,000,000
' 10 Canceled n/a
' 11 Canceled n/a
' 12 Canceled n/a
' 13 Canceled n/a
' 14 Canceled n/a
' 15 Canceled n/a
' 16 RanToCompletion 2,000,000
' 17 Canceled n/a
' 18 Canceled n/a
' 19 Canceled n/a
' 20 Canceled n/a
Opmerkingen
De Task.Status eigenschap retourneert een lid van de TaskStatus opsomming om de huidige status van de taak aan te geven.