Task<TResult>.ContinueWith Método

Definición

Espacio de nombres:

System.Threading.Tasks

Ensamblado:

System.Runtime.dll

Crea una tarea de continuación que se ejecuta cuando se completa otra tarea.

Sobrecargas

ContinueWith(Action<Task<TResult>,Object>, Object, CancellationToken, TaskContinuationOptions, TaskScheduler)	Crea una continuación que se ejecuta cuando se completa el objeto Task<TResult> de destino.
ContinueWith(Action<Task<TResult>,Object>, Object, TaskScheduler)	Crea una continuación que se ejecuta cuando se completa el objeto Task<TResult> de destino.
ContinueWith(Action<Task<TResult>,Object>, Object, TaskContinuationOptions)	Crea una continuación que se ejecuta cuando se completa el objeto Task<TResult> de destino.
ContinueWith(Action<Task<TResult>,Object>, Object, CancellationToken)	Crea una continuación que se ejecuta cuando se completa el objeto Task<TResult> de destino.
ContinueWith(Action<Task<TResult>>, CancellationToken, TaskContinuationOptions, TaskScheduler)	Crea una continuación que se ejecuta según la condición especificada en continuationOptions.
ContinueWith(Action<Task<TResult>>, TaskContinuationOptions)	Crea una continuación que se ejecuta según la condición especificada en continuationOptions.
ContinueWith(Action<Task<TResult>>, CancellationToken)	Crea una continuación que se puede cancelar y se ejecuta de forma asincrónica al completarse el parámetro Task<TResult> de destino.
ContinueWith(Action<Task<TResult>,Object>, Object)	Crea una continuación a la que se pasa información de estado y que se ejecuta cuando el objeto Task<TResult> de destino se completa.
ContinueWith(Action<Task<TResult>>)	Crea una continuación que se ejecuta de manera asincrónica cuando se completa la tarea de destino.
ContinueWith(Action<Task<TResult>>, TaskScheduler)	Crea una continuación que se ejecuta de manera asincrónica cuando se completa el objeto Task<TResult> de destino.
ContinueWith<TNewResult>(Func<Task<TResult>,Object,TNewResult>, Object, CancellationToken, TaskContinuationOptions, TaskScheduler)	Crea una continuación que se ejecuta cuando se completa el objeto Task<TResult> de destino.
ContinueWith<TNewResult>(Func<Task<TResult>,TNewResult>, CancellationToken, TaskContinuationOptions, TaskScheduler)	Crea una continuación que se ejecuta según la condición especificada en continuationOptions.
ContinueWith<TNewResult>(Func<Task<TResult>,Object,TNewResult>, Object, TaskScheduler)	Crea una continuación que se ejecuta cuando se completa el objeto Task<TResult> de destino.
ContinueWith<TNewResult>(Func<Task<TResult>,Object,TNewResult>, Object, CancellationToken)	Crea una continuación que se ejecuta cuando se completa el objeto Task<TResult> de destino.
ContinueWith<TNewResult>(Func<Task<TResult>,Object,TNewResult>, Object, TaskContinuationOptions)	Crea una continuación que se ejecuta cuando se completa el objeto Task<TResult> de destino.
ContinueWith<TNewResult>(Func<Task<TResult>,TNewResult>, TaskContinuationOptions)	Crea una continuación que se ejecuta según la condición especificada en continuationOptions.
ContinueWith<TNewResult>(Func<Task<TResult>,TNewResult>, CancellationToken)	Crea una continuación que se ejecuta de manera asincrónica cuando se completa el objeto Task<TResult> de destino.
ContinueWith<TNewResult>(Func<Task<TResult>,Object,TNewResult>, Object)	Crea una continuación que se ejecuta cuando se completa el objeto Task<TResult> de destino.
ContinueWith<TNewResult>(Func<Task<TResult>,TNewResult>)	Crea una continuación que se ejecuta de manera asincrónica cuando se completa el objeto Task<TResult> de destino.
ContinueWith<TNewResult>(Func<Task<TResult>,TNewResult>, TaskScheduler)	Crea una continuación que se ejecuta de manera asincrónica cuando se completa el objeto Task<TResult> de destino.

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

Source:

Future.cs

Crea una continuación que se ejecuta cuando se completa el objeto Task<TResult> de destino.

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

Parámetros

continuationAction

Action<Task<TResult>,Object>

Acción que se va a ejecutar cuando se complete el objeto Task<TResult>. Cuando se ejecute, se pasarán al delegado la tarea completada y el objeto de estado proporcionado por el llamador como argumentos.

state

Object

Objeto que representa los datos que la acción de continuación va a usar.

cancellationToken

CancellationToken

El CancellationToken que se asignará a la nueva tarea de continuación.

continuationOptions

TaskContinuationOptions

Opciones para la programación y el comportamiento de la continuación. Incluye criterios, como OnlyOnCanceled, y opciones de ejecución, como ExecuteSynchronously.

scheduler

TaskScheduler

Objeto TaskScheduler que se va a asociar a la tarea de continuación y se va a usar para su ejecución.

Devoluciones

Task

Nuevo objeto Task de continuación.

Excepciones

ArgumentNullException

El argumento scheduler es null.

ArgumentOutOfRangeException

El argumento continuationOptions especifica un valor no válido para TaskContinuationOptions.

ObjectDisposedException

Ya se eliminó el CancellationToken proporcionado.

Comentarios

El devuelto Task no se programará para su ejecución hasta que se haya completado la tarea actual. Si no se cumplen los criterios especificados a través del continuationOptions parámetro , la tarea de continuación se cancelará en lugar de programada.

Consulte también

• Encadenar tareas mediante tareas de continuación

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

Source:

Future.cs

Crea una continuación que se ejecuta cuando se completa el objeto Task<TResult> de destino.

C#

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

Parámetros

continuationAction

Action<Task<TResult>,Object>

Acción que se va a ejecutar cuando se complete el objeto Task<TResult>. Cuando se ejecute, se pasarán al delegado la tarea completada y el objeto de estado proporcionado por el llamador como argumentos.

state

Object

Objeto que representa los datos que la acción de continuación va a usar.

scheduler

TaskScheduler

Objeto TaskScheduler que se va a asociar a la tarea de continuación y se va a usar para su ejecución.

Devoluciones

Task

Nuevo objeto Task de continuación.

Excepciones

ArgumentNullException

El argumento scheduler es null.

Comentarios

El devuelto Task no se programará para su ejecución hasta que se haya completado la tarea actual, independientemente de si se completa debido a la ejecución correcta, a errores debido a una excepción no controlada o a la salida anticipada debido a que se canceló.

Consulte también

• Encadenar tareas mediante tareas de continuación

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

Source:

Future.cs

Crea una continuación que se ejecuta cuando se completa el objeto Task<TResult> de destino.

C#

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

Parámetros

continuationAction

Action<Task<TResult>,Object>

Acción que se va a ejecutar cuando se complete el objeto Task<TResult>. Cuando se ejecute, se pasarán al delegado la tarea completada y el objeto de estado proporcionado por el llamador como argumentos.

state

Object

Objeto que representa los datos que la acción de continuación va a usar.

continuationOptions

TaskContinuationOptions

Opciones para la programación y el comportamiento de la continuación. Incluye criterios, como OnlyOnCanceled, y opciones de ejecución, como ExecuteSynchronously.

Devoluciones

Task

Nuevo objeto Task de continuación.

Excepciones

ArgumentNullException

El argumento continuationAction es null.

ArgumentOutOfRangeException

El argumento continuationOptions especifica un valor no válido para TaskContinuationOptions.

Comentarios

El devuelto Task no se programará para su ejecución hasta que se haya completado la tarea actual. Si no se cumplen los criterios de continuación especificados a través del continuationOptions parámetro , la tarea de continuación se cancelará en lugar de programada.

Consulte también

• Encadenar tareas mediante tareas de continuación

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

Source:

Future.cs

Crea una continuación que se ejecuta cuando se completa el objeto Task<TResult> de destino.

C#

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

Parámetros

continuationAction

Action<Task<TResult>,Object>

Acción que se va a ejecutar cuando se complete el objeto Task<TResult>. Cuando se ejecute, se pasarán al delegado la tarea completada y el objeto de estado proporcionado por el llamador como argumentos.

state

Object

Objeto que representa los datos que la acción de continuación va a usar.

cancellationToken

CancellationToken

El CancellationToken que se asignará a la nueva tarea de continuación.

Devoluciones

Task

Nuevo objeto Task de continuación.

Excepciones

ArgumentNullException

El argumento continuationAction es null.

ObjectDisposedException

Ya se eliminó el CancellationToken proporcionado.

Comentarios

El devuelto Task no se programará para su ejecución hasta que se haya completado la tarea actual, independientemente de si se completa debido a la ejecución correcta, a errores debido a una excepción no controlada o a la salida anticipada debido a que se canceló.

Consulte también

• Encadenar tareas mediante tareas de continuación

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

Source:

Future.cs

Crea una continuación que se ejecuta según la condición especificada en 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);

Parámetros

continuationAction

Action<Task<TResult>>

Una acción que se ejecuta según la condición especificada en continuationOptions. Cuando se ejecute, al delegado se le pasará la tarea completada como un argumento.

cancellationToken

CancellationToken

El CancellationToken que se asignará a la nueva tarea de continuación.

continuationOptions

TaskContinuationOptions

Opciones para la programación y el comportamiento de la continuación. Incluye criterios, como OnlyOnCanceled, y opciones de ejecución, como ExecuteSynchronously.

scheduler

TaskScheduler

Objeto TaskScheduler que se va a asociar a la tarea de continuación y se va a usar para su ejecución.

Devoluciones

Task

Nuevo objeto Task de continuación.

Excepciones

ObjectDisposedException

Se ha eliminado Task<TResult>.

o bien

El CancellationTokenSource que creó cancellationToken ya se ha eliminado.

ArgumentNullException

El argumento continuationAction es null.

o bien

El argumento scheduler es null.

ArgumentOutOfRangeException

El argumento continuationOptions especifica un valor no válido para TaskContinuationOptions.

Comentarios

El devuelto Task no se programará para su ejecución hasta que se haya completado la tarea actual. Si no se cumplen los criterios especificados a través del continuationOptions parámetro , la tarea de continuación se cancelará en lugar de programada. Para más información, consulte Encadenar tareas mediante tareas de continuación.

Consulte también

• Biblioteca TPL
• Programación asincrónica basada en tareas
• Encadenar tareas mediante tareas de continuación

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

Source:

Future.cs

Crea una continuación que se ejecuta según la condición especificada en continuationOptions.

C#

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

Parámetros

continuationAction

Action<Task<TResult>>

Una acción según la condición especificada en continuationOptions. Cuando se ejecute, al delegado se le pasará la tarea completada como un argumento.

continuationOptions

TaskContinuationOptions

Opciones para la programación y el comportamiento de la continuación. Incluye criterios, como OnlyOnCanceled, y opciones de ejecución, como ExecuteSynchronously.

Devoluciones

Task

Nuevo objeto Task de continuación.

Excepciones

ObjectDisposedException

Se ha eliminado Task<TResult>.

ArgumentNullException

El argumento continuationAction es null.

ArgumentOutOfRangeException

El argumento continuationOptions especifica un valor no válido para TaskContinuationOptions.

Comentarios

El devuelto Task no se programará para su ejecución hasta que se haya completado la tarea actual. Si no se cumplen los criterios de continuación especificados a través del continuationOptions parámetro , la tarea de continuación se cancelará en lugar de programada.

Para más información, consulte Encadenar tareas mediante tareas de continuación.

Consulte también

• Biblioteca TPL
• Programación asincrónica basada en tareas
• Encadenar tareas mediante tareas de continuación

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

Source:

Future.cs

Crea una continuación que se puede cancelar y se ejecuta de forma asincrónica al completarse el parámetro Task<TResult> de destino.

C#

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

Parámetros

continuationAction

Action<Task<TResult>>

Acción que se va a ejecutar cuando se complete el objeto Task<TResult>. Cuando se ejecuta, se pasa la tarea completada al delegado como argumento.

cancellationToken

CancellationToken

Token de cancelación que se pasa a la nueva tarea de continuación.

Devoluciones

Task

Una tarea de continuación nueva.

Excepciones

ObjectDisposedException

Se ha eliminado Task<TResult>.

o bien

Se ha eliminado el CancellationTokenSource que ha creado cancellationToken.

ArgumentNullException

El argumento continuationAction es null.

Ejemplos

En el ejemplo siguiente se crea una tarea antecedente que usa el Sieve de Eratosthenes para calcular los números primos entre 1 y un valor especificado por el usuario. Una matriz se usa para contener información sobre los números primos. El índice de matriz representa el número y el valor del elemento indica si ese número está compuesto (su valor es true) o primo (su valor es false). A continuación, esta tarea se pasa a una tarea de continuación, que es responsable de extraer los números primos de la matriz de enteros y mostrarlos.

Se pasa un token de cancelación tanto al antecedente como a la tarea de continuación. Un System.Timers.Timer objeto se usa para definir un valor de tiempo de espera de 100 milisegundos. Si el evento se desencadena, se llama al CancellationTokenSource.Cancel método y el token de cancelación se usa para solicitar la cancelación de las tareas.

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.

Normalmente, proporcionar un valor de aproximadamente 100 000 hace que el intervalo de tiempo de espera expire y el Timer.Elapsed evento se active y se establezca la solicitud de cancelación.

Comentarios

El devuelto Task no se programará para su ejecución hasta que se haya completado la tarea actual, independientemente de si se completa debido a la ejecución correcta, a errores debido a una excepción no controlada o a la salida anticipada debido a que se canceló.

Consulte también

• Biblioteca TPL
• Programación asincrónica basada en tareas
• Encadenar tareas mediante tareas de continuación

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

Source:

Future.cs

Crea una continuación a la que se pasa información de estado y que se ejecuta cuando el objeto Task<TResult> de destino se completa.

C#

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

Parámetros

continuationAction

Action<Task<TResult>,Object>

Acción que se va a ejecutar cuando se complete el objeto Task<TResult>. Cuando se ejecuta, el delegado se pasa la tarea completada y el objeto de estado proporcionado por el autor de la llamada como argumentos.

state

Object

Objeto que representa los datos que la acción de continuación va a usar.

Devoluciones

Task

Nuevo objeto Task de continuación.

Excepciones

ArgumentNullException

El argumento continuationAction es null.

Ejemplos

En el ejemplo siguiente se crea una tarea que se pasa un entero entre 2 y 20 y se devuelve una matriz que contiene los diez primeros exponentes (de n¹ a^{n 10}) de ese número. Después, una tarea de continuación es responsable de mostrar los exponentes. Se pasa tanto el antecedente como el número original cuyos exponentes genera el antecedente.

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

Comentarios

El devuelto Task no se programará para su ejecución hasta que se haya completado la tarea actual, independientemente de si se completa debido a la ejecución correcta, a errores debido a una excepción no controlada o a la salida anticipada debido a que se canceló.

Consulte también

• Encadenar tareas mediante tareas de continuación

ContinueWith(Action<Task<TResult>>)

Source:

Future.cs

Crea una continuación que se ejecuta de manera asincrónica cuando se completa la tarea de destino.

C#

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

Parámetros

continuationAction

Action<Task<TResult>>

Una acción que se ejecuta cuando se completa el Task<TResult> antecedente. Cuando se ejecute, al delegado se le pasará la tarea completada como un argumento.

Devoluciones

Task

Una tarea de continuación nueva.

Excepciones

ObjectDisposedException

Se ha eliminado Task<TResult>.

ArgumentNullException

El argumento continuationAction es null.

Ejemplos

En el ejemplo siguiente se crea una tarea antecedente que usa el Sieve de Eratosthenes para calcular los números primos entre 1 y un valor especificado por el usuario. Una matriz se usa para contener información sobre los números primos. El índice de matriz representa el número y el valor del elemento indica si ese número está compuesto (su valor es true) o primo (su valor es false). A continuación, esta tarea se pasa a una tarea de continuación, que es responsable de extraer los números primos de la matriz de enteros y mostrarlos.

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

Comentarios

El devuelto Task no se programará para su ejecución hasta que se haya completado la tarea actual, independientemente de si se completa debido a la ejecución correcta, a errores debido a una excepción no controlada o a la salida anticipada debido a la cancelación.

Consulte también

• Biblioteca TPL
• Programación asincrónica basada en tareas
• Encadenar tareas mediante tareas de continuación

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

Source:

Future.cs

Crea una continuación que se ejecuta de manera asincrónica cuando se completa el objeto Task<TResult> de destino.

C#

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

Parámetros

continuationAction

Action<Task<TResult>>

Acción que se va a ejecutar cuando se complete el objeto Task<TResult>. Cuando se ejecute, al delegado se le pasará la tarea completada como un argumento.

scheduler

TaskScheduler

Objeto TaskScheduler que se va a asociar a la tarea de continuación y se va a usar para su ejecución.

Devoluciones

Task

Nuevo objeto Task de continuación.

Excepciones

ObjectDisposedException

Se ha eliminado Task<TResult>.

ArgumentNullException

El argumento continuationAction es null.

o bien

El argumento scheduler es null.

Comentarios

El devuelto Task no se programará para su ejecución hasta que se haya completado la tarea actual, independientemente de si se completa debido a la ejecución correcta, a errores debido a una excepción no controlada o a la salida anticipada debido a que se canceló.

Consulte también

• Biblioteca TPL
• Programación asincrónica basada en tareas
• Encadenar tareas mediante tareas de continuación

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

Source:

Future.cs

Crea una continuación que se ejecuta cuando se completa el objeto Task<TResult> de destino.

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

Parámetros de tipo

TNewResult

Tipo de resultado generado por la continuación.

Parámetros

continuationFunction

Func<Task<TResult>,Object,TNewResult>

Función que se va a ejecutar cuando se complete el objeto Task<TResult>. Cuando se ejecute, se pasarán al delegado la tarea completada y el objeto de estado proporcionado por el llamador como argumentos.

state

Object

Objeto que representa los datos que la función de continuación va a usar.

cancellationToken

CancellationToken

CancellationToken que se asignará a la nueva tarea.

continuationOptions

TaskContinuationOptions

Opciones para la programación y el comportamiento de la continuación. Incluye criterios, como OnlyOnCanceled, y opciones de ejecución, como ExecuteSynchronously.

scheduler

TaskScheduler

Objeto TaskScheduler que se va a asociar a la tarea de continuación y se va a usar para su ejecución.

Devoluciones

Task<TNewResult>

Nuevo objeto Task<TResult> de continuación.

Excepciones

ArgumentNullException

El argumento scheduler es null.

ArgumentOutOfRangeException

El argumento continuationOptions especifica un valor no válido para TaskContinuationOptions.

ObjectDisposedException

Ya se eliminó el CancellationToken proporcionado.

Comentarios

El devuelto Task<TResult> no se programará para su ejecución hasta que se haya completado la tarea actual, independientemente de si se completa debido a la ejecución correcta, a errores debido a una excepción no controlada o a la salida anticipada debido a que se canceló.

Cuando continuationFunctionse ejecuta , debe devolver .Task<TResult> El estado de finalización de esta tarea se transferirá a la tarea devuelta desde la Task<TResult>.ContinueWith llamada.

Consulte también

• Encadenar tareas mediante tareas de continuación

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

Source:

Future.cs

Crea una continuación que se ejecuta según la condición especificada en 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);

Parámetros de tipo

TNewResult

Tipo de resultado generado por la continuación.

Parámetros

continuationFunction

Func<Task<TResult>,TNewResult>

Una función que se ejecuta según la condición especificada en continuationOptions.

Cuando se ejecute, al delegado se le pasará la tarea completada como un argumento.

cancellationToken

CancellationToken

CancellationToken que se asignará a la nueva tarea.

continuationOptions

TaskContinuationOptions

Opciones para la programación y el comportamiento de la continuación. Incluye criterios, como OnlyOnCanceled, y opciones de ejecución, como ExecuteSynchronously.

scheduler

TaskScheduler

Objeto TaskScheduler que se va a asociar a la tarea de continuación y se va a usar para su ejecución.

Devoluciones

Task<TNewResult>

Nuevo objeto Task<TResult> de continuación.

Excepciones

ObjectDisposedException

Se ha eliminado Task<TResult>.

o bien

El CancellationTokenSource que creó cancellationToken ya se ha eliminado.

ArgumentNullException

El argumento continuationFunction es null.

o bien

El argumento scheduler es null.

ArgumentOutOfRangeException

El argumento continuationOptions especifica un valor no válido para TaskContinuationOptions.

Comentarios

El devuelto Task<TResult> no se programará para su ejecución hasta que se haya completado la tarea actual, independientemente de si se completa debido a que se ha completado correctamente, se produce un error debido a una excepción no controlada o se cierra temprano debido a la cancelación.

Cuando continuationFunctionse ejecuta , debe devolver un Task<TResult>.

Consulte también

• Biblioteca TPL
• Programación asincrónica basada en tareas
• Encadenar tareas mediante tareas de continuación

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

Source:

Future.cs

Crea una continuación que se ejecuta cuando se completa el objeto Task<TResult> de destino.

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

Parámetros de tipo

TNewResult

Tipo de resultado generado por la continuación.

Parámetros

continuationFunction

Func<Task<TResult>,Object,TNewResult>

Función que se va a ejecutar cuando se complete el objeto Task<TResult>. Cuando se ejecute, se pasarán al delegado la tarea completada y el objeto de estado proporcionado por el llamador como argumentos.

state

Object

Objeto que representa los datos que la función de continuación va a usar.

scheduler

TaskScheduler

Objeto TaskScheduler que se va a asociar a la tarea de continuación y se va a usar para su ejecución.

Devoluciones

Task<TNewResult>

Nuevo objeto Task<TResult> de continuación.

Excepciones

ArgumentNullException

El argumento scheduler es null.

Comentarios

El devuelto Task<TResult> no se programará para su ejecución hasta que se haya completado la tarea actual, independientemente de si se completa debido a que se ha completado correctamente, se produce un error debido a una excepción no controlada o se cierra temprano debido a la cancelación.

Consulte también

• Encadenar tareas mediante tareas de continuación

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

Source:

Future.cs

Crea una continuación que se ejecuta cuando se completa el objeto Task<TResult> de destino.

C#

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

Parámetros de tipo

TNewResult

Tipo de resultado generado por la continuación.

Parámetros

continuationFunction

Func<Task<TResult>,Object,TNewResult>

Función que se va a ejecutar cuando se complete el objeto Task<TResult>. Cuando se ejecute, se pasarán al delegado la tarea completada y el objeto de estado proporcionado por el llamador como argumentos.

state

Object

Objeto que representa los datos que la función de continuación va a usar.

cancellationToken

CancellationToken

CancellationToken que se asignará a la nueva tarea.

Devoluciones

Task<TNewResult>

Nuevo objeto Task<TResult> de continuación.

Excepciones

ArgumentNullException

El argumento continuationFunction es null.

ObjectDisposedException

Ya se eliminó el CancellationToken proporcionado.

Comentarios

El devuelto Task<TResult> no se programará para su ejecución hasta que se haya completado la tarea actual, independientemente de si se completa debido a que se ha completado correctamente, se produce un error debido a una excepción no controlada o se cierra temprano debido a la cancelación.

Consulte también

• Encadenar tareas mediante tareas de continuación

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

Source:

Future.cs

Crea una continuación que se ejecuta cuando se completa el objeto Task<TResult> de destino.

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

Parámetros de tipo

TNewResult

Tipo de resultado generado por la continuación.

Parámetros

continuationFunction

Func<Task<TResult>,Object,TNewResult>

Función que se va a ejecutar cuando se complete el objeto Task<TResult>. Cuando se ejecute, se pasarán al delegado la tarea completada y el objeto de estado proporcionado por el llamador como argumentos.

state

Object

Objeto que representa los datos que la función de continuación va a usar.

continuationOptions

TaskContinuationOptions

Opciones para la programación y el comportamiento de la continuación. Incluye criterios, como OnlyOnCanceled, y opciones de ejecución, como ExecuteSynchronously.

Devoluciones

Task<TNewResult>

Nuevo objeto Task<TResult> de continuación.

Excepciones

ArgumentNullException

El argumento continuationFunction es null.

ArgumentOutOfRangeException

El argumento continuationOptions especifica un valor no válido para TaskContinuationOptions.

Comentarios

El devuelto Task<TResult> no se programará para su ejecución hasta que se haya completado la tarea actual, independientemente de si se completa debido a que se ha completado correctamente, se produce un error debido a una excepción no controlada o se cierra temprano debido a la cancelación.

Cuando continuationFunctionse ejecuta , debe devolver un Task<TResult>. El estado de finalización de esta tarea se transferirá a la tarea devuelta desde la llamada ContinueWith.

Consulte también

• Encadenar tareas mediante tareas de continuación

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

Source:

Future.cs

Crea una continuación que se ejecuta según la condición especificada en continuationOptions.

C#

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

Parámetros de tipo

TNewResult

Tipo de resultado generado por la continuación.

Parámetros

continuationFunction

Func<Task<TResult>,TNewResult>

Una función que se ejecuta según la condición especificada en continuationOptions.

Cuando se ejecute, al delegado se le pasará la tarea completada como un argumento.

continuationOptions

TaskContinuationOptions

Opciones para la programación y el comportamiento de la continuación. Incluye criterios, como OnlyOnCanceled, y opciones de ejecución, como ExecuteSynchronously.

Devoluciones

Task<TNewResult>

Nuevo objeto Task<TResult> de continuación.

Excepciones

ObjectDisposedException

Se ha eliminado Task<TResult>.

ArgumentNullException

El argumento continuationFunction es null.

ArgumentOutOfRangeException

El argumento continuationOptions especifica un valor no válido para TaskContinuationOptions.

Comentarios

El devuelto Task<TResult> no se programará para su ejecución hasta que se haya completado la tarea actual, independientemente de si se completa debido a que se ha completado correctamente, se produce un error debido a una excepción no controlada o se cierra temprano debido a la cancelación.

Cuando continuationFunctionse ejecuta , debe devolver un Task<TResult>.

Consulte también

• Biblioteca TPL
• Programación asincrónica basada en tareas
• Encadenar tareas mediante tareas de continuación

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

Source:

Future.cs

Crea una continuación que se ejecuta de manera asincrónica cuando se completa el objeto Task<TResult> de destino.

C#

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

Parámetros de tipo

TNewResult

Tipo de resultado generado por la continuación.

Parámetros

continuationFunction

Func<Task<TResult>,TNewResult>

Función que se va a ejecutar cuando se complete el objeto Task<TResult>. Cuando se ejecute, al delegado se le pasará la tarea completada como un argumento.

cancellationToken

CancellationToken

CancellationToken que se asignará a la nueva tarea.

Devoluciones

Task<TNewResult>

Nuevo objeto Task<TResult> de continuación.

Excepciones

ObjectDisposedException

Se ha eliminado Task<TResult>.

o bien

El CancellationTokenSource que creó cancellationToken ya se ha eliminado.

ArgumentNullException

El argumento continuationFunction es null.

Comentarios

El devuelto Task<TResult> no se programará para su ejecución hasta que se haya completado la tarea actual, independientemente de si se completa debido a que se ha completado correctamente, se produce un error debido a una excepción no controlada o se cierra temprano debido a la cancelación.

Consulte también

• Biblioteca TPL
• Programación asincrónica basada en tareas
• Encadenar tareas mediante tareas de continuación

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

Source:

Future.cs

Crea una continuación que se ejecuta cuando se completa el objeto Task<TResult> de destino.

C#

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

Parámetros de tipo

TNewResult

Tipo de resultado generado por la continuación.

Parámetros

continuationFunction

Func<Task<TResult>,Object,TNewResult>

Función que se va a ejecutar cuando se complete el objeto Task<TResult>. Cuando se ejecute, se pasarán al delegado la tarea completada y el objeto de estado proporcionado por el llamador como argumentos.

state

Object

Objeto que representa los datos que la función de continuación va a usar.

Devoluciones

Task<TNewResult>

Nuevo objeto Task<TResult> de continuación.

Excepciones

ArgumentNullException

El argumento continuationFunction es null.

Ejemplos

En el ejemplo siguiente se crea una cadena de tareas de continuación. Cada tarea proporciona la hora actual, un DateTime objeto, para el argumento state del ContinueWith(Action<Task,Object>, Object) método . Cada DateTime valor representa la hora en la que se crea la tarea continue. Cada tarea genera como resultado un segundo DateTime valor que representa la hora en la que finaliza la tarea. Una vez finalizadas todas las tareas, el ejemplo muestra la fecha y las horas en las que se inicia y finaliza cada tarea de continuación.

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

Comentarios

El devuelto Task<TResult> no se programará para su ejecución hasta que se haya completado la tarea actual, independientemente de si se completa debido a que se ha completado correctamente, se produce un error debido a una excepción no controlada o se cierra temprano debido a la cancelación.

Consulte también

• Encadenar tareas mediante tareas de continuación

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

Source:

Future.cs

Crea una continuación que se ejecuta de manera asincrónica cuando se completa el objeto Task<TResult> de destino.

C#

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

Parámetros de tipo

TNewResult

Tipo de resultado generado por la continuación.

Parámetros

continuationFunction

Func<Task<TResult>,TNewResult>

Función que se va a ejecutar cuando se complete el objeto Task<TResult>. Cuando se ejecute, al delegado se le pasará la tarea completada como un argumento.

Devoluciones

Task<TNewResult>

Nuevo objeto Task<TResult> de continuación.

Excepciones

ObjectDisposedException

Se ha eliminado Task<TResult>.

ArgumentNullException

El argumento continuationFunction es null.

Comentarios

El devuelto Task<TResult> no se programará para su ejecución hasta que se haya completado la tarea actual, independientemente de si se completa debido a que se ha completado correctamente, se produce un error debido a una excepción no controlada o se cierra temprano debido a la cancelación.

Consulte también

• Biblioteca TPL
• Programación asincrónica basada en tareas
• Encadenar tareas mediante tareas de continuación

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

Source:

Future.cs

Crea una continuación que se ejecuta de manera asincrónica cuando se completa el objeto Task<TResult> de destino.

C#

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

Parámetros de tipo

TNewResult

Tipo de resultado generado por la continuación.

Parámetros

continuationFunction

Func<Task<TResult>,TNewResult>

Función que se va a ejecutar cuando se complete el objeto Task<TResult>. Cuando se ejecute, al delegado se le pasará la tarea completada como un argumento.

scheduler

TaskScheduler

Objeto TaskScheduler que se va a asociar a la tarea de continuación y se va a usar para su ejecución.

Devoluciones

Task<TNewResult>

Nuevo objeto Task<TResult> de continuación.

Excepciones

ObjectDisposedException

Se ha eliminado Task<TResult>.

ArgumentNullException

El argumento continuationFunction es null.

o bien

El argumento scheduler es null.

Comentarios

El devuelto Task<TResult> no se programará para su ejecución hasta que se haya completado la tarea actual, independientemente de si se completa debido a que se ha completado correctamente, se produce un error debido a una excepción no controlada o se cierra temprano debido a la cancelación.

Consulte también

• TaskScheduler
• Biblioteca TPL
• Programación asincrónica basada en tareas
• Encadenar tareas mediante tareas de continuación