Прочитать на английском

Поделиться через


Task<TResult>.ContinueWith Метод

Определение

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

Перегрузки

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
Исходный код:
Future.cs
Исходный код:
Future.cs

Создает продолжение, которое выполняется после завершения выполнения целевого объекта Task<TResult>.

C#
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);
C#
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);

Параметры

continuationAction
Action<Task<TResult>,Object>

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

state
Object

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

cancellationToken
CancellationToken

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

continuationOptions
TaskContinuationOptions

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

scheduler
TaskScheduler

Планировщик TaskScheduler, который следует связать с задачей продолжения и использовать для ее запуска.

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

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

Исключения

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

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

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

Комментарии

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

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

Применяется к

.NET 9 и другие версии
Продукт Версии
.NET Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 1.0, 1.1, 1.2, 1.3, 1.4, 1.6, 2.0, 2.1
UWP 10.0

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

Исходный код:
Future.cs
Исходный код:
Future.cs
Исходный код:
Future.cs

Создает продолжение, которое выполняется после завершения выполнения целевого объекта Task<TResult>.

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

Параметры

continuationAction
Action<Task<TResult>,Object>

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

state
Object

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

scheduler
TaskScheduler

Планировщик TaskScheduler, который следует связать с задачей продолжения и использовать для ее запуска.

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

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

Исключения

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

Комментарии

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

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

Применяется к

.NET 9 и другие версии
Продукт Версии
.NET Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 1.0, 1.1, 1.2, 1.3, 1.4, 1.6, 2.0, 2.1
UWP 10.0

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

Исходный код:
Future.cs
Исходный код:
Future.cs
Исходный код:
Future.cs

Создает продолжение, которое выполняется после завершения выполнения целевого объекта Task<TResult>.

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

Параметры

continuationAction
Action<Task<TResult>,Object>

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

state
Object

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

continuationOptions
TaskContinuationOptions

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

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

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

Исключения

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

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

Комментарии

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

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

Применяется к

.NET 9 и другие версии
Продукт Версии
.NET Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 1.0, 1.1, 1.2, 1.3, 1.4, 1.6, 2.0, 2.1
UWP 10.0

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

Исходный код:
Future.cs
Исходный код:
Future.cs
Исходный код:
Future.cs

Создает продолжение, которое выполняется после завершения выполнения целевого объекта Task<TResult>.

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

Параметры

continuationAction
Action<Task<TResult>,Object>

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

state
Object

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

cancellationToken
CancellationToken

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

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

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

Исключения

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

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

Комментарии

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

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

Применяется к

.NET 9 и другие версии
Продукт Версии
.NET Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 1.0, 1.1, 1.2, 1.3, 1.4, 1.6, 2.0, 2.1
UWP 10.0

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

Исходный код:
Future.cs
Исходный код:
Future.cs
Исходный код:
Future.cs

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

C#
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);

Параметры

continuationAction
Action<Task<TResult>>

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

cancellationToken
CancellationToken

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

continuationOptions
TaskContinuationOptions

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

scheduler
TaskScheduler

Планировщик TaskScheduler, который следует связать с задачей продолжения и использовать для ее запуска.

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

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

Исключения

Объект Task<TResult> удален.

-или-

Класс CancellationTokenSource, создавший cancellationToken, уже удален.

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

-или-

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

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

Комментарии

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

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

Применяется к

.NET 9 и другие версии
Продукт Версии
.NET Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 1.0, 1.1, 1.2, 1.3, 1.4, 1.6, 2.0, 2.1
UWP 10.0

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

Исходный код:
Future.cs
Исходный код:
Future.cs
Исходный код:
Future.cs

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

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

Параметры

continuationAction
Action<Task<TResult>>

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

continuationOptions
TaskContinuationOptions

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

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

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

Исключения

Объект Task<TResult> удален.

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

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

Комментарии

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

Подробнее см. в разделе Создание цепочки задач с помощью задач продолжения.

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

Применяется к

.NET 9 и другие версии
Продукт Версии
.NET Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 1.0, 1.1, 1.2, 1.3, 1.4, 1.6, 2.0, 2.1
UWP 10.0

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

Исходный код:
Future.cs
Исходный код:
Future.cs
Исходный код:
Future.cs

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

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

Параметры

continuationAction
Action<Task<TResult>>

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

cancellationToken
CancellationToken

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

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

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

Исключения

Объект Task<TResult> удален.

-или-

Класс CancellationTokenSource, создавший cancellationToken, уже удален.

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

Примеры

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

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

C#
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.

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

Комментарии

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

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

Применяется к

.NET 9 и другие версии
Продукт Версии
.NET Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 1.0, 1.1, 1.2, 1.3, 1.4, 1.6, 2.0, 2.1
UWP 10.0

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

Исходный код:
Future.cs
Исходный код:
Future.cs
Исходный код:
Future.cs

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

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

Параметры

continuationAction
Action<Task<TResult>,Object>

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

state
Object

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

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

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

Исключения

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

Примеры

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

C#
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

Комментарии

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

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

Применяется к

.NET 9 и другие версии
Продукт Версии
.NET Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 1.0, 1.1, 1.2, 1.3, 1.4, 1.6, 2.0, 2.1
UWP 10.0

ContinueWith(Action<Task<TResult>>)

Исходный код:
Future.cs
Исходный код:
Future.cs
Исходный код:
Future.cs

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

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

Параметры

continuationAction
Action<Task<TResult>>

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

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

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

Исключения

Объект Task<TResult> удален.

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

Примеры

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

C#
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

Комментарии

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

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

Применяется к

.NET 9 и другие версии
Продукт Версии
.NET Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 1.0, 1.1, 1.2, 1.3, 1.4, 1.6, 2.0, 2.1
UWP 10.0

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

Исходный код:
Future.cs
Исходный код:
Future.cs
Исходный код:
Future.cs

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

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

Параметры

continuationAction
Action<Task<TResult>>

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

scheduler
TaskScheduler

Планировщик TaskScheduler, который следует связать с задачей продолжения и использовать для ее запуска.

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

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

Исключения

Объект Task<TResult> удален.

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

-или-

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

Комментарии

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

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

Применяется к

.NET 9 и другие версии
Продукт Версии
.NET Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 1.0, 1.1, 1.2, 1.3, 1.4, 1.6, 2.0, 2.1
UWP 10.0

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

Исходный код:
Future.cs
Исходный код:
Future.cs
Исходный код:
Future.cs

Создает продолжение, которое выполняется после завершения выполнения целевого объекта Task<TResult>.

C#
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);
C#
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);

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

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>.

Исключения

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

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

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

Комментарии

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

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

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

Применяется к

.NET 9 и другие версии
Продукт Версии
.NET Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 1.0, 1.1, 1.2, 1.3, 1.4, 1.6, 2.0, 2.1
UWP 10.0

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

Исходный код:
Future.cs
Исходный код:
Future.cs
Исходный код:
Future.cs

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

C#
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);

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

TNewResult

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

Параметры

continuationFunction
Func<Task<TResult>,TNewResult>

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

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

cancellationToken
CancellationToken

Токен CancellationToken, который будет назначен новой задаче.

continuationOptions
TaskContinuationOptions

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

scheduler
TaskScheduler

Планировщик TaskScheduler, который следует связать с задачей продолжения и использовать для ее запуска.

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

Task<TNewResult>

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

Исключения

Объект Task<TResult> удален.

-или-

Класс CancellationTokenSource, создавший cancellationToken, уже удален.

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

-или-

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

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

Комментарии

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

При continuationFunctionвыполнении должен возвращать Task<TResult>.

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

Применяется к

.NET 9 и другие версии
Продукт Версии
.NET Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 1.0, 1.1, 1.2, 1.3, 1.4, 1.6, 2.0, 2.1
UWP 10.0

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

Исходный код:
Future.cs
Исходный код:
Future.cs
Исходный код:
Future.cs

Создает продолжение, которое выполняется после завершения выполнения целевого объекта Task<TResult>.

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

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

TNewResult

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

Параметры

continuationFunction
Func<Task<TResult>,Object,TNewResult>

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

state
Object

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

scheduler
TaskScheduler

Планировщик TaskScheduler, который следует связать с задачей продолжения и использовать для ее запуска.

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

Task<TNewResult>

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

Исключения

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

Комментарии

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

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

Применяется к

.NET 9 и другие версии
Продукт Версии
.NET Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 1.0, 1.1, 1.2, 1.3, 1.4, 1.6, 2.0, 2.1
UWP 10.0

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

Исходный код:
Future.cs
Исходный код:
Future.cs
Исходный код:
Future.cs

Создает продолжение, которое выполняется после завершения выполнения целевого объекта Task<TResult>.

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

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

TNewResult

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

Параметры

continuationFunction
Func<Task<TResult>,Object,TNewResult>

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

state
Object

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

cancellationToken
CancellationToken

Токен CancellationToken, который будет назначен новой задаче.

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

Task<TNewResult>

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

Исключения

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

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

Комментарии

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

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

Применяется к

.NET 9 и другие версии
Продукт Версии
.NET Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 1.0, 1.1, 1.2, 1.3, 1.4, 1.6, 2.0, 2.1
UWP 10.0

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

Исходный код:
Future.cs
Исходный код:
Future.cs
Исходный код:
Future.cs

Создает продолжение, которое выполняется после завершения выполнения целевого объекта Task<TResult>.

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

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

TNewResult

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

Параметры

continuationFunction
Func<Task<TResult>,Object,TNewResult>

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

state
Object

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

continuationOptions
TaskContinuationOptions

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

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

Task<TNewResult>

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

Исключения

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

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

Комментарии

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

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

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

Применяется к

.NET 9 и другие версии
Продукт Версии
.NET Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 1.0, 1.1, 1.2, 1.3, 1.4, 1.6, 2.0, 2.1
UWP 10.0

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

Исходный код:
Future.cs
Исходный код:
Future.cs
Исходный код:
Future.cs

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

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

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

TNewResult

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

Параметры

continuationFunction
Func<Task<TResult>,TNewResult>

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

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

continuationOptions
TaskContinuationOptions

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

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

Task<TNewResult>

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

Исключения

Объект Task<TResult> удален.

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

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

Комментарии

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

При continuationFunctionвыполнении должен возвращать Task<TResult>.

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

Применяется к

.NET 9 и другие версии
Продукт Версии
.NET Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 1.0, 1.1, 1.2, 1.3, 1.4, 1.6, 2.0, 2.1
UWP 10.0

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

Исходный код:
Future.cs
Исходный код:
Future.cs
Исходный код:
Future.cs

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

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

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

TNewResult

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

Параметры

continuationFunction
Func<Task<TResult>,TNewResult>

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

cancellationToken
CancellationToken

Токен CancellationToken, который будет назначен новой задаче.

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

Task<TNewResult>

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

Исключения

Объект Task<TResult> удален.

-или-

Класс CancellationTokenSource, создавший cancellationToken, уже удален.

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

Комментарии

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

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

Применяется к

.NET 9 и другие версии
Продукт Версии
.NET Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 1.0, 1.1, 1.2, 1.3, 1.4, 1.6, 2.0, 2.1
UWP 10.0

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

Исходный код:
Future.cs
Исходный код:
Future.cs
Исходный код:
Future.cs

Создает продолжение, которое выполняется после завершения выполнения целевого объекта Task<TResult>.

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

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

TNewResult

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

Параметры

continuationFunction
Func<Task<TResult>,Object,TNewResult>

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

state
Object

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

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

Task<TNewResult>

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

Исключения

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

Примеры

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

C#
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.
*/

Комментарии

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

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

Применяется к

.NET 9 и другие версии
Продукт Версии
.NET Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 1.0, 1.1, 1.2, 1.3, 1.4, 1.6, 2.0, 2.1
UWP 10.0

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

Исходный код:
Future.cs
Исходный код:
Future.cs
Исходный код:
Future.cs

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

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

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

TNewResult

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

Параметры

continuationFunction
Func<Task<TResult>,TNewResult>

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

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

Task<TNewResult>

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

Исключения

Объект Task<TResult> удален.

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

Комментарии

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

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

Применяется к

.NET 9 и другие версии
Продукт Версии
.NET Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 1.0, 1.1, 1.2, 1.3, 1.4, 1.6, 2.0, 2.1
UWP 10.0

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

Исходный код:
Future.cs
Исходный код:
Future.cs
Исходный код:
Future.cs

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

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

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

TNewResult

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

Параметры

continuationFunction
Func<Task<TResult>,TNewResult>

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

scheduler
TaskScheduler

Планировщик TaskScheduler, который следует связать с задачей продолжения и использовать для ее запуска.

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

Task<TNewResult>

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

Исключения

Объект Task<TResult> удален.

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

-или-

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

Комментарии

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

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

Применяется к

.NET 9 и другие версии
Продукт Версии
.NET Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 1.0, 1.1, 1.2, 1.3, 1.4, 1.6, 2.0, 2.1
UWP 10.0