Task.Status Eigenschaft

Definition

Namespace:

System.Threading.Tasks

Assembly:

System.Threading.Tasks.dll

Assembly:

System.Runtime.dll

Assembly:

mscorlib.dll

Assembly:

netstandard.dll

Ruft den TaskStatus dieser Aufgabe ab.

C#

public System.Threading.Tasks.TaskStatus Status { get; }

Eigenschaftswert

TaskStatus

Der aktuelle TaskStatus dieser Aufgabeninstanz.

Beispiele

Im folgenden Beispiel werden 20 Vorgänge erstellt, die schleifen, 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 nicht 2 Millionen erreicht haben, werden abgebrochen. Im Beispiel wird dann die Status Eigenschaft jeder Aufgabe untersucht, um anzugeben, ob sie erfolgreich abgeschlossen wurde oder abgebrochen wurde. Für diejenigen, die abgeschlossen wurden, wird der vom Vorgang zurückgegebene Wert angezeigt.

C#

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

Hinweise

Durch abrufen des Werts der Task.Status Eigenschaft wird der aufrufende Thread erst blockiert, wenn die Aufgabe abgeschlossen wurde.

Weitere Informationen und ein Beispiel finden Sie unter Verketten von Vorgängen mithilfe von Fortsetzungsaufgaben und Vorgehensweise: Abbrechen einer Aufgabe und untergeordneter Elemente.

Gilt für