Task<TResult>.ContinueWith Metoda

Definicja

Przestrzeń nazw:

System.Threading.Tasks

Zestaw:

System.Runtime.dll

Tworzy zadanie kontynuacji, które jest wykonywane po zakończeniu innego zadania.

Przeciążenia

ContinueWith(Action<Task<TResult>,Object>, Object, CancellationToken, TaskContinuationOptions, TaskScheduler)	Tworzy kontynuację wykonywaną po zakończeniu działania obiektu docelowego Task<TResult> .
ContinueWith(Action<Task<TResult>,Object>, Object, TaskScheduler)	Tworzy kontynuację wykonywaną po zakończeniu działania obiektu docelowego Task<TResult> .
ContinueWith(Action<Task<TResult>,Object>, Object, TaskContinuationOptions)	Tworzy kontynuację wykonywaną po zakończeniu działania obiektu docelowego Task<TResult> .
ContinueWith(Action<Task<TResult>,Object>, Object, CancellationToken)	Tworzy kontynuację wykonywaną po zakończeniu działania obiektu docelowego Task<TResult> .
ContinueWith(Action<Task<TResult>>, CancellationToken, TaskContinuationOptions, TaskScheduler)	Tworzy kontynuację wykonywaną zgodnie z warunkiem określonym w continuationOptionspliku .
ContinueWith(Action<Task<TResult>>, TaskContinuationOptions)	Tworzy kontynuację wykonywaną zgodnie z warunkiem określonym w continuationOptionspliku .
ContinueWith(Action<Task<TResult>>, CancellationToken)	Tworzy kontynuację z możliwością anulowania, która jest wykonywana asynchronicznie po zakończeniu działania obiektu docelowego Task<TResult> .
ContinueWith(Action<Task<TResult>,Object>, Object)	Tworzy kontynuację przekazywaną informację o stanie i wykonywaną po zakończeniu elementu docelowego Task<TResult> .
ContinueWith(Action<Task<TResult>>)	Tworzy kontynuację wykonywaną asynchronicznie po zakończeniu zadania docelowego.
ContinueWith(Action<Task<TResult>>, TaskScheduler)	Tworzy kontynuację wykonywaną asynchronicznie po zakończeniu celu Task<TResult> .
ContinueWith<TNewResult>(Func<Task<TResult>,Object,TNewResult>, Object, CancellationToken, TaskContinuationOptions, TaskScheduler)	Tworzy kontynuację wykonywaną po zakończeniu działania obiektu docelowego Task<TResult> .
ContinueWith<TNewResult>(Func<Task<TResult>,TNewResult>, CancellationToken, TaskContinuationOptions, TaskScheduler)	Tworzy kontynuację wykonywaną zgodnie z warunkiem określonym w continuationOptionspliku .
ContinueWith<TNewResult>(Func<Task<TResult>,Object,TNewResult>, Object, TaskScheduler)	Tworzy kontynuację wykonywaną po zakończeniu działania obiektu docelowego Task<TResult> .
ContinueWith<TNewResult>(Func<Task<TResult>,Object,TNewResult>, Object, CancellationToken)	Tworzy kontynuację wykonywaną po zakończeniu działania obiektu docelowego Task<TResult> .
ContinueWith<TNewResult>(Func<Task<TResult>,Object,TNewResult>, Object, TaskContinuationOptions)	Tworzy kontynuację wykonywaną po zakończeniu działania obiektu docelowego Task<TResult> .
ContinueWith<TNewResult>(Func<Task<TResult>,TNewResult>, TaskContinuationOptions)	Tworzy kontynuację wykonywaną zgodnie z warunkiem określonym w continuationOptionspliku .
ContinueWith<TNewResult>(Func<Task<TResult>,TNewResult>, CancellationToken)	Tworzy kontynuację wykonywaną asynchronicznie po zakończeniu celu Task<TResult> .
ContinueWith<TNewResult>(Func<Task<TResult>,Object,TNewResult>, Object)	Tworzy kontynuację wykonywaną po zakończeniu działania obiektu docelowego Task<TResult> .
ContinueWith<TNewResult>(Func<Task<TResult>,TNewResult>)	Tworzy kontynuację wykonywaną asynchronicznie po zakończeniu celu Task<TResult> .
ContinueWith<TNewResult>(Func<Task<TResult>,TNewResult>, TaskScheduler)	Tworzy kontynuację wykonywaną asynchronicznie po zakończeniu celu Task<TResult> .

ContinueWith(Action<Task<TResult>,Object>, Object, CancellationToken, TaskContinuationOptions, TaskScheduler)

Źródło:

Future.cs

Tworzy kontynuację wykonywaną po zakończeniu działania obiektu docelowego Task<TResult> .

public:
 System::Threading::Tasks::Task ^ ContinueWith(Action<System::Threading::Tasks::Task<TResult> ^, System::Object ^> ^ continuationAction, System::Object ^ state, System::Threading::CancellationToken cancellationToken, System::Threading::Tasks::TaskContinuationOptions continuationOptions, System::Threading::Tasks::TaskScheduler ^ scheduler);

public System.Threading.Tasks.Task ContinueWith (Action<System.Threading.Tasks.Task<TResult>,object?> continuationAction, object? state, System.Threading.CancellationToken cancellationToken, System.Threading.Tasks.TaskContinuationOptions continuationOptions, System.Threading.Tasks.TaskScheduler scheduler);

override this.ContinueWith : Action<System.Threading.Tasks.Task<'Result>, obj> * obj * System.Threading.CancellationToken * System.Threading.Tasks.TaskContinuationOptions * System.Threading.Tasks.TaskScheduler -> System.Threading.Tasks.Task

Public Function ContinueWith (continuationAction As Action(Of Task(Of TResult), Object), state As Object, cancellationToken As CancellationToken, continuationOptions As TaskContinuationOptions, scheduler As TaskScheduler) As Task

Parametry

continuationAction

Action<Task<TResult>,Object>

Akcja do uruchomienia po zakończeniu Task<TResult> . Po uruchomieniu delegat zostanie przekazany ukończone zadanie i obiekt stanu dostarczonego przez obiekt wywołujący jako argumenty.

state

Object

Obiekt reprezentujący dane, które mają być używane przez akcję kontynuacji.

cancellationToken

CancellationToken

Element CancellationToken , który zostanie przypisany do nowego zadania kontynuacji.

continuationOptions

TaskContinuationOptions

Opcje, kiedy kontynuacja jest zaplanowana i jak się zachowuje. Obejmuje to kryteria, takie jak OnlyOnCanceled, a także opcje wykonywania, takie jak ExecuteSynchronously.

scheduler

TaskScheduler

Element TaskScheduler do skojarzenia z zadaniem kontynuacji i do użycia do jego wykonania.

Zwraca

Task

Nowa kontynuacja Task.

Wyjątki

ArgumentNullException

Argumentem scheduler jest null.

ArgumentOutOfRangeException

Argument continuationOptions określa nieprawidłową wartość dla TaskContinuationOptionselementu .

ObjectDisposedException

Dostarczone CancellationToken zostało już usunięte.

Uwagi

Zwrócony Task element nie zostanie zaplanowany do wykonania do momentu ukończenia bieżącego zadania. Jeśli kryteria określone za pośrednictwem parametru continuationOptions nie zostaną spełnione, zadanie kontynuacji zostanie anulowane zamiast zaplanowane.

Zobacz też

• Tworzenie łańcuchów zadań przy użyciu zadań kontynuacji

ContinueWith(Action<Task<TResult>,Object>, Object, TaskScheduler)

Źródło:

Future.cs

Tworzy kontynuację wykonywaną po zakończeniu działania obiektu docelowego Task<TResult> .

public:
 System::Threading::Tasks::Task ^ ContinueWith(Action<System::Threading::Tasks::Task<TResult> ^, System::Object ^> ^ continuationAction, System::Object ^ state, System::Threading::Tasks::TaskScheduler ^ scheduler);

public System.Threading.Tasks.Task ContinueWith (Action<System.Threading.Tasks.Task<TResult>,object?> continuationAction, object? state, System.Threading.Tasks.TaskScheduler scheduler);

override this.ContinueWith : Action<System.Threading.Tasks.Task<'Result>, obj> * obj * System.Threading.Tasks.TaskScheduler -> System.Threading.Tasks.Task

Public Function ContinueWith (continuationAction As Action(Of Task(Of TResult), Object), state As Object, scheduler As TaskScheduler) As Task

Parametry

continuationAction

Action<Task<TResult>,Object>

Akcja do uruchomienia po zakończeniu Task<TResult> . Po uruchomieniu delegat zostanie przekazany ukończone zadanie i obiekt stanu dostarczonego przez obiekt wywołujący jako argumenty.

state

Object

Obiekt reprezentujący dane, które mają być używane przez akcję kontynuacji.

scheduler

TaskScheduler

Element TaskScheduler do skojarzenia z zadaniem kontynuacji i do użycia do jego wykonania.

Zwraca

Task

Nowa kontynuacja Task.

Wyjątki

ArgumentNullException

Argumentem scheduler jest null.

Uwagi

Zwrócony Task element nie zostanie zaplanowany do wykonania do momentu ukończenia bieżącego zadania, niezależnie od tego, czy zostanie ukończone z powodu pomyślnego ukończenia, po awarii z powodu nieobsługiwanego wyjątku lub wcześniejszego zakończenia z powodu anulowania.

Zobacz też

• Tworzenie łańcuchów zadań przy użyciu zadań kontynuacji

ContinueWith(Action<Task<TResult>,Object>, Object, TaskContinuationOptions)

Źródło:

Future.cs

Tworzy kontynuację wykonywaną po zakończeniu działania obiektu docelowego Task<TResult> .

public:
 System::Threading::Tasks::Task ^ ContinueWith(Action<System::Threading::Tasks::Task<TResult> ^, System::Object ^> ^ continuationAction, System::Object ^ state, System::Threading::Tasks::TaskContinuationOptions continuationOptions);

public System.Threading.Tasks.Task ContinueWith (Action<System.Threading.Tasks.Task<TResult>,object?> continuationAction, object? state, System.Threading.Tasks.TaskContinuationOptions continuationOptions);

override this.ContinueWith : Action<System.Threading.Tasks.Task<'Result>, obj> * obj * System.Threading.Tasks.TaskContinuationOptions -> System.Threading.Tasks.Task

Public Function ContinueWith (continuationAction As Action(Of Task(Of TResult), Object), state As Object, continuationOptions As TaskContinuationOptions) As Task

Parametry

continuationAction

Action<Task<TResult>,Object>

Akcja do uruchomienia po zakończeniu Task<TResult> . Po uruchomieniu delegat zostanie przekazany ukończone zadanie i obiekt stanu dostarczonego przez obiekt wywołujący jako argumenty.

state

Object

Obiekt reprezentujący dane, które mają być używane przez akcję kontynuacji.

continuationOptions

TaskContinuationOptions

Opcje, kiedy kontynuacja jest zaplanowana i jak się zachowuje. Obejmuje to kryteria, takie jak OnlyOnCanceled, a także opcje wykonywania, takie jak ExecuteSynchronously.

Zwraca

Task

Nowa kontynuacja Task.

Wyjątki

ArgumentNullException

Argumentem continuationAction jest null.

ArgumentOutOfRangeException

Argument continuationOptions określa nieprawidłową wartość dla TaskContinuationOptionselementu .

Uwagi

Zwrócony Task element nie zostanie zaplanowany do wykonania do momentu ukończenia bieżącego zadania. Jeśli kryteria kontynuacji określone za pośrednictwem parametru continuationOptions nie zostaną spełnione, zadanie kontynuacji zostanie anulowane zamiast zaplanowane.

Zobacz też

• Tworzenie łańcuchów zadań przy użyciu zadań kontynuacji

ContinueWith(Action<Task<TResult>,Object>, Object, CancellationToken)

Źródło:

Future.cs

Tworzy kontynuację wykonywaną po zakończeniu działania obiektu docelowego Task<TResult> .

public:
 System::Threading::Tasks::Task ^ ContinueWith(Action<System::Threading::Tasks::Task<TResult> ^, System::Object ^> ^ continuationAction, System::Object ^ state, System::Threading::CancellationToken cancellationToken);

public System.Threading.Tasks.Task ContinueWith (Action<System.Threading.Tasks.Task<TResult>,object?> continuationAction, object? state, System.Threading.CancellationToken cancellationToken);

override this.ContinueWith : Action<System.Threading.Tasks.Task<'Result>, obj> * obj * System.Threading.CancellationToken -> System.Threading.Tasks.Task

Public Function ContinueWith (continuationAction As Action(Of Task(Of TResult), Object), state As Object, cancellationToken As CancellationToken) As Task

Parametry

continuationAction

Action<Task<TResult>,Object>

Akcja do uruchomienia po zakończeniu Task<TResult> . Po uruchomieniu delegat zostanie przekazany ukończone zadanie i obiekt stanu dostarczonego przez obiekt wywołujący jako argumenty.

state

Object

Obiekt reprezentujący dane, które mają być używane przez akcję kontynuacji.

cancellationToken

CancellationToken

Element CancellationToken , który zostanie przypisany do nowego zadania kontynuacji.

Zwraca

Task

Nowa kontynuacja Task.

Wyjątki

ArgumentNullException

Argumentem continuationAction jest null.

ObjectDisposedException

Dostarczone CancellationToken zostało już usunięte.

Uwagi

Zwrócony Task element nie zostanie zaplanowany do wykonania do momentu ukończenia bieżącego zadania, niezależnie od tego, czy zostanie ukończone z powodu pomyślnego ukończenia, po awarii z powodu nieobsługiwanego wyjątku lub wcześniejszego zakończenia z powodu anulowania.

Zobacz też

• Tworzenie łańcuchów zadań przy użyciu zadań kontynuacji

ContinueWith(Action<Task<TResult>>, CancellationToken, TaskContinuationOptions, TaskScheduler)

Źródło:

Future.cs

Tworzy kontynuację, która jest wykonywana zgodnie z warunkiem określonym w continuationOptions.

public:
 System::Threading::Tasks::Task ^ ContinueWith(Action<System::Threading::Tasks::Task<TResult> ^> ^ continuationAction, System::Threading::CancellationToken cancellationToken, System::Threading::Tasks::TaskContinuationOptions continuationOptions, System::Threading::Tasks::TaskScheduler ^ scheduler);

public System.Threading.Tasks.Task ContinueWith (Action<System.Threading.Tasks.Task<TResult>> continuationAction, System.Threading.CancellationToken cancellationToken, System.Threading.Tasks.TaskContinuationOptions continuationOptions, System.Threading.Tasks.TaskScheduler scheduler);

override this.ContinueWith : Action<System.Threading.Tasks.Task<'Result>> * System.Threading.CancellationToken * System.Threading.Tasks.TaskContinuationOptions * System.Threading.Tasks.TaskScheduler -> System.Threading.Tasks.Task

Public Function ContinueWith (continuationAction As Action(Of Task(Of TResult)), cancellationToken As CancellationToken, continuationOptions As TaskContinuationOptions, scheduler As TaskScheduler) As Task

Parametry

continuationAction

Action<Task<TResult>>

Akcja do uruchomienia zgodnie z warunkiem określonym w continuationOptionselemecie . Po uruchomieniu delegat zostanie przekazany ukończone zadanie jako argument.

cancellationToken

CancellationToken

Element CancellationToken , który zostanie przypisany do nowego zadania kontynuacji.

continuationOptions

TaskContinuationOptions

Opcje dotyczące zaplanowanych kontynuacji i sposobu jej działania. Obejmuje to kryteria, takie jak OnlyOnCanceled, a także opcje wykonywania, takie jak ExecuteSynchronously.

scheduler

TaskScheduler

Element do skojarzenia TaskScheduler z zadaniem kontynuacji i do użycia do jego wykonania.

Zwraca

Task

Nowa kontynuacja Task.

Wyjątki

ObjectDisposedException

Został Task<TResult> usunięty.

-lub-

CancellationTokenSource Utworzony element cancellationToken został już usunięty.

ArgumentNullException

Argumentem continuationAction jest null.

-lub-

Argumentem scheduler jest null.

ArgumentOutOfRangeException

Argument continuationOptions określa nieprawidłową wartość dla TaskContinuationOptionselementu .

Uwagi

Zwrócony Task element nie zostanie zaplanowany do wykonania do momentu ukończenia bieżącego zadania. Jeśli kryteria określone za pomocą parametru continuationOptions nie zostaną spełnione, zadanie kontynuacji zostanie anulowane zamiast zaplanowane. Aby uzyskać więcej informacji, zobacz Łączenie zadań za pomocą zadań kontynuacji.

Zobacz też

• Biblioteka zadań równoległych (TPL)
• Programowanie asynchroniczne oparte na zadaniach
• Tworzenie łańcuchów zadań przy użyciu zadań kontynuacji

ContinueWith(Action<Task<TResult>>, TaskContinuationOptions)

Źródło:

Future.cs

Tworzy kontynuację, która jest wykonywana zgodnie z warunkiem określonym w continuationOptions.

public:
 System::Threading::Tasks::Task ^ ContinueWith(Action<System::Threading::Tasks::Task<TResult> ^> ^ continuationAction, System::Threading::Tasks::TaskContinuationOptions continuationOptions);

public System.Threading.Tasks.Task ContinueWith (Action<System.Threading.Tasks.Task<TResult>> continuationAction, System.Threading.Tasks.TaskContinuationOptions continuationOptions);

override this.ContinueWith : Action<System.Threading.Tasks.Task<'Result>> * System.Threading.Tasks.TaskContinuationOptions -> System.Threading.Tasks.Task

Public Function ContinueWith (continuationAction As Action(Of Task(Of TResult)), continuationOptions As TaskContinuationOptions) As Task

Parametry

continuationAction

Action<Task<TResult>>

Akcja zgodnie z warunkiem określonym w continuationOptionselem. Po uruchomieniu delegat zostanie przekazany ukończone zadanie jako argument.

continuationOptions

TaskContinuationOptions

Opcje dotyczące zaplanowanych kontynuacji i sposobu jej działania. Obejmuje to kryteria, takie jak OnlyOnCanceled, a także opcje wykonywania, takie jak ExecuteSynchronously.

Zwraca

Task

Nowa kontynuacja Task.

Wyjątki

ObjectDisposedException

Element Task<TResult> został usunięty.

ArgumentNullException

Argumentem continuationAction jest null.

ArgumentOutOfRangeException

Argument continuationOptions określa nieprawidłową wartość dla elementu TaskContinuationOptions.

Uwagi

Zwrócony Task element nie zostanie zaplanowany do wykonania do momentu ukończenia bieżącego zadania. Jeśli kryteria kontynuacji określone za pomocą parametru continuationOptions nie zostaną spełnione, zadanie kontynuacji zostanie anulowane zamiast zaplanowane.

Aby uzyskać więcej informacji, zobacz Łączenie zadań za pomocą zadań kontynuacji.

Zobacz też

• Biblioteka zadań równoległych (TPL)
• Programowanie asynchroniczne oparte na zadaniach
• Tworzenie łańcuchów zadań przy użyciu zadań kontynuacji

ContinueWith(Action<Task<TResult>>, CancellationToken)

Źródło:

Future.cs

Tworzy kontynuację z możliwością anulowania, która jest wykonywana asynchronicznie po zakończeniu elementu docelowego Task<TResult> .

public:
 System::Threading::Tasks::Task ^ ContinueWith(Action<System::Threading::Tasks::Task<TResult> ^> ^ continuationAction, System::Threading::CancellationToken cancellationToken);

public System.Threading.Tasks.Task ContinueWith (Action<System.Threading.Tasks.Task<TResult>> continuationAction, System.Threading.CancellationToken cancellationToken);

override this.ContinueWith : Action<System.Threading.Tasks.Task<'Result>> * System.Threading.CancellationToken -> System.Threading.Tasks.Task

Public Function ContinueWith (continuationAction As Action(Of Task(Of TResult)), cancellationToken As CancellationToken) As Task

Parametry

continuationAction

Action<Task<TResult>>

Akcja do uruchomienia po zakończeniu Task<TResult> . Po uruchomieniu delegat jest przekazywany do ukończonego zadania jako argument.

cancellationToken

CancellationToken

Token anulowania przekazany do nowego zadania kontynuacji.

Zwraca

Task

Nowe zadanie kontynuacji.

Wyjątki

ObjectDisposedException

Element Task<TResult> został usunięty.

-lub-

Utworzony CancellationTokenSource element cancellationToken został usunięty.

ArgumentNullException

Argumentem continuationAction jest null.

Przykłady

W poniższym przykładzie jest tworzone przedzident zadania, które używa sieve of Eratosthenes do obliczania liczb głównych z zakresu od 1 do wartości wprowadzonej przez użytkownika. Tablica służy do przechowywania informacji o liczbach głównych. Indeks tablicy reprezentuje liczbę, a wartość elementu wskazuje, czy ta liczba jest złożona (jego wartość to true) czy prime (jego wartość to false). To zadanie jest następnie przekazywane do zadania kontynuacji, które jest odpowiedzialne za wyodrębnianie liczb głównych z tablicy całkowitej i wyświetlanie ich.

Token anulowania jest przekazywany zarówno do antecedent, jak i zadania kontynuacji. Obiekt System.Timers.Timer służy do definiowania wartości limitu czasu 100 milisekund. Jeśli zdarzenie jest uruchamiane, CancellationTokenSource.Cancel metoda jest wywoływana, a token anulowania jest używany do żądania anulowania zadań.

using System;
using System.Collections.Generic;
using System.Threading;
using System.Threading.Tasks;
using Timers = System.Timers;

public class Example
{
   static CancellationTokenSource ts;
   
   public static void Main(string[] args)
   {
      int upperBound = args.Length >= 1 ? Int32.Parse(args[0]) : 200;
      ts = new CancellationTokenSource();
      CancellationToken token = ts.Token;
      Timers.Timer timer = new Timers.Timer(3000);
      timer.Elapsed += TimedOutEvent;
      timer.AutoReset = false;
      timer.Enabled = true;

      var t1 = Task.Run(() => { // True = composite.
                                // False = prime.
                                bool[] values = new bool[upperBound + 1];
                                for (int ctr = 2; ctr <= (int) Math.Sqrt(upperBound); ctr++) {
                                   if (values[ctr] == false) {
                                      for (int product = ctr * ctr; product <= upperBound;
                                                                    product = product + ctr)
                                         values[product] = true;
                                   }
                                   token.ThrowIfCancellationRequested();
                                }
                                return values; }, token);

      var t2 = t1.ContinueWith( (antecedent) => { // Create a list of prime numbers.
                                                  var  primes = new List<int>();
                                                  token.ThrowIfCancellationRequested();
                                                  bool[] numbers = antecedent.Result;
                                                  string output = String.Empty;

                                                  for (int ctr = 1; ctr <= numbers.GetUpperBound(0); ctr++)
                                                     if (numbers[ctr] == false)
                                                        primes.Add(ctr);

                                                  // Create the output string.
                                                  for (int ctr = 0; ctr < primes.Count; ctr++) {
                                                     token.ThrowIfCancellationRequested();
                                                     output += primes[ctr].ToString("N0");
                                                     if (ctr < primes.Count - 1)
                                                        output += ",  ";
                                                     if ((ctr + 1) % 8 == 0)
                                                        output += Environment.NewLine;
                                                  }
                                                  //Display the result.
                                                  Console.WriteLine("Prime numbers from 1 to {0}:\n",
                                                                    upperBound);
                                                  Console.WriteLine(output);
                                                }, token);
      try {
         t2.Wait();
      }
      catch (AggregateException ae) {
         foreach (var e in ae.InnerExceptions) {
            if (e.GetType() == typeof(TaskCanceledException))
               Console.WriteLine("The operation was cancelled.");
            else
               Console.WriteLine("ELSE: {0}: {1}", e.GetType().Name, e.Message);
         }
      }
      finally {
         ts.Dispose();
      }
   }

   private static void TimedOutEvent(Object source, Timers.ElapsedEventArgs e)
   {
      ts.Cancel();
   }
}
// If cancellation is not requested, the example displays output like the following:
//       Prime numbers from 1 to 400:
//
//       1,  2,  3,  5,  7,  11,  13,  17,
//       19,  23,  29,  31,  37,  41,  43,  47,
//       53,  59,  61,  67,  71,  73,  79,  83,
//       89,  97,  101,  103,  107,  109,  113,  127,
//       131,  137,  139,  149,  151,  157,  163,  167,
//       173,  179,  181,  191,  193,  197,  199,  211,
//       223,  227,  229,  233,  239,  241,  251,  257,
//       263,  269,  271,  277,  281,  283,  293,  307,
//       311,  313,  317,  331,  337,  347,  349,  353,
//       359,  367,  373,  379,  383,  389,  397,  401
// If cancellation is requested, the example displays output like the following:
//       The operation was cancelled.

Imports System.Collections.Generic
Imports System.Threading
Imports System.Threading.Tasks
Imports Timers = System.Timers

Module Example
   Dim ts As CancellationTokenSource

   Public Sub Main(args() As String)
      Dim upperBound As Integer = If(args.Length >= 1, CInt(args(0)), 200)
      ts = New CancellationTokenSource()
      Dim token As CancellationToken = ts.Token
      Dim timer As New Timers.Timer(100)
      AddHandler timer.Elapsed, AddressOf TimedOutEvent
      timer.AutoReset = False
      timer.Enabled = True

      Dim t1 = Task.Run(Function()
                          ' True = composite.
                          ' False = prime.
                          Dim values(upperBound) As Boolean
                          For ctr = 2 To CInt(Math.Sqrt(upperBound))
                             If values(ctr) = False Then
                                For product = ctr * ctr To upperBound Step ctr
                                   values(product) = True
                                Next
                             End If
                             token.ThrowIfCancellationRequested()
                          Next
                          Return values
                       End Function, token)

      Dim t2 = t1.ContinueWith(Sub(antecedent)
                                  ' Create a list of prime numbers.
                                  Dim primes As New List(Of Integer)()
                                  token.ThrowIfCancellationRequested()
                                  Dim numbers As Boolean() = antecedent.Result
                                  Dim output As String = String.Empty
                                  
                                  For ctr As Integer = 1 To numbers.GetUpperBound(0)
                                     If numbers(ctr) = False Then primes.Add(ctr)
                                  Next

                                  ' Create the output string.
                                  For ctr As Integer = 0 To primes.Count - 1
                                     token.ThrowIfCancellationRequested()
                                     output += primes(ctr).ToString("N0")
                                     If ctr < primes.Count - 1 Then output += ",  "
                                     If (ctr + 1) Mod 8 = 0 Then output += vbCrLf
                                  Next
                                  'Display the result.
                                  Console.WriteLine("Prime numbers from 1 to {0}:{1}",
                                                    upperBound, vbCrLf)
                                  Console.WriteLine(output)
                               End Sub, token)
      Try
         t2.Wait()
      Catch ae As AggregateException
         For Each e In ae.InnerExceptions
            If e.GetType Is GetType(TaskCanceledException) Then
               Console.WriteLine("The operation was cancelled.")
            Else
               Console.WriteLine("{0}: {1}", e.GetType().Name, e.Message)
            End If
         Next
      Finally
         ts.Dispose()
      End Try
   End Sub
   
   Private Sub TimedOutEvent(source As Object, e As Timers.ElapsedEventArgs)
      ts.Cancel()
   End Sub
End Module
' If cancellation is not requested, the example displays output like the following:
'       Prime numbers from 1 to 400:
'
'       1,  2,  3,  5,  7,  11,  13,  17,
'       19,  23,  29,  31,  37,  41,  43,  47,
'       53,  59,  61,  67,  71,  73,  79,  83,
'       89,  97,  101,  103,  107,  109,  113,  127,
'       131,  137,  139,  149,  151,  157,  163,  167,
'       173,  179,  181,  191,  193,  197,  199,  211,
'       223,  227,  229,  233,  239,  241,  251,  257,
'       263,  269,  271,  277,  281,  283,  293,  307,
'       311,  313,  317,  331,  337,  347,  349,  353,
'       359,  367,  373,  379,  383,  389,  397,  401
' If cancellation is requested, the example displays output like the following:
'       The operation was cancelled.

Zazwyczaj podanie wartości około 100 000 powoduje wygaśnięcie interwału limitu czasu i Timer.Elapsed wyzwolenie zdarzenia oraz ustawienie żądania anulowania.

Uwagi

Zwrócony Task element nie zostanie zaplanowany do wykonania do momentu ukończenia bieżącego zadania, tego, czy zostanie ukończone z powodu pomyślnego ukończenia, błędu z powodu nieobsługiwanego wyjątku lub wcześniejszego zakończenia z powodu anulowania.

Zobacz też

• Biblioteka zadań równoległych (TPL)
• Programowanie asynchroniczne oparte na zadaniach
• Tworzenie łańcuchów zadań przy użyciu zadań kontynuacji

ContinueWith(Action<Task<TResult>,Object>, Object)

Źródło:

Future.cs

Tworzy kontynuację, która jest przekazywana informacji o stanie i jest wykonywana po zakończeniu elementu docelowego Task<TResult> .

public:
 System::Threading::Tasks::Task ^ ContinueWith(Action<System::Threading::Tasks::Task<TResult> ^, System::Object ^> ^ continuationAction, System::Object ^ state);

public System.Threading.Tasks.Task ContinueWith (Action<System.Threading.Tasks.Task<TResult>,object?> continuationAction, object? state);

override this.ContinueWith : Action<System.Threading.Tasks.Task<'Result>, obj> * obj -> System.Threading.Tasks.Task

Public Function ContinueWith (continuationAction As Action(Of Task(Of TResult), Object), state As Object) As Task

Parametry

continuationAction

Action<Task<TResult>,Object>

Akcja do uruchomienia po zakończeniu Task<TResult> . Po uruchomieniu delegat jest przekazywany do ukończonego zadania i obiekt stanu dostarczonego przez obiekt wywołujący jako argumenty.

state

Object

Obiekt reprezentujący dane, które mają być używane przez akcję kontynuacji.

Zwraca

Task

Nowa kontynuacja Task.

Wyjątki

ArgumentNullException

Argumentem continuationAction jest null.

Przykłady

Poniższy przykład tworzy zadanie, które jest przekazywane liczby całkowite z zakresu od 2 do 20 i zwraca tablicę zawierającą pierwsze dziesięć wykładników (odⁿ¹ doⁿ¹⁰) tej liczby. Zadanie kontynuacji jest następnie odpowiedzialne za wyświetlanie wykładników. Jest przekazywany zarówno przedzident, jak i pierwotna liczba, której wykładnik generuje przedzident.

using System;
using System.Threading;
using System.Threading.Tasks;

public class Example
{
   public static void Main()
   {
      var cts = new CancellationTokenSource();
      var token = cts.Token;

      // Get an integer to generate a list of its exponents.
      var rnd = new Random();
      var number = rnd.Next(2, 21);
      
      var t = Task.Factory.StartNew( (value) => { int n = (int) value;
                                                  long[] values = new long[10];
                                                  for (int ctr = 1; ctr <= 10; ctr++)
                                                     values[ctr - 1] = (long) Math.Pow(n, ctr);
                                                     
                                                  return values;
                                                }, number);
      var continuation = t.ContinueWith( (antecedent, value) => { Console.WriteLine("Exponents of {0}:", value);
                                                                  for (int ctr = 0; ctr <= 9; ctr++)
                                                                     Console.WriteLine("   {0} {1} {2} = {3:N0}",
                                                                                       value, "\u02C6", ctr + 1,
                                                                                       antecedent.Result[ctr]);
                                                                  Console.WriteLine();
                                                                }, number);
      continuation.Wait();
      cts.Dispose();
   }
}
// The example displays output like the following:
//       Exponents of 2:
//          2 ^ 1 = 2
//          2 ^ 2 = 4
//          2 ^ 3 = 8
//          2 ^ 4 = 16
//          2 ^ 5 = 32
//          2 ^ 6 = 64
//          2 ^ 7 = 128
//          2 ^ 8 = 256
//          2 ^ 9 = 512
//          2 ^ 10 = 1,024

Imports System.Threading
Imports System.Threading.Tasks

Module Example
   Public Sub Main()
      Dim cts As New CancellationTokenSource()
      Dim token As CancellationToken = cts.Token

      ' Get an integer to generate a list of its exponents.
      Dim rnd As New Random()
      Dim number As Integer = rnd.Next(2, 21)

      Dim t = Task.Factory.StartNew( Function(value)
                                        Dim n As Integer = CInt(value)
                                        Dim values(9) As Long
                                        For ctr As Integer = 1 To 10
                                           values(ctr - 1) = CLng(Math.Pow(n, ctr))
                                        Next
                                        return values
                                     End Function, number)
      Dim continuation = t.ContinueWith( Sub(antecedent, value)
                                            Console.WriteLine("Exponents of {0}:", value)
                                            For ctr As Integer = 0 To 9
                                               Console.WriteLine("   {0} {1} {2} = {3:N0}",
                                                                 value, ChrW(&h02C6), ctr + 1,
                                                                 antecedent.Result(ctr))
                                            Next
                                            Console.WriteLine()
                                         End Sub, number)
      continuation.Wait()

      cts.Dispose()
   End Sub
End Module
' The example displays output like the following:
'       Exponents of 2:
'          2 ^ 1 = 2
'          2 ^ 2 = 4
'          2 ^ 3 = 8
'          2 ^ 4 = 16
'          2 ^ 5 = 32
'          2 ^ 6 = 64
'          2 ^ 7 = 128
'          2 ^ 8 = 256
'          2 ^ 9 = 512
'          2 ^ 10 = 1,024

Uwagi

Zwrócony Task element nie zostanie zaplanowany do wykonania do momentu ukończenia bieżącego zadania, tego, czy zostanie ukończone z powodu pomyślnego ukończenia, błędu z powodu nieobsługiwanego wyjątku lub wcześniejszego zakończenia z powodu anulowania.

Zobacz też

• Tworzenie łańcuchów zadań przy użyciu zadań kontynuacji

ContinueWith(Action<Task<TResult>>)

Źródło:

Future.cs

Tworzy kontynuację, która jest wykonywana asynchronicznie po zakończeniu zadania docelowego.

public:
 System::Threading::Tasks::Task ^ ContinueWith(Action<System::Threading::Tasks::Task<TResult> ^> ^ continuationAction);

public System.Threading.Tasks.Task ContinueWith (Action<System.Threading.Tasks.Task<TResult>> continuationAction);

override this.ContinueWith : Action<System.Threading.Tasks.Task<'Result>> -> System.Threading.Tasks.Task

Public Function ContinueWith (continuationAction As Action(Of Task(Of TResult))) As Task

Parametry

continuationAction

Action<Task<TResult>>

Akcja do uruchomienia po zakończeniu poprzedzania Task<TResult> . Po uruchomieniu delegat zostanie przekazany ukończone zadanie jako argument.

Zwraca

Task

Nowe zadanie kontynuacji.

Wyjątki

ObjectDisposedException

Element Task<TResult> został usunięty.

ArgumentNullException

Argumentem continuationAction jest null.

Przykłady

W poniższym przykładzie jest tworzone przedzident zadania, które używa sieve of Eratosthenes do obliczania liczb głównych z zakresu od 1 do wartości wprowadzonej przez użytkownika. Tablica służy do przechowywania informacji o liczbach głównych. Indeks tablicy reprezentuje liczbę, a wartość elementu wskazuje, czy ta liczba jest złożona (jego wartość to true) czy prime (jego wartość to false). To zadanie jest następnie przekazywane do zadania kontynuacji, które jest odpowiedzialne za wyodrębnianie liczb głównych z tablicy całkowitej i wyświetlanie ich.

using System;
using System.Collections.Generic;
using System.Threading;
using System.Threading.Tasks;

public class Example
{
   public static void Main(string[] args)
   {
      int upperBound = args.Length >= 1 ? Int32.Parse(args[0]) : 200;

      var t1 = Task.Run(() => { // True = composite.
                                // False = prime.
                                bool[] values = new bool[upperBound + 1];
                                for (int ctr = 2; ctr <= (int) Math.Sqrt(upperBound); ctr++) {
                                   if (values[ctr] == false) {
                                      for (int product = ctr * ctr; product <= upperBound;
                                                                    product = product + ctr)
                                         values[product] = true;
                                   }
                                }
                                return values; });
      var t2 = t1.ContinueWith( (antecedent) => { // Create a list of prime numbers.
                                                  var  primes = new List<int>();
                                                  bool[] numbers = antecedent.Result;
                                                  string output = String.Empty;

                                                  for (int ctr = 1; ctr <= numbers.GetUpperBound(0); ctr++)
                                                     if (numbers[ctr] == false)
                                                        primes.Add(ctr);

                                                  // Create the output string.
                                                  for (int ctr = 0; ctr < primes.Count; ctr++) {
                                                     output += primes[ctr].ToString("N0");
                                                     if (ctr < primes.Count - 1)
                                                        output += ",  ";
                                                     if ((ctr + 1) % 8 == 0)
                                                        output += Environment.NewLine;
                                                  }
                                                  //Display the result.
                                                  Console.WriteLine("Prime numbers from 1 to {0}:\n",
                                                                    upperBound);
                                                  Console.WriteLine(output);
                                                });
      try {
         t2.Wait();
      }
      catch (AggregateException ae) {
         foreach (var e in ae.InnerExceptions)
            Console.WriteLine("{0}: {1}", e.GetType().Name, e.Message);
      }
   }
}
// The example displays output like the following:
//       Prime numbers from 1 to 400:
//
//       1,  2,  3,  5,  7,  11,  13,  17,
//       19,  23,  29,  31,  37,  41,  43,  47,
//       53,  59,  61,  67,  71,  73,  79,  83,
//       89,  97,  101,  103,  107,  109,  113,  127,
//       131,  137,  139,  149,  151,  157,  163,  167,
//       173,  179,  181,  191,  193,  197,  199,  211,
//       223,  227,  229,  233,  239,  241,  251,  257,
//       263,  269,  271,  277,  281,  283,  293,  307,
//       311,  313,  317,  331,  337,  347,  349,  353,
//       359,  367,  373,  379,  383,  389,  397,  401

Imports System.Collections.Generic
Imports System.Threading
Imports System.Threading.Tasks

Module Example
   Public Sub Main(args() As String)
      Dim upperBound As Integer = If(args.Length >= 1, CInt(args(0)), 200)

      Dim t1 = Task.Run(Function()
                          ' True = composite.
                          ' False = prime.
                          Dim values(upperBound) As Boolean
                          For ctr = 2 To CInt(Math.Sqrt(upperBound))
                             If values(ctr) = False Then
                                For product = ctr * ctr To upperBound Step ctr
                                   values(product) = True
                                Next
                             End If
                          Next
                          Return values
                       End Function)

      Dim t2 = t1.ContinueWith(Sub(antecedent)
                                  ' Create a list of prime numbers.
                                  Dim primes As New List(Of Integer)()
                                  Dim numbers As Boolean() = antecedent.Result
                                  Dim output As String = String.Empty
                                  
                                  For ctr As Integer = 1 To numbers.GetUpperBound(0)
                                     If numbers(ctr) = False Then primes.Add(ctr)
                                  Next

                                  ' Create the output string.
                                  For ctr As Integer = 0 To primes.Count - 1
                                     output += primes(ctr).ToString("N0")
                                     If ctr < primes.Count - 1 Then output += ",  "
                                     If (ctr + 1) Mod 8 = 0 Then output += vbCrLf
                                  Next
                                  'Display the result.
                                  Console.WriteLine("Prime numbers from 1 to {0}:{1}",
                                                    upperBound, vbCrLf)
                                  Console.WriteLine(output)
                               End Sub)
      Try
         t2.Wait()
      Catch ae As AggregateException
         For Each e In ae.InnerExceptions
            Console.WriteLine("{0}: {1}", e.GetType().Name, e.Message)
         Next
      End Try
   End Sub
End Module
' The example displays output like the following:
'       Prime numbers from 1 to 400:
'
'       1,  2,  3,  5,  7,  11,  13,  17,
'       19,  23,  29,  31,  37,  41,  43,  47,
'       53,  59,  61,  67,  71,  73,  79,  83,
'       89,  97,  101,  103,  107,  109,  113,  127,
'       131,  137,  139,  149,  151,  157,  163,  167,
'       173,  179,  181,  191,  193,  197,  199,  211,
'       223,  227,  229,  233,  239,  241,  251,  257,
'       263,  269,  271,  277,  281,  283,  293,  307,
'       311,  313,  317,  331,  337,  347,  349,  353,
'       359,  367,  373,  379,  383,  389,  397,  401
' If cancellation is requested, the example displays output like the following:
'       The operation was cancelled.

Uwagi

Zwrócony Task element nie zostanie zaplanowany do wykonania do momentu ukończenia bieżącego zadania, tego, czy zostanie ukończone z powodu pomyślnego ukończenia, błędu z powodu nieobsługiwanego wyjątku lub wcześniejszego zakończenia z powodu anulowania.

Zobacz też

• Biblioteka zadań równoległych (TPL)
• Programowanie asynchroniczne oparte na zadaniach
• Tworzenie łańcuchów zadań przy użyciu zadań kontynuacji

ContinueWith(Action<Task<TResult>>, TaskScheduler)

Źródło:

Future.cs

Tworzy kontynuację, która jest wykonywana asynchronicznie po zakończeniu elementu docelowego Task<TResult> .

public:
 System::Threading::Tasks::Task ^ ContinueWith(Action<System::Threading::Tasks::Task<TResult> ^> ^ continuationAction, System::Threading::Tasks::TaskScheduler ^ scheduler);

public System.Threading.Tasks.Task ContinueWith (Action<System.Threading.Tasks.Task<TResult>> continuationAction, System.Threading.Tasks.TaskScheduler scheduler);

override this.ContinueWith : Action<System.Threading.Tasks.Task<'Result>> * System.Threading.Tasks.TaskScheduler -> System.Threading.Tasks.Task

Public Function ContinueWith (continuationAction As Action(Of Task(Of TResult)), scheduler As TaskScheduler) As Task

Parametry

continuationAction

Action<Task<TResult>>

Akcja do uruchomienia po zakończeniu Task<TResult> . Po uruchomieniu delegat zostanie przekazany ukończone zadanie jako argument.

scheduler

TaskScheduler

Element do skojarzenia TaskScheduler z zadaniem kontynuacji i do użycia do jego wykonania.

Zwraca

Task

Nowa kontynuacja Task.

Wyjątki

ObjectDisposedException

Element Task<TResult> został usunięty.

ArgumentNullException

Argumentem continuationAction jest null.

-lub-

Argumentem scheduler jest null.

Uwagi

Zwrócony Task element nie zostanie zaplanowany do wykonania do momentu ukończenia bieżącego zadania, tego, czy zostanie ukończone z powodu pomyślnego ukończenia, błędu z powodu nieobsługiwanego wyjątku lub wcześniejszego zakończenia z powodu anulowania.

Zobacz też

• Biblioteka zadań równoległych (TPL)
• Programowanie asynchroniczne oparte na zadaniach
• Tworzenie łańcuchów zadań przy użyciu zadań kontynuacji

ContinueWith<TNewResult>(Func<Task<TResult>,Object,TNewResult>, Object, CancellationToken, TaskContinuationOptions, TaskScheduler)

Źródło:

Future.cs

Tworzy kontynuację wykonywaną po zakończeniu działania obiektu docelowego Task<TResult> .

public:
generic <typename TNewResult>
 System::Threading::Tasks::Task<TNewResult> ^ ContinueWith(Func<System::Threading::Tasks::Task<TResult> ^, System::Object ^, TNewResult> ^ continuationFunction, System::Object ^ state, System::Threading::CancellationToken cancellationToken, System::Threading::Tasks::TaskContinuationOptions continuationOptions, System::Threading::Tasks::TaskScheduler ^ scheduler);

public System.Threading.Tasks.Task<TNewResult> ContinueWith<TNewResult> (Func<System.Threading.Tasks.Task<TResult>,object?,TNewResult> continuationFunction, object? state, System.Threading.CancellationToken cancellationToken, System.Threading.Tasks.TaskContinuationOptions continuationOptions, System.Threading.Tasks.TaskScheduler scheduler);

override this.ContinueWith : Func<System.Threading.Tasks.Task<'Result>, obj, 'NewResult> * obj * System.Threading.CancellationToken * System.Threading.Tasks.TaskContinuationOptions * System.Threading.Tasks.TaskScheduler -> System.Threading.Tasks.Task<'NewResult>

Public Function ContinueWith(Of TNewResult) (continuationFunction As Func(Of Task(Of TResult), Object, TNewResult), state As Object, cancellationToken As CancellationToken, continuationOptions As TaskContinuationOptions, scheduler As TaskScheduler) As Task(Of TNewResult)

Parametry typu

TNewResult

Typ wyniku wygenerowanego przez kontynuację.

Parametry

continuationFunction

Func<Task<TResult>,Object,TNewResult>

Funkcja uruchamiana po zakończeniu Task<TResult> . Po uruchomieniu delegat zostanie przekazany ukończone zadanie i obiekt stanu dostarczonego przez obiekt wywołujący jako argumenty.

state

Object

Obiekt reprezentujący dane, które mają być używane przez funkcję kontynuacji.

cancellationToken

CancellationToken

Element CancellationToken , który zostanie przypisany do nowego zadania.

continuationOptions

TaskContinuationOptions

Opcje dotyczące zaplanowanych kontynuacji i sposobu jej działania. Obejmuje to kryteria, takie jak OnlyOnCanceled, a także opcje wykonywania, takie jak ExecuteSynchronously.

scheduler

TaskScheduler

Element do skojarzenia TaskScheduler z zadaniem kontynuacji i do użycia do jego wykonania.

Zwraca

Task<TNewResult>

Nowa kontynuacja Task<TResult>.

Wyjątki

ArgumentNullException

Argumentem scheduler jest null.

ArgumentOutOfRangeException

Argument continuationOptions określa nieprawidłową wartość dla elementu TaskContinuationOptions.

ObjectDisposedException

Podany CancellationToken element został już usunięty.

Uwagi

Zwrócony Task<TResult> element nie zostanie zaplanowany do wykonania do momentu ukończenia bieżącego zadania, tego, czy zostanie ukończone z powodu pomyślnego ukończenia, błędu z powodu nieobsługiwanego wyjątku lub wcześniejszego zakończenia z powodu anulowania.

Element , po wykonaniu continuationFunction, powinien zwrócić wartość Task<TResult>. Stan ukończenia tego zadania zostanie przeniesiony do zadania zwróconego z wywołania Task<TResult>.ContinueWith .

Zobacz też

• Tworzenie łańcuchów zadań przy użyciu zadań kontynuacji

ContinueWith<TNewResult>(Func<Task<TResult>,TNewResult>, CancellationToken, TaskContinuationOptions, TaskScheduler)

Źródło:

Future.cs

Tworzy kontynuację wykonywaną zgodnie z warunkiem określonym w continuationOptionspliku .

public:
generic <typename TNewResult>
 System::Threading::Tasks::Task<TNewResult> ^ ContinueWith(Func<System::Threading::Tasks::Task<TResult> ^, TNewResult> ^ continuationFunction, System::Threading::CancellationToken cancellationToken, System::Threading::Tasks::TaskContinuationOptions continuationOptions, System::Threading::Tasks::TaskScheduler ^ scheduler);

public System.Threading.Tasks.Task<TNewResult> ContinueWith<TNewResult> (Func<System.Threading.Tasks.Task<TResult>,TNewResult> continuationFunction, System.Threading.CancellationToken cancellationToken, System.Threading.Tasks.TaskContinuationOptions continuationOptions, System.Threading.Tasks.TaskScheduler scheduler);

override this.ContinueWith : Func<System.Threading.Tasks.Task<'Result>, 'NewResult> * System.Threading.CancellationToken * System.Threading.Tasks.TaskContinuationOptions * System.Threading.Tasks.TaskScheduler -> System.Threading.Tasks.Task<'NewResult>

Public Function ContinueWith(Of TNewResult) (continuationFunction As Func(Of Task(Of TResult), TNewResult), cancellationToken As CancellationToken, continuationOptions As TaskContinuationOptions, scheduler As TaskScheduler) As Task(Of TNewResult)

Parametry typu

TNewResult

Typ wyniku wygenerowanego przez kontynuację.

Parametry

continuationFunction

Func<Task<TResult>,TNewResult>

Funkcja uruchamiana zgodnie z warunkiem określonym w elemecie continuationOptions.

Po uruchomieniu delegat zostanie przekazany jako argument, który został ukończony.

cancellationToken

CancellationToken

Element CancellationToken , który zostanie przypisany do nowego zadania.

continuationOptions

TaskContinuationOptions

Opcje, kiedy kontynuacja jest zaplanowana i jak się zachowuje. Obejmuje to kryteria, takie jak OnlyOnCanceled, a także opcje wykonywania, takie jak ExecuteSynchronously.

scheduler

TaskScheduler

Element TaskScheduler do skojarzenia z zadaniem kontynuacji i do użycia do jego wykonania.

Zwraca

Task<TNewResult>

Nowa kontynuacja Task<TResult>.

Wyjątki

ObjectDisposedException

Został Task<TResult> usunięty.

-lub-

CancellationTokenSource Utworzony element cancellationToken został już usunięty.

ArgumentNullException

Argumentem continuationFunction jest null.

-lub-

Argumentem scheduler jest null.

ArgumentOutOfRangeException

Argument continuationOptions określa nieprawidłową wartość dla TaskContinuationOptionselementu .

Uwagi

Zwrócony Task<TResult> element nie zostanie zaplanowany do wykonania do momentu ukończenia bieżącego zadania, niezależnie od tego, czy zostanie ukończone z powodu pomyślnego ukończenia, po awarii z powodu nieobsługiwanego wyjątku lub wcześniejszego zakończenia z powodu anulowania.

Element , po wykonaniu continuationFunction, powinien zwrócić element Task<TResult>.

Zobacz też

• Biblioteka zadań równoległych (TPL)
• Programowanie asynchroniczne oparte na zadaniach
• Tworzenie łańcuchów zadań przy użyciu zadań kontynuacji

ContinueWith<TNewResult>(Func<Task<TResult>,Object,TNewResult>, Object, TaskScheduler)

Źródło:

Future.cs

Tworzy kontynuację wykonywaną po zakończeniu działania obiektu docelowego Task<TResult> .

public:
generic <typename TNewResult>
 System::Threading::Tasks::Task<TNewResult> ^ ContinueWith(Func<System::Threading::Tasks::Task<TResult> ^, System::Object ^, TNewResult> ^ continuationFunction, System::Object ^ state, System::Threading::Tasks::TaskScheduler ^ scheduler);

public System.Threading.Tasks.Task<TNewResult> ContinueWith<TNewResult> (Func<System.Threading.Tasks.Task<TResult>,object?,TNewResult> continuationFunction, object? state, System.Threading.Tasks.TaskScheduler scheduler);

override this.ContinueWith : Func<System.Threading.Tasks.Task<'Result>, obj, 'NewResult> * obj * System.Threading.Tasks.TaskScheduler -> System.Threading.Tasks.Task<'NewResult>

Public Function ContinueWith(Of TNewResult) (continuationFunction As Func(Of Task(Of TResult), Object, TNewResult), state As Object, scheduler As TaskScheduler) As Task(Of TNewResult)

Parametry typu

TNewResult

Typ wyniku wygenerowanego przez kontynuację.

Parametry

continuationFunction

Func<Task<TResult>,Object,TNewResult>

Funkcja do uruchomienia po zakończeniu Task<TResult> . Po uruchomieniu delegat zostanie przekazany ukończone zadanie i obiekt stanu dostarczonego przez obiekt wywołujący jako argumenty.

state

Object

Obiekt reprezentujący dane, które mają być używane przez funkcję kontynuacji.

scheduler

TaskScheduler

Element TaskScheduler do skojarzenia z zadaniem kontynuacji i do użycia do jego wykonania.

Zwraca

Task<TNewResult>

Nowa kontynuacja Task<TResult>.

Wyjątki

ArgumentNullException

Argumentem scheduler jest null.

Uwagi

Zwrócony Task<TResult> element nie zostanie zaplanowany do wykonania do momentu ukończenia bieżącego zadania, niezależnie od tego, czy zostanie ukończone z powodu pomyślnego ukończenia, po awarii z powodu nieobsługiwanego wyjątku lub wcześniejszego zakończenia z powodu anulowania.

Zobacz też

• Tworzenie łańcuchów zadań przy użyciu zadań kontynuacji

ContinueWith<TNewResult>(Func<Task<TResult>,Object,TNewResult>, Object, CancellationToken)

Źródło:

Future.cs

Tworzy kontynuację wykonywaną po zakończeniu działania obiektu docelowego Task<TResult> .

public:
generic <typename TNewResult>
 System::Threading::Tasks::Task<TNewResult> ^ ContinueWith(Func<System::Threading::Tasks::Task<TResult> ^, System::Object ^, TNewResult> ^ continuationFunction, System::Object ^ state, System::Threading::CancellationToken cancellationToken);

public System.Threading.Tasks.Task<TNewResult> ContinueWith<TNewResult> (Func<System.Threading.Tasks.Task<TResult>,object?,TNewResult> continuationFunction, object? state, System.Threading.CancellationToken cancellationToken);

override this.ContinueWith : Func<System.Threading.Tasks.Task<'Result>, obj, 'NewResult> * obj * System.Threading.CancellationToken -> System.Threading.Tasks.Task<'NewResult>

Public Function ContinueWith(Of TNewResult) (continuationFunction As Func(Of Task(Of TResult), Object, TNewResult), state As Object, cancellationToken As CancellationToken) As Task(Of TNewResult)

Parametry typu

TNewResult

Typ wyniku wygenerowanego przez kontynuację.

Parametry

continuationFunction

Func<Task<TResult>,Object,TNewResult>

Funkcja do uruchomienia po zakończeniu Task<TResult> . Po uruchomieniu delegat zostanie przekazany ukończone zadanie i obiekt stanu dostarczonego przez obiekt wywołujący jako argumenty.

state

Object

Obiekt reprezentujący dane, które mają być używane przez funkcję kontynuacji.

cancellationToken

CancellationToken

Element CancellationToken , który zostanie przypisany do nowego zadania.

Zwraca

Task<TNewResult>

Nowa kontynuacja Task<TResult>.

Wyjątki

ArgumentNullException

Argumentem continuationFunction jest null.

ObjectDisposedException

Dostarczone CancellationToken zostało już usunięte.

Uwagi

Zwrócony Task<TResult> element nie zostanie zaplanowany do wykonania do momentu ukończenia bieżącego zadania, niezależnie od tego, czy zostanie ukończone z powodu pomyślnego ukończenia, po awarii z powodu nieobsługiwanego wyjątku lub wcześniejszego zakończenia z powodu anulowania.

Zobacz też

• Tworzenie łańcuchów zadań przy użyciu zadań kontynuacji

ContinueWith<TNewResult>(Func<Task<TResult>,Object,TNewResult>, Object, TaskContinuationOptions)

Źródło:

Future.cs

Tworzy kontynuację wykonywaną po zakończeniu działania obiektu docelowego Task<TResult> .

public:
generic <typename TNewResult>
 System::Threading::Tasks::Task<TNewResult> ^ ContinueWith(Func<System::Threading::Tasks::Task<TResult> ^, System::Object ^, TNewResult> ^ continuationFunction, System::Object ^ state, System::Threading::Tasks::TaskContinuationOptions continuationOptions);

public System.Threading.Tasks.Task<TNewResult> ContinueWith<TNewResult> (Func<System.Threading.Tasks.Task<TResult>,object?,TNewResult> continuationFunction, object? state, System.Threading.Tasks.TaskContinuationOptions continuationOptions);

override this.ContinueWith : Func<System.Threading.Tasks.Task<'Result>, obj, 'NewResult> * obj * System.Threading.Tasks.TaskContinuationOptions -> System.Threading.Tasks.Task<'NewResult>

Public Function ContinueWith(Of TNewResult) (continuationFunction As Func(Of Task(Of TResult), Object, TNewResult), state As Object, continuationOptions As TaskContinuationOptions) As Task(Of TNewResult)

Parametry typu

TNewResult

Typ wyniku wygenerowanego przez kontynuację.

Parametry

continuationFunction

Func<Task<TResult>,Object,TNewResult>

Funkcja do uruchomienia po zakończeniu Task<TResult> . Po uruchomieniu delegat zostanie przekazany ukończone zadanie i obiekt stanu dostarczonego przez obiekt wywołujący jako argumenty.

state

Object

Obiekt reprezentujący dane, które mają być używane przez funkcję kontynuacji.

continuationOptions

TaskContinuationOptions

Opcje, kiedy kontynuacja jest zaplanowana i jak się zachowuje. Obejmuje to kryteria, takie jak OnlyOnCanceled, a także opcje wykonywania, takie jak ExecuteSynchronously.

Zwraca

Task<TNewResult>

Nowa kontynuacja Task<TResult>.

Wyjątki

ArgumentNullException

Argumentem continuationFunction jest null.

ArgumentOutOfRangeException

Argument continuationOptions określa nieprawidłową wartość dla TaskContinuationOptionselementu .

Uwagi

Zwrócony Task<TResult> element nie zostanie zaplanowany do wykonania do momentu ukończenia bieżącego zadania, niezależnie od tego, czy zostanie ukończone z powodu pomyślnego ukończenia, po awarii z powodu nieobsługiwanego wyjątku lub wcześniejszego zakończenia z powodu anulowania.

Element , po wykonaniu continuationFunction, powinien zwrócić element Task<TResult>. Stan ukończenia tego zadania zostanie przeniesiony do zadania zwróconego z wywołania ContinueWith.

Zobacz też

• Tworzenie łańcuchów zadań przy użyciu zadań kontynuacji

ContinueWith<TNewResult>(Func<Task<TResult>,TNewResult>, TaskContinuationOptions)

Źródło:

Future.cs

Tworzy kontynuację wykonywaną zgodnie z warunkiem określonym w continuationOptionspliku .

public:
generic <typename TNewResult>
 System::Threading::Tasks::Task<TNewResult> ^ ContinueWith(Func<System::Threading::Tasks::Task<TResult> ^, TNewResult> ^ continuationFunction, System::Threading::Tasks::TaskContinuationOptions continuationOptions);

public System.Threading.Tasks.Task<TNewResult> ContinueWith<TNewResult> (Func<System.Threading.Tasks.Task<TResult>,TNewResult> continuationFunction, System.Threading.Tasks.TaskContinuationOptions continuationOptions);

override this.ContinueWith : Func<System.Threading.Tasks.Task<'Result>, 'NewResult> * System.Threading.Tasks.TaskContinuationOptions -> System.Threading.Tasks.Task<'NewResult>

Public Function ContinueWith(Of TNewResult) (continuationFunction As Func(Of Task(Of TResult), TNewResult), continuationOptions As TaskContinuationOptions) As Task(Of TNewResult)

Parametry typu

TNewResult

Typ wyniku wygenerowanego przez kontynuację.

Parametry

continuationFunction

Func<Task<TResult>,TNewResult>

Funkcja uruchamiana zgodnie z warunkiem określonym w elemecie continuationOptions.

Po uruchomieniu delegat zostanie przekazany ukończone zadanie jako argument.

continuationOptions

TaskContinuationOptions

Opcje, kiedy kontynuacja jest zaplanowana i jak się zachowuje. Obejmuje to kryteria, takie jak OnlyOnCanceled, a także opcje wykonywania, takie jak ExecuteSynchronously.

Zwraca

Task<TNewResult>

Nowa kontynuacja Task<TResult>.

Wyjątki

ObjectDisposedException

Został Task<TResult> usunięty.

ArgumentNullException

Argumentem continuationFunction jest null.

ArgumentOutOfRangeException

Argument continuationOptions określa nieprawidłową wartość dla TaskContinuationOptionselementu .

Uwagi

Zwrócony Task<TResult> element nie zostanie zaplanowany do wykonania do momentu ukończenia bieżącego zadania, niezależnie od tego, czy zostanie ukończone z powodu pomyślnego ukończenia, po awarii z powodu nieobsługiwanego wyjątku lub wcześniejszego zakończenia z powodu anulowania.

Element , po wykonaniu continuationFunction, powinien zwrócić element Task<TResult>.

Zobacz też

• Biblioteka zadań równoległych (TPL)
• Programowanie asynchroniczne oparte na zadaniach
• Tworzenie łańcuchów zadań przy użyciu zadań kontynuacji

ContinueWith<TNewResult>(Func<Task<TResult>,TNewResult>, CancellationToken)

Źródło:

Future.cs

Tworzy kontynuację wykonywaną asynchronicznie po zakończeniu celu Task<TResult> .

public:
generic <typename TNewResult>
 System::Threading::Tasks::Task<TNewResult> ^ ContinueWith(Func<System::Threading::Tasks::Task<TResult> ^, TNewResult> ^ continuationFunction, System::Threading::CancellationToken cancellationToken);

public System.Threading.Tasks.Task<TNewResult> ContinueWith<TNewResult> (Func<System.Threading.Tasks.Task<TResult>,TNewResult> continuationFunction, System.Threading.CancellationToken cancellationToken);

override this.ContinueWith : Func<System.Threading.Tasks.Task<'Result>, 'NewResult> * System.Threading.CancellationToken -> System.Threading.Tasks.Task<'NewResult>

Public Function ContinueWith(Of TNewResult) (continuationFunction As Func(Of Task(Of TResult), TNewResult), cancellationToken As CancellationToken) As Task(Of TNewResult)

Parametry typu

TNewResult

Typ wyniku wygenerowanego przez kontynuację.

Parametry

continuationFunction

Func<Task<TResult>,TNewResult>

Funkcja do uruchomienia po zakończeniu Task<TResult> . Po uruchomieniu delegat zostanie przekazany ukończone zadanie jako argument.

cancellationToken

CancellationToken

Element CancellationToken , który zostanie przypisany do nowego zadania.

Zwraca

Task<TNewResult>

Nowa kontynuacja Task<TResult>.

Wyjątki

ObjectDisposedException

Został Task<TResult> usunięty.

-lub-

CancellationTokenSource Utworzony element cancellationToken został już usunięty.

ArgumentNullException

Argumentem continuationFunction jest null.

Uwagi

Zwrócony Task<TResult> element nie zostanie zaplanowany do wykonania do momentu ukończenia bieżącego zadania, niezależnie od tego, czy zostanie ukończone z powodu pomyślnego ukończenia, po awarii z powodu nieobsługiwanego wyjątku lub wcześniejszego zakończenia z powodu anulowania.

Zobacz też

• Biblioteka zadań równoległych (TPL)
• Programowanie asynchroniczne oparte na zadaniach
• Tworzenie łańcuchów zadań przy użyciu zadań kontynuacji

ContinueWith<TNewResult>(Func<Task<TResult>,Object,TNewResult>, Object)

Źródło:

Future.cs

Tworzy kontynuację wykonywaną po zakończeniu działania obiektu docelowego Task<TResult> .

public:
generic <typename TNewResult>
 System::Threading::Tasks::Task<TNewResult> ^ ContinueWith(Func<System::Threading::Tasks::Task<TResult> ^, System::Object ^, TNewResult> ^ continuationFunction, System::Object ^ state);

public System.Threading.Tasks.Task<TNewResult> ContinueWith<TNewResult> (Func<System.Threading.Tasks.Task<TResult>,object?,TNewResult> continuationFunction, object? state);

override this.ContinueWith : Func<System.Threading.Tasks.Task<'Result>, obj, 'NewResult> * obj -> System.Threading.Tasks.Task<'NewResult>

Public Function ContinueWith(Of TNewResult) (continuationFunction As Func(Of Task(Of TResult), Object, TNewResult), state As Object) As Task(Of TNewResult)

Parametry typu

TNewResult

Typ wyniku wygenerowanego przez kontynuację.

Parametry

continuationFunction

Func<Task<TResult>,Object,TNewResult>

Funkcja do uruchomienia po zakończeniu Task<TResult> . Po uruchomieniu delegat zostanie przekazany ukończone zadanie i obiekt stanu dostarczonego przez obiekt wywołujący jako argumenty.

state

Object

Obiekt reprezentujący dane, które mają być używane przez funkcję kontynuacji.

Zwraca

Task<TNewResult>

Nowa kontynuacja Task<TResult>.

Wyjątki

ArgumentNullException

Argumentem continuationFunction jest null.

Przykłady

Poniższy przykład tworzy łańcuch zadań kontynuacji. Każde zadanie udostępnia bieżący czas, DateTime obiekt dla argumentu ContinueWith(Action<Task,Object>, Object) stanu metody. Każda DateTime wartość reprezentuje czas tworzenia zadania kontynuuj. Każde zadanie generuje w wyniku drugą DateTime wartość reprezentującą czas zakończenia zadania. Po zakończeniu wszystkich zadań przykład wyświetla datę i godziny rozpoczęcia i zakończenia każdego zadania kontynuacji.

using System;
using System.Collections.Generic;
using System.Threading;
using System.Threading.Tasks;

// Demonstrates how to associate state with task continuations.
class ContinuationState
{
   // Simluates a lengthy operation and returns the time at which
   // the operation completed.
   public static DateTime DoWork()
   {
      // Simulate work by suspending the current thread
      // for two seconds.
      Thread.Sleep(2000);

      // Return the current time.
      return DateTime.Now;
   }

   static void Main(string[] args)
   {
      // Start a root task that performs work.
      Task<DateTime> t = Task<DateTime>.Run(delegate { return DoWork(); });

      // Create a chain of continuation tasks, where each task is
      // followed by another task that performs work.
      List<Task<DateTime>> continuations = new List<Task<DateTime>>();
      for (int i = 0; i < 5; i++)
      {
         // Provide the current time as the state of the continuation.
         t = t.ContinueWith(delegate { return DoWork(); }, DateTime.Now);
         continuations.Add(t);
      }

      // Wait for the last task in the chain to complete.
      t.Wait();

      // Print the creation time of each continuation (the state object)
      // and the completion time (the result of that task) to the console.
      foreach (var continuation in continuations)
      {
         DateTime start = (DateTime)continuation.AsyncState;
         DateTime end = continuation.Result;

         Console.WriteLine("Task was created at {0} and finished at {1}.",
            start.TimeOfDay, end.TimeOfDay);
      }
   }
}

/* Sample output:
Task was created at 10:56:21.1561762 and finished at 10:56:25.1672062.
Task was created at 10:56:21.1610677 and finished at 10:56:27.1707646.
Task was created at 10:56:21.1610677 and finished at 10:56:29.1743230.
Task was created at 10:56:21.1610677 and finished at 10:56:31.1779883.
Task was created at 10:56:21.1610677 and finished at 10:56:33.1837083.
*/

Imports System.Collections.Generic
Imports System.Threading
Imports System.Threading.Tasks

' Demonstrates how to associate state with task continuations.
Public Module ContinuationState
   ' Simluates a lengthy operation and returns the time at which
   ' the operation completed.
   Public Function DoWork() As Date
      ' Simulate work by suspending the current thread 
      ' for two seconds.
      Thread.Sleep(2000)

      ' Return the current time.
      Return Date.Now
   End Function

   Public Sub Main()
      ' Start a root task that performs work.
      Dim t As Task(Of Date) = Task(Of Date).Run(Function() DoWork())

      ' Create a chain of continuation tasks, where each task is
      ' followed by another task that performs work.
      Dim continuations As New List(Of Task(Of DateTime))()
      For i As Integer = 0 To 4
         ' Provide the current time as the state of the continuation.
         t = t.ContinueWith(Function(antecedent, state) DoWork(), DateTime.Now)
         continuations.Add(t)
      Next

      ' Wait for the last task in the chain to complete.
      t.Wait()

      ' Display the creation time of each continuation (the state object)
      ' and the completion time (the result of that task) to the console.
      For Each continuation In continuations
         Dim start As DateTime = CDate(continuation.AsyncState)
         Dim [end] As DateTime = continuation.Result

         Console.WriteLine("Task was created at {0} and finished at {1}.",
            start.TimeOfDay, [end].TimeOfDay)
      Next
   End Sub
End Module
' The example displays output like the following:
'       Task was created at 10:56:21.1561762 and finished at 10:56:25.1672062.
'       Task was created at 10:56:21.1610677 and finished at 10:56:27.1707646.
'       Task was created at 10:56:21.1610677 and finished at 10:56:29.1743230.
'       Task was created at 10:56:21.1610677 and finished at 10:56:31.1779883.
'       Task was created at 10:56:21.1610677 and finished at 10:56:33.1837083.

Uwagi

Zwrócony Task<TResult> element nie zostanie zaplanowany do wykonania do momentu ukończenia bieżącego zadania, niezależnie od tego, czy zostanie ukończone z powodu pomyślnego ukończenia, po awarii z powodu nieobsługiwanego wyjątku lub wcześniejszego zakończenia z powodu anulowania.

Zobacz też

• Tworzenie łańcuchów zadań przy użyciu zadań kontynuacji

ContinueWith<TNewResult>(Func<Task<TResult>,TNewResult>)

Źródło:

Future.cs

Tworzy kontynuację, która jest wykonywana asynchronicznie po zakończeniu elementu docelowego Task<TResult> .

public:
generic <typename TNewResult>
 System::Threading::Tasks::Task<TNewResult> ^ ContinueWith(Func<System::Threading::Tasks::Task<TResult> ^, TNewResult> ^ continuationFunction);

public System.Threading.Tasks.Task<TNewResult> ContinueWith<TNewResult> (Func<System.Threading.Tasks.Task<TResult>,TNewResult> continuationFunction);

override this.ContinueWith : Func<System.Threading.Tasks.Task<'Result>, 'NewResult> -> System.Threading.Tasks.Task<'NewResult>

Public Function ContinueWith(Of TNewResult) (continuationFunction As Func(Of Task(Of TResult), TNewResult)) As Task(Of TNewResult)

Parametry typu

TNewResult

Typ wyniku wygenerowanego przez kontynuację.

Parametry

continuationFunction

Func<Task<TResult>,TNewResult>

Funkcja uruchamiana po zakończeniu Task<TResult> . Po uruchomieniu delegat zostanie przekazany ukończone zadanie jako argument.

Zwraca

Task<TNewResult>

Nowa kontynuacja Task<TResult>.

Wyjątki

ObjectDisposedException

Element Task<TResult> został usunięty.

ArgumentNullException

Argumentem continuationFunction jest null.

Uwagi

Zwrócony Task<TResult> element nie zostanie zaplanowany do wykonania do momentu ukończenia bieżącego zadania, tego, czy zostanie ukończone z powodu pomyślnego ukończenia, błędu z powodu nieobsługiwanego wyjątku lub wcześniejszego zakończenia z powodu anulowania.

Zobacz też

• Biblioteka zadań równoległych (TPL)
• Programowanie asynchroniczne oparte na zadaniach
• Tworzenie łańcuchów zadań przy użyciu zadań kontynuacji

ContinueWith<TNewResult>(Func<Task<TResult>,TNewResult>, TaskScheduler)

Źródło:

Future.cs

Tworzy kontynuację, która jest wykonywana asynchronicznie po zakończeniu elementu docelowego Task<TResult> .

public:
generic <typename TNewResult>
 System::Threading::Tasks::Task<TNewResult> ^ ContinueWith(Func<System::Threading::Tasks::Task<TResult> ^, TNewResult> ^ continuationFunction, System::Threading::Tasks::TaskScheduler ^ scheduler);

public System.Threading.Tasks.Task<TNewResult> ContinueWith<TNewResult> (Func<System.Threading.Tasks.Task<TResult>,TNewResult> continuationFunction, System.Threading.Tasks.TaskScheduler scheduler);

override this.ContinueWith : Func<System.Threading.Tasks.Task<'Result>, 'NewResult> * System.Threading.Tasks.TaskScheduler -> System.Threading.Tasks.Task<'NewResult>

Public Function ContinueWith(Of TNewResult) (continuationFunction As Func(Of Task(Of TResult), TNewResult), scheduler As TaskScheduler) As Task(Of TNewResult)

Parametry typu

TNewResult

Typ wyniku wygenerowanego przez kontynuację.

Parametry

continuationFunction

Func<Task<TResult>,TNewResult>

Funkcja uruchamiana po zakończeniu Task<TResult> . Po uruchomieniu delegat zostanie przekazany ukończone zadanie jako argument.

scheduler

TaskScheduler

Element do skojarzenia TaskScheduler z zadaniem kontynuacji i do użycia do jego wykonania.

Zwraca

Task<TNewResult>

Nowa kontynuacja Task<TResult>.

Wyjątki

ObjectDisposedException

Element Task<TResult> został usunięty.

ArgumentNullException

Argumentem continuationFunction jest null.

-lub-

Argumentem scheduler jest null.

Uwagi

Zwrócony Task<TResult> element nie zostanie zaplanowany do wykonania do momentu ukończenia bieżącego zadania, tego, czy zostanie ukończone z powodu pomyślnego ukończenia, błędu z powodu nieobsługiwanego wyjątku lub wcześniejszego zakończenia z powodu anulowania.

Zobacz też

• TaskScheduler
• Biblioteka zadań równoległych (TPL)
• Programowanie asynchroniczne oparte na zadaniach
• Tworzenie łańcuchów zadań przy użyciu zadań kontynuacji