Task<TResult>.ContinueWith Метод

Определение

Пространство имен:

System.Threading.Tasks

Сборки:

netstandard.dll, System.Runtime.dll

Создает задачу продолжения, которая выполняется при завершении другой задачи.

Перегрузки

Имя	Описание
ContinueWith(Action<Task<TResult>,Object>, Object, CancellationToken, TaskContinuationOptions, TaskScheduler)	Создает продолжение, которое выполняется при завершении целевого объекта Task<TResult> .
ContinueWith(Action<Task<TResult>,Object>, Object, TaskScheduler)	Создает продолжение, которое выполняется при завершении целевого объекта Task<TResult> .
ContinueWith(Action<Task<TResult>,Object>, Object, TaskContinuationOptions)	Создает продолжение, которое выполняется при завершении целевого объекта Task<TResult> .
ContinueWith(Action<Task<TResult>,Object>, Object, CancellationToken)	Создает продолжение, которое выполняется при завершении целевого объекта Task<TResult> .
ContinueWith(Action<Task<TResult>>, CancellationToken, TaskContinuationOptions, TaskScheduler)	Создает продолжение, которое выполняется в соответствии с условием, указанным в continuationOptions.
ContinueWith(Action<Task<TResult>>, TaskContinuationOptions)	Создает продолжение, которое выполняется в соответствии с условием, указанным в continuationOptions.
ContinueWith(Action<Task<TResult>>, CancellationToken)	Создает отменяемое продолжение, которое выполняется асинхронно при завершении целевого объекта Task<TResult> .
ContinueWith(Action<Task<TResult>,Object>, Object)	Создает продолжение, которое передает сведения о состоянии и выполняется при завершении целевого объекта Task<TResult> .
ContinueWith(Action<Task<TResult>>)	Создает продолжение, которое выполняется асинхронно при завершении целевой задачи.
ContinueWith(Action<Task<TResult>>, TaskScheduler)	Создает продолжение, которое выполняется асинхронно при завершении целевого объекта Task<TResult> .
ContinueWith<TNewResult>(Func<Task<TResult>,Object,TNewResult>, Object, CancellationToken, TaskContinuationOptions, TaskScheduler)	Создает продолжение, которое выполняется при завершении целевого объекта Task<TResult> .
ContinueWith<TNewResult>(Func<Task<TResult>,TNewResult>, CancellationToken, TaskContinuationOptions, TaskScheduler)	Создает продолжение, которое выполняется в соответствии с условием, указанным в continuationOptions.
ContinueWith<TNewResult>(Func<Task<TResult>,Object,TNewResult>, Object, TaskScheduler)	Создает продолжение, которое выполняется при завершении целевого объекта Task<TResult> .
ContinueWith<TNewResult>(Func<Task<TResult>,Object,TNewResult>, Object, CancellationToken)	Создает продолжение, которое выполняется при завершении целевого объекта Task<TResult> .
ContinueWith<TNewResult>(Func<Task<TResult>,Object,TNewResult>, Object, TaskContinuationOptions)	Создает продолжение, которое выполняется при завершении целевого объекта Task<TResult> .
ContinueWith<TNewResult>(Func<Task<TResult>,TNewResult>, TaskContinuationOptions)	Создает продолжение, которое выполняется в соответствии с условием, указанным в continuationOptions.
ContinueWith<TNewResult>(Func<Task<TResult>,TNewResult>, CancellationToken)	Создает продолжение, которое выполняется асинхронно при завершении целевого объекта Task<TResult> .
ContinueWith<TNewResult>(Func<Task<TResult>,Object,TNewResult>, Object)	Создает продолжение, которое выполняется при завершении целевого объекта Task<TResult> .
ContinueWith<TNewResult>(Func<Task<TResult>,TNewResult>)	Создает продолжение, которое выполняется асинхронно при завершении целевого объекта Task<TResult> .
ContinueWith<TNewResult>(Func<Task<TResult>,TNewResult>, TaskScheduler)	Создает продолжение, которое выполняется асинхронно при завершении целевого объекта Task<TResult> .

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

Исходный код:

Future.cs

Создает продолжение, которое выполняется при завершении целевого объекта 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

Параметры

continuationAction

Action<Task<TResult>,Object>

Действие, выполняемое после Task<TResult> завершения. При выполнении делегат передает завершенную задачу и объект состояния, предоставленный вызывающим объектом в качестве аргументов.

state

Object

Объект, представляющий данные, используемые действием продолжения.

cancellationToken

CancellationToken

Эта CancellationToken задача будет назначена новой задаче продолжения.

continuationOptions

TaskContinuationOptions

Параметры, когда продолжение запланировано и как оно ведет себя. К ним относятся такие критерии, как, например OnlyOnCanceled, параметры выполнения, например ExecuteSynchronously.

scheduler

TaskScheduler

Связь TaskScheduler с задачей продолжения и использование для ее выполнения.

Возвращаемое значение

Task

Новое продолжение Task.

Исключения

ArgumentNullException

Аргумент scheduler имеет значение null.

ArgumentOutOfRangeException

Аргумент continuationOptions задает недопустимое значение для TaskContinuationOptions.

ObjectDisposedException

Предоставленные CancellationToken уже удалены.

Комментарии

Возвращаемый Task объект не будет запланирован на выполнение до завершения текущей задачи. Если критерии, указанные в параметре continuationOptions , не выполнены, задача продолжения будет отменена вместо запланированной.

См. также раздел

• Построение цепочек задач с помощью задач продолжения

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

Исходный код:

Future.cs

Создает продолжение, которое выполняется при завершении целевого объекта 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

Параметры

continuationAction

Action<Task<TResult>,Object>

Действие, выполняемое после Task<TResult> завершения. При выполнении делегат передает завершенную задачу и объект состояния, предоставленный вызывающим объектом в качестве аргументов.

state

Object

Объект, представляющий данные, используемые действием продолжения.

scheduler

TaskScheduler

Связь TaskScheduler с задачей продолжения и использование для ее выполнения.

Возвращаемое значение

Task

Новое продолжение Task.

Исключения

ArgumentNullException

Аргумент scheduler имеет значение null.

Комментарии

Возвращенный Task объект не будет запланирован на выполнение до тех пор, пока текущая задача не завершится, будет ли выполнена из-за успешного выполнения, сбоя из-за необработанного исключения или выхода из-за отмены из-за отмены.

См. также раздел

• Построение цепочек задач с помощью задач продолжения

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

Исходный код:

Future.cs

Создает продолжение, которое выполняется при завершении целевого объекта 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

Параметры

continuationAction

Action<Task<TResult>,Object>

Действие, выполняемое после Task<TResult> завершения. При выполнении делегат передает завершенную задачу и объект состояния, предоставленный вызывающим объектом в качестве аргументов.

state

Object

Объект, представляющий данные, используемые действием продолжения.

continuationOptions

TaskContinuationOptions

Параметры, когда продолжение запланировано и как оно ведет себя. К ним относятся такие критерии, как, например OnlyOnCanceled, параметры выполнения, например ExecuteSynchronously.

Возвращаемое значение

Task

Новое продолжение Task.

Исключения

ArgumentNullException

Аргумент continuationAction имеет значение null.

ArgumentOutOfRangeException

Аргумент continuationOptions задает недопустимое значение для TaskContinuationOptions.

Комментарии

Возвращаемый Task объект не будет запланирован на выполнение до завершения текущей задачи. Если критерии продолжения, указанные с помощью continuationOptions параметра, не выполнены, задача продолжения будет отменена вместо запланированной.

См. также раздел

• Построение цепочек задач с помощью задач продолжения

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

Исходный код:

Future.cs

Создает продолжение, которое выполняется при завершении целевого объекта 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

Параметры

continuationAction

Action<Task<TResult>,Object>

Действие, выполняемое после Task<TResult> завершения. При выполнении делегат передает завершенную задачу и объект состояния, предоставленный вызывающим объектом в качестве аргументов.

state

Object

Объект, представляющий данные, используемые действием продолжения.

cancellationToken

CancellationToken

Эта CancellationToken задача будет назначена новой задаче продолжения.

Возвращаемое значение

Task

Новое продолжение Task.

Исключения

ArgumentNullException

Аргумент continuationAction имеет значение null.

ObjectDisposedException

Предоставленные CancellationToken уже удалены.

Комментарии

Возвращенный Task объект не будет запланирован на выполнение до тех пор, пока текущая задача не завершится, будет ли выполнена из-за успешного выполнения, сбоя из-за необработанного исключения или выхода из-за отмены из-за отмены.

См. также раздел

• Построение цепочек задач с помощью задач продолжения

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

Исходный код:

Future.cs

Создает продолжение, которое выполняется в соответствии с условием, указанным в 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

Параметры

continuationAction

Action<Task<TResult>>

Действие, выполняемое в соответствии с условием, указанным в continuationOptions. При выполнении делегат будет передан завершенной задаче в качестве аргумента.

cancellationToken

CancellationToken

Эта CancellationToken задача будет назначена новой задаче продолжения.

continuationOptions

TaskContinuationOptions

Параметры, когда продолжение запланировано и как оно ведет себя. К ним относятся такие критерии, как, например OnlyOnCanceled, параметры выполнения, например ExecuteSynchronously.

scheduler

TaskScheduler

Связь TaskScheduler с задачей продолжения и использование для ее выполнения.

Возвращаемое значение

Task

Новое продолжение Task.

Исключения

ObjectDisposedException

Он Task<TResult> был удален.

–или–

Созданный CancellationTokenSource объект cancellationToken уже удален.

ArgumentNullException

Аргумент continuationAction имеет значение null.

–или–

Аргумент scheduler имеет значение null.

ArgumentOutOfRangeException

Аргумент continuationOptions задает недопустимое значение для TaskContinuationOptions.

Комментарии

Возвращаемый Task объект не будет запланирован на выполнение до завершения текущей задачи. Если критерии, указанные в параметре continuationOptions , не выполнены, задача продолжения будет отменена вместо запланированной. Дополнительные сведения см. в теме Связывание задач с использованием задач-продолжений.

См. также раздел

• Библиотека параллельных задач (TPL)
• Асинхронное программирование на основе задач
• Построение цепочек задач с помощью задач продолжения

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

Исходный код:

Future.cs

Создает продолжение, которое выполняется в соответствии с условием, указанным в 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

Параметры

continuationAction

Action<Task<TResult>>

Действие в соответствии с условием, указанным в continuationOptions. При выполнении делегат будет передан завершенной задаче в качестве аргумента.

continuationOptions

TaskContinuationOptions

Параметры, когда продолжение запланировано и как оно ведет себя. К ним относятся такие критерии, как, например OnlyOnCanceled, параметры выполнения, например ExecuteSynchronously.

Возвращаемое значение

Task

Новое продолжение Task.

Исключения

ObjectDisposedException

Он Task<TResult> был удален.

ArgumentNullException

Аргумент continuationAction имеет значение null.

ArgumentOutOfRangeException

Аргумент continuationOptions задает недопустимое значение для TaskContinuationOptions.

Комментарии

Возвращаемый Task объект не будет запланирован на выполнение до завершения текущей задачи. Если критерии продолжения, указанные с помощью continuationOptions параметра, не выполнены, задача продолжения будет отменена вместо запланированной.

Дополнительные сведения см. в теме Связывание задач с использованием задач-продолжений.

См. также раздел

• Библиотека параллельных задач (TPL)
• Асинхронное программирование на основе задач
• Построение цепочек задач с помощью задач продолжения

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

Исходный код:

Future.cs

Создает отменяемое продолжение, которое выполняется асинхронно при завершении целевого объекта 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

Параметры

continuationAction

Action<Task<TResult>>

Действие, выполняемое после Task<TResult> завершения. При выполнении делегат передает завершенную задачу в качестве аргумента.

cancellationToken

CancellationToken

Маркер отмены, переданный новой задаче продолжения.

Возвращаемое значение

Task

Новая задача продолжения.

Исключения

ObjectDisposedException

Он Task<TResult> был удален.

–или–

Созданный CancellationTokenSource объект cancellationToken был удален.

ArgumentNullException

Аргумент continuationAction имеет значение null.

Примеры

В следующем примере создается предвидеющая задача, которая использует Sieve eratosthenes для вычисления простых чисел от 1 до значения, введенного пользователем. Массив используется для хранения сведений о простых числах. Индекс массива представляет число, а значение элемента указывает, является ли это число составным (его значением true) или прайм (его значение равно false). Затем эта задача передается в задачу продолжения, которая отвечает за извлечение простых чисел из целочисленного массива и их отображение.

Маркер отмены передается как объекту, так и задаче продолжения. Объект System.Timers.Timer используется для определения значения времени ожидания в 100 миллисекундах. Если событие срабатывает, CancellationTokenSource.Cancel вызывается метод и маркер отмены используется для запроса отмены задач.

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] ) {
                                      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] )
                                                        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.

Как правило, при предоставлении значения около 100 000 приводит к истечению интервала времени ожидания, а Timer.Elapsed событие срабатывает, а запрос на отмену будет задан.

Комментарии

Возвращенный Task объект не будет запланирован на выполнение до тех пор, пока текущая задача не завершится, будет ли выполнена из-за успешного выполнения, сбоя из-за необработанного исключения или выхода из-за отмены из-за отмены.

См. также раздел

• Библиотека параллельных задач (TPL)
• Асинхронное программирование на основе задач
• Построение цепочек задач с помощью задач продолжения

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

Исходный код:

Future.cs

Создает продолжение, которое передает сведения о состоянии и выполняется при завершении целевого объекта 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

Параметры

continuationAction

Action<Task<TResult>,Object>

Действие, выполняемое после Task<TResult> завершения. При выполнении делегат передает завершенную задачу и объект состояния, предоставленный вызывающим объектом в качестве аргументов.

state

Object

Объект, представляющий данные, используемые действием продолжения.

Возвращаемое значение

Task

Новое продолжение Task.

Исключения

ArgumentNullException

Аргумент continuationAction имеет значение null.

Примеры

В следующем примере создается задача, которая передает целое число от 2 до 20 и возвращает массив, содержащий первые десять экспонентов (от n¹ до n¹⁰) этого числа. Затем задача продолжения отвечает за отображение экспонентов. Он передается как отступ, так и исходное число, экспоненты которого генерирует атекедент.

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

Комментарии

Возвращенный Task объект не будет запланирован на выполнение до тех пор, пока текущая задача не завершится, будет ли выполнена из-за успешного выполнения, сбоя из-за необработанного исключения или выхода из-за отмены из-за отмены.

См. также раздел

• Построение цепочек задач с помощью задач продолжения

ContinueWith(Action<Task<TResult>>)

Исходный код:

Future.cs

Создает продолжение, которое выполняется асинхронно при завершении целевой задачи.

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

Параметры

continuationAction

Action<Task<TResult>>

Действие, выполняемое при завершении отступа Task<TResult> . При выполнении делегат будет передан завершенной задаче в качестве аргумента.

Возвращаемое значение

Task

Новая задача продолжения.

Исключения

ObjectDisposedException

Он Task<TResult> был удален.

ArgumentNullException

Аргумент continuationAction имеет значение null.

Примеры

В следующем примере создается предвидеющая задача, которая использует Sieve eratosthenes для вычисления простых чисел от 1 до значения, введенного пользователем. Массив используется для хранения сведений о простых числах. Индекс массива представляет число, а значение элемента указывает, является ли это число составным (его значением true) или прайм (его значение равно false). Затем эта задача передается в задачу продолжения, которая отвечает за извлечение простых чисел из целочисленного массива и их отображение.

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]) {
                                      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])
                                                        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.

Комментарии

Возвращенный Task объект не будет запланирован на выполнение до тех пор, пока текущая задача не завершится, будет ли выполнена из-за успешного выполнения, сбоя из-за необработанного исключения или выхода из-за отмены.

См. также раздел

• Библиотека параллельных задач (TPL)
• Асинхронное программирование на основе задач
• Построение цепочек задач с помощью задач продолжения

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

Исходный код:

Future.cs

Создает продолжение, которое выполняется асинхронно при завершении целевого объекта 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

Параметры

continuationAction

Action<Task<TResult>>

Действие, выполняемое после Task<TResult> завершения. При выполнении делегат будет передан завершенной задаче в качестве аргумента.

scheduler

TaskScheduler

Связь TaskScheduler с задачей продолжения и использование для ее выполнения.

Возвращаемое значение

Task

Новое продолжение Task.

Исключения

ObjectDisposedException

Он Task<TResult> был удален.

ArgumentNullException

Аргумент continuationAction имеет значение null.

–или–

Аргумент scheduler имеет значение null.

Комментарии

Возвращенный Task объект не будет запланирован на выполнение до тех пор, пока текущая задача не завершится, будет ли выполнена из-за успешного выполнения, сбоя из-за необработанного исключения или выхода из-за отмены из-за отмены.

См. также раздел

• Библиотека параллельных задач (TPL)
• Асинхронное программирование на основе задач
• Построение цепочек задач с помощью задач продолжения

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

Исходный код:

Future.cs

Создает продолжение, которое выполняется при завершении целевого объекта 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)

Параметры типа

TNewResult

Тип результата, созданного продолжением.

Параметры

continuationFunction

Func<Task<TResult>,Object,TNewResult>

Функция, выполняемая после Task<TResult> завершения. При выполнении делегат передает завершенную задачу и объект состояния, предоставленный вызывающим объектом в качестве аргументов.

state

Object

Объект, представляющий данные, используемые функцией продолжения.

cancellationToken

CancellationToken

Это CancellationToken будет назначено новой задаче.

continuationOptions

TaskContinuationOptions

Параметры, когда продолжение запланировано и как оно ведет себя. К ним относятся такие критерии, как, например OnlyOnCanceled, параметры выполнения, например ExecuteSynchronously.

scheduler

TaskScheduler

Связь TaskScheduler с задачей продолжения и использование для ее выполнения.

Возвращаемое значение

Task<TNewResult>

Новое продолжение Task<TResult>.

Исключения

ArgumentNullException

Аргумент scheduler имеет значение null.

ArgumentOutOfRangeException

Аргумент continuationOptions задает недопустимое значение для TaskContinuationOptions.

ObjectDisposedException

Предоставленные CancellationToken уже удалены.

Комментарии

Возвращенный Task<TResult> объект не будет запланирован на выполнение до тех пор, пока текущая задача не завершится, будет ли выполнена из-за успешного выполнения, сбоя из-за необработанного исключения или выхода из-за отмены из-за отмены.

Значение continuationFunction, когда выполняется, должно возвращать Task<TResult>значение . Состояние завершения этой задачи будет передано задаче, возвращенной Task<TResult>.ContinueWith из вызова.

См. также раздел

• Построение цепочек задач с помощью задач продолжения

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

Исходный код:

Future.cs

Создает продолжение, которое выполняется в соответствии с условием, указанным в continuationOptions.

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)

Параметры типа

TNewResult

Тип результата, созданного продолжением.

Параметры

continuationFunction

Func<Task<TResult>,TNewResult>

Функция, выполняемая в соответствии с условием, указанным в continuationOptions.

При выполнении делегат будет передан в качестве аргумента этой завершенной задачи.

cancellationToken

CancellationToken

Это CancellationToken будет назначено новой задаче.

continuationOptions

TaskContinuationOptions

Параметры, когда продолжение запланировано и как оно ведет себя. К ним относятся такие критерии, как, например OnlyOnCanceled, параметры выполнения, например ExecuteSynchronously.

scheduler

TaskScheduler

Связь TaskScheduler с задачей продолжения и использование для ее выполнения.

Возвращаемое значение

Task<TNewResult>

Новое продолжение Task<TResult>.

Исключения

ObjectDisposedException

Он Task<TResult> был удален.

–или–

Созданный CancellationTokenSource объект cancellationToken уже удален.

ArgumentNullException

Аргумент continuationFunction имеет значение null.

–или–

Аргумент scheduler имеет значение null.

ArgumentOutOfRangeException

Аргумент continuationOptions задает недопустимое значение для TaskContinuationOptions.

Комментарии

Возвращенный Task<TResult> объект не будет запланирован на выполнение до тех пор, пока текущая задача не завершится, будет ли выполнена из-за успешного выполнения, сбоя из-за необработанного исключения или выхода из-за отмены из-за отмены.

Значение continuationFunction, когда выполняется, должно возвращать Task<TResult>значение .

См. также раздел

• Библиотека параллельных задач (TPL)
• Асинхронное программирование на основе задач
• Построение цепочек задач с помощью задач продолжения

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

Исходный код:

Future.cs

Создает продолжение, которое выполняется при завершении целевого объекта 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)

Параметры типа

TNewResult

Тип результата, созданного продолжением.

Параметры

continuationFunction

Func<Task<TResult>,Object,TNewResult>

Функция, выполняемая после Task<TResult> завершения. При выполнении делегат передает завершенную задачу и объект состояния, предоставленный вызывающим объектом в качестве аргументов.

state

Object

Объект, представляющий данные, используемые функцией продолжения.

scheduler

TaskScheduler

Связь TaskScheduler с задачей продолжения и использование для ее выполнения.

Возвращаемое значение

Task<TNewResult>

Новое продолжение Task<TResult>.

Исключения

ArgumentNullException

Аргумент scheduler имеет значение null.

Комментарии

Возвращенный Task<TResult> объект не будет запланирован на выполнение до тех пор, пока текущая задача не завершится, будет ли выполнена из-за успешного выполнения, сбоя из-за необработанного исключения или выхода из-за отмены из-за отмены.

См. также раздел

• Построение цепочек задач с помощью задач продолжения

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

Исходный код:

Future.cs

Создает продолжение, которое выполняется при завершении целевого объекта 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)

Параметры типа

TNewResult

Тип результата, созданного продолжением.

Параметры

continuationFunction

Func<Task<TResult>,Object,TNewResult>

Функция, выполняемая после Task<TResult> завершения. При выполнении делегат передает завершенную задачу и объект состояния, предоставленный вызывающим объектом в качестве аргументов.

state

Object

Объект, представляющий данные, используемые функцией продолжения.

cancellationToken

CancellationToken

Это CancellationToken будет назначено новой задаче.

Возвращаемое значение

Task<TNewResult>

Новое продолжение Task<TResult>.

Исключения

ArgumentNullException

Аргумент continuationFunction имеет значение null.

ObjectDisposedException

Предоставленные CancellationToken уже удалены.

Комментарии

Возвращенный Task<TResult> объект не будет запланирован на выполнение до тех пор, пока текущая задача не завершится, будет ли выполнена из-за успешного выполнения, сбоя из-за необработанного исключения или выхода из-за отмены из-за отмены.

См. также раздел

• Построение цепочек задач с помощью задач продолжения

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

Исходный код:

Future.cs

Создает продолжение, которое выполняется при завершении целевого объекта 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)

Параметры типа

TNewResult

Тип результата, созданного продолжением.

Параметры

continuationFunction

Func<Task<TResult>,Object,TNewResult>

Функция, выполняемая после Task<TResult> завершения. При выполнении делегат передает завершенную задачу и объект состояния, предоставленный вызывающим объектом в качестве аргументов.

state

Object

Объект, представляющий данные, используемые функцией продолжения.

continuationOptions

TaskContinuationOptions

Параметры, когда продолжение запланировано и как оно ведет себя. К ним относятся такие критерии, как, например OnlyOnCanceled, параметры выполнения, например ExecuteSynchronously.

Возвращаемое значение

Task<TNewResult>

Новое продолжение Task<TResult>.

Исключения

ArgumentNullException

Аргумент continuationFunction имеет значение null.

ArgumentOutOfRangeException

Аргумент continuationOptions задает недопустимое значение для TaskContinuationOptions.

Комментарии

Возвращенный Task<TResult> объект не будет запланирован на выполнение до тех пор, пока текущая задача не завершится, будет ли выполнена из-за успешного выполнения, сбоя из-за необработанного исключения или выхода из-за отмены из-за отмены.

Значение continuationFunction, когда выполняется, должно возвращать Task<TResult>значение . Состояние завершения этой задачи будет передано в задачу, возвращенную из вызова ContinueWith.

См. также раздел

• Построение цепочек задач с помощью задач продолжения

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

Исходный код:

Future.cs

Создает продолжение, которое выполняется в соответствии с условием, указанным в continuationOptions.

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)

Параметры типа

TNewResult

Тип результата, созданного продолжением.

Параметры

continuationFunction

Func<Task<TResult>,TNewResult>

Функция, выполняемая в соответствии с условием, указанным в continuationOptions.

При выполнении делегат будет передан завершенной задаче в качестве аргумента.

continuationOptions

TaskContinuationOptions

Параметры, когда продолжение запланировано и как оно ведет себя. К ним относятся такие критерии, как, например OnlyOnCanceled, параметры выполнения, например ExecuteSynchronously.

Возвращаемое значение

Task<TNewResult>

Новое продолжение Task<TResult>.

Исключения

ObjectDisposedException

Он Task<TResult> был удален.

ArgumentNullException

Аргумент continuationFunction имеет значение null.

ArgumentOutOfRangeException

Аргумент continuationOptions задает недопустимое значение для TaskContinuationOptions.

Комментарии

Возвращенный Task<TResult> объект не будет запланирован на выполнение до тех пор, пока текущая задача не завершится, будет ли выполнена из-за успешного выполнения, сбоя из-за необработанного исключения или выхода из-за отмены из-за отмены.

Значение continuationFunction, когда выполняется, должно возвращать Task<TResult>значение .

См. также раздел

• Библиотека параллельных задач (TPL)
• Асинхронное программирование на основе задач
• Построение цепочек задач с помощью задач продолжения

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

Исходный код:

Future.cs

Создает продолжение, которое выполняется асинхронно при завершении целевого объекта 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)

Параметры типа

TNewResult

Тип результата, созданного продолжением.

Параметры

continuationFunction

Func<Task<TResult>,TNewResult>

Функция, выполняемая после Task<TResult> завершения. При выполнении делегат будет передан завершенной задаче в качестве аргумента.

cancellationToken

CancellationToken

Это CancellationToken будет назначено новой задаче.

Возвращаемое значение

Task<TNewResult>

Новое продолжение Task<TResult>.

Исключения

ObjectDisposedException

Он Task<TResult> был удален.

–или–

Созданный CancellationTokenSource объект cancellationToken уже удален.

ArgumentNullException

Аргумент continuationFunction имеет значение null.

Комментарии

Возвращенный Task<TResult> объект не будет запланирован на выполнение до тех пор, пока текущая задача не завершится, будет ли выполнена из-за успешного выполнения, сбоя из-за необработанного исключения или выхода из-за отмены из-за отмены.

См. также раздел

• Библиотека параллельных задач (TPL)
• Асинхронное программирование на основе задач
• Построение цепочек задач с помощью задач продолжения

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

Исходный код:

Future.cs

Создает продолжение, которое выполняется при завершении целевого объекта 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)

Параметры типа

TNewResult

Тип результата, созданного продолжением.

Параметры

continuationFunction

Func<Task<TResult>,Object,TNewResult>

Функция, выполняемая после Task<TResult> завершения. При выполнении делегат передает завершенную задачу и объект состояния, предоставленный вызывающим объектом в качестве аргументов.

state

Object

Объект, представляющий данные, используемые функцией продолжения.

Возвращаемое значение

Task<TNewResult>

Новое продолжение Task<TResult>.

Исключения

ArgumentNullException

Аргумент continuationFunction имеет значение null.

Примеры

В следующем примере создается цепочка задач продолжения. Каждая задача предоставляет текущее время, DateTime объект для аргумента ContinueWith(Action<Task,Object>, Object) состояния метода. Каждое DateTime значение представляет время создания задачи продолжения. Каждая задача создает в качестве результата второе DateTime значение, представляющее время завершения задачи. После завершения всех задач в примере отображается дата и время начала и завершения каждой задачи продолжения.

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.

Комментарии

Возвращенный Task<TResult> объект не будет запланирован на выполнение до тех пор, пока текущая задача не завершится, будет ли выполнена из-за успешного выполнения, сбоя из-за необработанного исключения или выхода из-за отмены из-за отмены.

См. также раздел

• Построение цепочек задач с помощью задач продолжения

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

Исходный код:

Future.cs

Создает продолжение, которое выполняется асинхронно при завершении целевого объекта 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)

Параметры типа

TNewResult

Тип результата, созданного продолжением.

Параметры

continuationFunction

Func<Task<TResult>,TNewResult>

Функция, выполняемая после Task<TResult> завершения. При выполнении делегат будет передан завершенной задаче в качестве аргумента.

Возвращаемое значение

Task<TNewResult>

Новое продолжение Task<TResult>.

Исключения

ObjectDisposedException

Он Task<TResult> был удален.

ArgumentNullException

Аргумент continuationFunction имеет значение null.

Комментарии

Возвращенный Task<TResult> объект не будет запланирован на выполнение до тех пор, пока текущая задача не завершится, будет ли выполнена из-за успешного выполнения, сбоя из-за необработанного исключения или выхода из-за отмены из-за отмены.

См. также раздел

• Библиотека параллельных задач (TPL)
• Асинхронное программирование на основе задач
• Построение цепочек задач с помощью задач продолжения

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

Исходный код:

Future.cs

Создает продолжение, которое выполняется асинхронно при завершении целевого объекта 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)

Параметры типа

TNewResult

Тип результата, созданного продолжением.

Параметры

continuationFunction

Func<Task<TResult>,TNewResult>

Функция, выполняемая после Task<TResult> завершения. При выполнении делегат будет передан завершенной задаче в качестве аргумента.

scheduler

TaskScheduler

Связь TaskScheduler с задачей продолжения и использование для ее выполнения.

Возвращаемое значение

Task<TNewResult>

Новое продолжение Task<TResult>.

Исключения

ObjectDisposedException

Он Task<TResult> был удален.

ArgumentNullException

Аргумент continuationFunction имеет значение null.

–или–

Аргумент scheduler имеет значение null.

Комментарии

Возвращенный Task<TResult> объект не будет запланирован на выполнение до тех пор, пока текущая задача не завершится, будет ли выполнена из-за успешного выполнения, сбоя из-за необработанного исключения или выхода из-за отмены из-за отмены.

См. также раздел

• TaskScheduler
• Библиотека параллельных задач (TPL)
• Асинхронное программирование на основе задач
• Построение цепочек задач с помощью задач продолжения