TaskStatus Enumeration
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Stellt die aktuelle Phase im Lebenszyklus eines Taskdar.
public enum class TaskStatuspublic enum TaskStatustype TaskStatus = Public Enum TaskStatus- Vererbung
Felder
| Name | Wert | Beschreibung |
|---|---|---|
| Created | 0 | Der Vorgang wurde initialisiert, aber noch nicht geplant. |
| WaitingForActivation | 1 | Die Aufgabe wartet darauf, intern von der .NET-Infrastruktur aktiviert und geplant zu werden. |
| WaitingToRun | 2 | Der Vorgang wurde für die Ausführung geplant, aber noch nicht mit der Ausführung begonnen. |
| Running | 3 | Die Aufgabe wird ausgeführt, ist aber noch nicht abgeschlossen. |
| WaitingForChildrenToComplete | 4 | Die Ausführung der Aufgabe wurde abgeschlossen und wartet implizit darauf, dass angefügte untergeordnete Aufgaben abgeschlossen sind. |
| RanToCompletion | 5 | Die Ausführung der Aufgabe wurde erfolgreich abgeschlossen. |
| Canceled | 6 | Die Aufgabe hat den Abbruch bestätigt, indem eine OperationCanceledException mit seinem eigenen CancellationToken ausgelöst wurde, während das Token signalisiert war, oder das CancellationToken der Aufgabe bereits signalisiert wurde, bevor die Aufgabe ausgeführt wurde. Weitere Informationen finden Sie unter "Abbruch der Aufgabe". |
| Faulted | 7 | Die Aufgabe wurde aufgrund einer unbehandelten Ausnahme abgeschlossen. |
Beispiele
Im folgenden Beispiel werden 20 Vorgänge erstellt, die durchlaufen werden, bis ein Zähler auf einen Wert von 2 Millionen erhöht wird. Wenn die ersten 10 Vorgänge 2 Millionen erreichen, wird das Abbruchtoken abgebrochen, und alle Vorgänge, deren Leistungsindikatoren 2 Millionen nicht erreicht haben, werden abgebrochen. Im Beispiel wird dann die Task.Status Eigenschaft der einzelnen Vorgänge untersucht, um anzugeben, ob die Aufgabe erfolgreich abgeschlossen oder abgebrochen wurde. Für abgeschlossene Personen wird der von der Aufgabe zurückgegebene Wert angezeigt.
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
Hinweise
Die Task.Status Eigenschaft gibt ein Element der TaskStatus Enumeration zurück, um den aktuellen Status der Aufgabe anzugeben.
