TaskFactory.StartNew Método

Referencia

Definición

Espacio de nombres:: System.Threading.Tasks

Ensamblado:: System.Threading.Tasks.dll

Ensamblado:: System.Runtime.dll

Ensamblado:: mscorlib.dll

Ensamblado:: netstandard.dll

Importante

Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.

Crea e inicia una tarea.

Sobrecargas

StartNew(Action<Object>, Object, CancellationToken, TaskCreationOptions, TaskScheduler)	Crea e inicia una tarea para el delegado de acción, el estado, el token de cancelación, las opciones de creación y el programador de tareas especificados.
StartNew(Action, CancellationToken, TaskCreationOptions, TaskScheduler)	Crea e inicia una tarea para el delegado de acción, el token de cancelación, las opciones de creación y el estado especificados.
StartNew(Action<Object>, Object, TaskCreationOptions)	Crea e inicia una tarea para el delegado de acción, el estado y las opciones de creación especificados.
StartNew(Action<Object>, Object, CancellationToken)	Crea e inicia una tarea para el delegado de acción, el estado y el token de cancelación especificados.
StartNew(Action, CancellationToken)	Crea e inicia una tarea para el delegado de acción y el token de cancelación especificados.
StartNew(Action, TaskCreationOptions)	Crea e inicia una tarea para las opciones de creación y delegado de acción especificadas.
StartNew(Action)	Crea e inicia una tarea para el delegado de acción especificado.
StartNew(Action<Object>, Object)	Crea e inicia una tarea para el delegado y el estado de acción especificados.
StartNew<TResult>(Func<TResult>, CancellationToken, TaskCreationOptions, TaskScheduler)	Crea e inicia una tarea de tipo `TResult` para el delegado de función, el token de cancelación, las opciones de creación y el programador de tareas especificados.
StartNew<TResult>(Func<TResult>)	Crea e inicia una tarea de tipo `TResult` para el delegado de función especificado.
StartNew<TResult>(Func<Object,TResult>, Object)	Crea e inicia una tarea de tipo `TResult` para el delegado y el estado de función especificados.
StartNew<TResult>(Func<TResult>, CancellationToken)	Crea e inicia una tarea de tipo `TResult` para el delegado de función y el token de cancelación especificados.
StartNew<TResult>(Func<TResult>, TaskCreationOptions)	Crea e inicia una tarea de tipo `TResult` para las opciones de creación y delegado de función especificadas.
StartNew<TResult>(Func<Object,TResult>, Object, CancellationToken)	Crea e inicia una tarea de tipo `TResult` para el delegado de función, el estado y el token de cancelación especificados.
StartNew<TResult>(Func<Object,TResult>, Object, TaskCreationOptions)	Crea e inicia una tarea de tipo `TResult` para las opciones de delegado de función, estado y creación especificadas.
StartNew<TResult>(Func<Object,TResult>, Object, CancellationToken, TaskCreationOptions, TaskScheduler)	Crea e inicia una tarea de tipo `TResult` para el delegado de función, el estado, el token de cancelación, las opciones de creación y el programador de tareas especificados.

Comentarios

A partir de la .NET Framework 4.5, el Task.Run método es la manera recomendada de iniciar una tarea enlazada a proceso. Use el StartNew método solo cuando necesite un control específico para una tarea enlazada a proceso de larga duración. Esto incluye escenarios en los que desea controlar lo siguiente:

Opciones de creación de tareas. Las tareas creadas por el Task.Run método de forma predeterminada se crean con la TaskCreationOptions.DenyChildAttach opción . Para invalidar este comportamiento, o para proporcionar otras TaskCreationOptions opciones, llame a una StartNew sobrecarga.
Paso de parámetros. Las sobrecargas del Task.Run método no permiten pasar un parámetro al delegado de tareas. Las sobrecargas del StartNew método sí.
Programador de tareas. Las sobrecargas del Task.Run método usan el programador de tareas predeterminado. Para controlar el programador de tareas, llame a una StartNew sobrecarga con un scheduler parámetro . Para obtener más información, vea TaskScheduler.

StartNew(Action<Object>, Object, CancellationToken, TaskCreationOptions, TaskScheduler)

Crea e inicia una tarea para el delegado de acción, el estado, el token de cancelación, las opciones de creación y el programador de tareas especificados.

public:
 System::Threading::Tasks::Task ^ StartNew(Action<System::Object ^> ^ action, System::Object ^ state, System::Threading::CancellationToken cancellationToken, System::Threading::Tasks::TaskCreationOptions creationOptions, System::Threading::Tasks::TaskScheduler ^ scheduler);

public System.Threading.Tasks.Task StartNew (Action<object> action, object state, System.Threading.CancellationToken cancellationToken, System.Threading.Tasks.TaskCreationOptions creationOptions, System.Threading.Tasks.TaskScheduler scheduler);

public System.Threading.Tasks.Task StartNew (Action<object?> action, object? state, System.Threading.CancellationToken cancellationToken, System.Threading.Tasks.TaskCreationOptions creationOptions, System.Threading.Tasks.TaskScheduler scheduler);

member this.StartNew : Action<obj> * obj * System.Threading.CancellationToken * System.Threading.Tasks.TaskCreationOptions * System.Threading.Tasks.TaskScheduler -> System.Threading.Tasks.Task

Public Function StartNew (action As Action(Of Object), state As Object, cancellationToken As CancellationToken, creationOptions As TaskCreationOptions, scheduler As TaskScheduler) As Task

Parámetros

action: Action<Object>

Delegado de acción que se va a ejecutar de forma asincrónica.

state: Object

Objeto que contiene los datos que el delegado de action va a usar.

cancellationToken: CancellationToken

Token de cancelación que se va a asignar a la nueva tarea.

creationOptions: TaskCreationOptions

Uno de los valores de enumeración que controla el comportamiento de la tarea creada.

scheduler: TaskScheduler

Programador de tareas que se usó para programar la tarea creada.

Devoluciones

Task

La tarea iniciada.

Excepciones

ObjectDisposedException

Ya se eliminó el CancellationToken proporcionado.

ArgumentNullException

action es null.

O bien

scheduler es null.

ArgumentOutOfRangeException

El argumento creationOptions especifica un valor TaskCreationOptions no válido. Para obtener más información, vea la sección Comentarios de FromAsync(Func<AsyncCallback,Object,IAsyncResult>, Action<IAsyncResult>, Object, TaskCreationOptions).

Comentarios

Llamar a StartNew es funcionalmente equivalente a crear una tarea mediante uno de sus constructores y, a continuación, llamar Start a para programarla para su ejecución.

A partir de la .NET Framework 4.5, puede usar el Run método con un Action objeto como una manera rápida de llamar StartNew con parámetros predeterminados. Para obtener más información y ejemplos de código, vea Task.Run vs Task.Factory.StartNew en el blog Programación en paralelo con .NET.

Consulte también

Se aplica a

.NET 7 y otras versiones

Producto	Versiones
.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
.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
.NET Standard	1.0, 1.1, 1.2, 1.3, 1.4, 1.6, 2.0, 2.1
UWP	10.0

StartNew(Action, CancellationToken, TaskCreationOptions, TaskScheduler)

Crea e inicia una tarea para el delegado de acción, el token de cancelación, las opciones de creación y el estado especificados.

public:
 System::Threading::Tasks::Task ^ StartNew(Action ^ action, System::Threading::CancellationToken cancellationToken, System::Threading::Tasks::TaskCreationOptions creationOptions, System::Threading::Tasks::TaskScheduler ^ scheduler);

public System.Threading.Tasks.Task StartNew (Action action, System.Threading.CancellationToken cancellationToken, System.Threading.Tasks.TaskCreationOptions creationOptions, System.Threading.Tasks.TaskScheduler scheduler);

member this.StartNew : Action * System.Threading.CancellationToken * System.Threading.Tasks.TaskCreationOptions * System.Threading.Tasks.TaskScheduler -> System.Threading.Tasks.Task

Public Function StartNew (action As Action, cancellationToken As CancellationToken, creationOptions As TaskCreationOptions, scheduler As TaskScheduler) As Task

Parámetros

action: Action

Delegado de acción que se va a ejecutar de forma asincrónica.

cancellationToken: CancellationToken

Token de cancelación que se va a asignar a la nueva tarea.

creationOptions: TaskCreationOptions

Uno de los valores de enumeración que controla el comportamiento de la tarea creada.

scheduler: TaskScheduler

Programador de tareas que se usó para programar la tarea creada.

Devoluciones

Task

La tarea iniciada.

Excepciones

ObjectDisposedException

Ya se eliminó el CancellationToken proporcionado.

ArgumentNullException

action es null.

O bien scheduler es null.

ArgumentOutOfRangeException

creationOptions especifica un valor TaskCreationOptions no válido. Para obtener más información, vea la sección Comentarios de FromAsync(Func<AsyncCallback,Object,IAsyncResult>, Action<IAsyncResult>, Object, TaskCreationOptions).

Comentarios

Llamar a StartNew es funcionalmente equivalente a crear una tarea mediante uno de sus constructores y, a continuación, llamar Start a para programarla para su ejecución.

Consulte también

Se aplica a

.NET 7 y otras versiones

Producto	Versiones
.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
.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
.NET Standard	1.0, 1.1, 1.2, 1.3, 1.4, 1.6, 2.0, 2.1
UWP	10.0

StartNew(Action<Object>, Object, TaskCreationOptions)

Crea e inicia una tarea para el delegado de acción, el estado y las opciones de creación especificados.

public:
 System::Threading::Tasks::Task ^ StartNew(Action<System::Object ^> ^ action, System::Object ^ state, System::Threading::Tasks::TaskCreationOptions creationOptions);

public System.Threading.Tasks.Task StartNew (Action<object> action, object state, System.Threading.Tasks.TaskCreationOptions creationOptions);

public System.Threading.Tasks.Task StartNew (Action<object?> action, object? state, System.Threading.Tasks.TaskCreationOptions creationOptions);

member this.StartNew : Action<obj> * obj * System.Threading.Tasks.TaskCreationOptions -> System.Threading.Tasks.Task

Public Function StartNew (action As Action(Of Object), state As Object, creationOptions As TaskCreationOptions) As Task

Parámetros

action: Action<Object>

Delegado de acción que se va a ejecutar de forma asincrónica.

state: Object

Objeto que contiene los datos que el delegado de action va a usar.

creationOptions: TaskCreationOptions

Uno de los valores de enumeración que controla el comportamiento de la tarea creada.

Devoluciones

Task

La tarea iniciada.

Excepciones

ArgumentNullException

action es null.

ArgumentOutOfRangeException

creationOptions especifica un valor TaskCreationOptions no válido.

Comentarios

Llamar a StartNew es funcionalmente equivalente a crear una tarea mediante uno de sus constructores y, a continuación, llamar Start a para programarla para su ejecución.

Consulte también

Se aplica a

.NET 7 y otras versiones

Producto	Versiones
.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
.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
.NET Standard	1.0, 1.1, 1.2, 1.3, 1.4, 1.6, 2.0, 2.1
UWP	10.0

StartNew(Action<Object>, Object, CancellationToken)

Crea e inicia una tarea para el delegado de acción, el estado y el token de cancelación especificados.

public:
 System::Threading::Tasks::Task ^ StartNew(Action<System::Object ^> ^ action, System::Object ^ state, System::Threading::CancellationToken cancellationToken);

public System.Threading.Tasks.Task StartNew (Action<object> action, object state, System.Threading.CancellationToken cancellationToken);

public System.Threading.Tasks.Task StartNew (Action<object?> action, object? state, System.Threading.CancellationToken cancellationToken);

member this.StartNew : Action<obj> * obj * System.Threading.CancellationToken -> System.Threading.Tasks.Task

Public Function StartNew (action As Action(Of Object), state As Object, cancellationToken As CancellationToken) As Task

Parámetros

action: Action<Object>

Delegado de acción que se va a ejecutar de forma asincrónica.

state: Object

Objeto que contiene los datos que el delegado de action va a usar.

cancellationToken: CancellationToken

Token de cancelación que se va a asignar a la nueva tarea.

Devoluciones

Task

La tarea iniciada.

Excepciones

ObjectDisposedException

Ya se eliminó el CancellationToken proporcionado.

ArgumentNullException

action es null.

Ejemplos

En el ejemplo siguiente se define una matriz de palabras de 6 letras. A continuación, cada palabra se pasa a un Action<T> delegado, que codifica la palabra y muestra la palabra original y su versión codificada.

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

public class Example
{
   public static void Main()
   {
      CancellationTokenSource cts = new CancellationTokenSource();
      CancellationToken token = cts.Token;
      var tasks = new List<Task>();
      Random rnd = new Random();
      Object lockObj = new Object();
      String[] words6 = { "reason", "editor", "rioter", "rental",
                          "senior", "regain", "ordain", "rained" };

      foreach (var word6 in words6)
         tasks.Add(Task.Factory.StartNew( (word) => { Char[] chars = word.ToString().ToCharArray();
                                                      double[] order = new double[chars.Length];
                                                      token.ThrowIfCancellationRequested();
                                                      bool wasZero = false;
                                                      lock (lockObj) {
                                                         for (int ctr = 0; ctr < order.Length; ctr++) {
                                                             order[ctr] = rnd.NextDouble();
                                                             if (order[ctr] == 0) {
                                                                if (! wasZero) {
                                                                   wasZero = true;
                                                                }
                                                                else {
                                                                   cts.Cancel();
                                                                }
                                                             }
                                                         }
                                                      }
                                                      token.ThrowIfCancellationRequested();
                                                      Array.Sort(order, chars);
                                                      Console.WriteLine("{0} --> {1}", word,
                                                                        new String(chars));
                                                    }, word6, token));

      try {
         Task.WaitAll(tasks.ToArray());
      }
      catch (AggregateException e) {
         foreach (var ie in e.InnerExceptions) {
            if (ie is OperationCanceledException) {
               Console.WriteLine("The word scrambling operation has been cancelled.");
               break;
            }
            else {
               Console.WriteLine(ie.GetType().Name + ": " + ie.Message);
            }
         }
      }
      finally {
         cts.Dispose();
      }
   }
}
// The example displays output like the following:
//    regain --> irnaeg
//    ordain --> rioadn
//    reason --> soearn
//    rained --> rinade
//    rioter --> itrore
//    senior --> norise
//    rental --> atnerl
//    editor --> oteird

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

Module Example
   Public Sub Main()
      Dim cts As New CancellationTokenSource()
      Dim token As CancellationToken = cts.Token
      Dim tasks As New List(Of Task)()
      Dim rnd As New Random()
      Dim lockObj As New Object()
      Dim words6() As String = { "reason", "editor", "rioter", "rental",
                                 "senior", "regain", "ordain", "rained" }

      For Each word6 in words6
         tasks.Add(Task.Factory.StartNew( Sub(word)
                                              Dim chars() As Char = word.ToString().ToCharArray()
                                              Dim order(chars.Length - 1) As Double
                                              Dim wasZero As Boolean = False
                                              SyncLock lockObj
                                                 For ctr As Integer = 0 To order.Length - 1
                                                    order(ctr) = rnd.NextDouble()
                                                    If order(ctr) = 0 Then
                                                       If Not wasZero Then
                                                          wasZero = True
                                                       Else
                                                          cts.Cancel()
                                                       End If
                                                    End If
                                                 Next
                                              End SyncLock
                                              token.ThrowIfCancellationRequested()
                                              Array.Sort(order, chars)
                                              Console.WriteLine("{0} --> {1}", word,
                                                                new String(chars))
                                          End Sub, word6))
      Next
      Try
         Task.WaitAll(tasks.ToArray())
      Catch e As AggregateException
         For Each ie In e.InnerExceptions
            If TypeOf ie Is OperationCanceledException
               Console.WriteLine("The word scrambling operation has been cancelled.")
               Exit For
            Else
               Console.WriteLine(ie.GetType().Name + ": " + ie.Message)
            End If
         Next
      Finally
         cts.Dispose()
      End Try
   End Sub
End Module
' The example displays output like the following:
'       regain --> irnaeg
'       ordain --> rioadn
'       reason --> soearn
'       rained --> rinade
'       rioter --> itrore
'       senior --> norise
'       rental --> atnerl
'       editor --> oteird

Tenga en cuenta que el ejemplo inicializa un único generador de números aleatorios, que está protegido por un bloqueo. Para conocer la necesidad de un bloqueo, vea "La seguridad de subprocesos y la clase System.Random" en el tema de clase Random . Para controlar la posibilidad de daños en el generador de números aleatorios, se pasa un token de cancelación a la tarea. Si dos números aleatorios son iguales a cero, el método supone que el generador de números aleatorios está dañado y establece el token de cancelación. Antes de ordenar la chars matriz que contiene los seis caracteres de una palabra, el método llama al CancellationToken.ThrowIfCancellationRequested método para iniciar un OperationCanceledException si se ha cancelado el token.

Comentarios

Llamar a StartNew es funcionalmente equivalente a crear una tarea mediante uno de sus constructores y, a continuación, llamar Start a para programarla para su ejecución.

Consulte también

Se aplica a

.NET 7 y otras versiones

Producto	Versiones
.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
.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
.NET Standard	1.0, 1.1, 1.2, 1.3, 1.4, 1.6, 2.0, 2.1
UWP	10.0

StartNew(Action, CancellationToken)

Crea e inicia una tarea para el delegado de acción y el token de cancelación especificados.

public:
 System::Threading::Tasks::Task ^ StartNew(Action ^ action, System::Threading::CancellationToken cancellationToken);

public System.Threading.Tasks.Task StartNew (Action action, System.Threading.CancellationToken cancellationToken);

member this.StartNew : Action * System.Threading.CancellationToken -> System.Threading.Tasks.Task

Public Function StartNew (action As Action, cancellationToken As CancellationToken) As Task

Parámetros

action: Action

Delegado de acción que se va a ejecutar de forma asincrónica.

cancellationToken: CancellationToken

Token de cancelación que se va a asignar a la nueva tarea.

Devoluciones

Task

La tarea iniciada.

Excepciones

ObjectDisposedException

Ya se eliminó el CancellationToken proporcionado.

ArgumentNullException

action es null.

Ejemplos

En el ejemplo siguiente se llama al StartNew(Action, CancellationToken) método para crear una tarea que itera los archivos en el directorio C:\Windows\System32. La expresión lambda llama al Parallel.ForEach método para agregar información sobre cada archivo a un List<T> objeto . Cada tarea anidada desasociada invocada por el Parallel.ForEach bucle comprueba el estado del token de cancelación y, si se solicita la cancelación, llama al CancellationToken.ThrowIfCancellationRequested método . El CancellationToken.ThrowIfCancellationRequested método produce una OperationCanceledException excepción que se controla en un catch bloque cuando el subproceso que realiza la llamada llama al Task.Wait método .

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

public class Example
{
   public static void Main()
   {
      var tokenSource = new CancellationTokenSource();
      var token = tokenSource.Token;
      var files = new List<Tuple<string, string, long, DateTime>>();

      var t = Task.Factory.StartNew( () => { string dir = "C:\\Windows\\System32\\";
                                object obj = new Object();
                                if (Directory.Exists(dir)) {
                                   Parallel.ForEach(Directory.GetFiles(dir),
                                   f => {
                                           if (token.IsCancellationRequested)
                                              token.ThrowIfCancellationRequested();
                                           var fi = new FileInfo(f);
                                           lock(obj) {
                                              files.Add(Tuple.Create(fi.Name, fi.DirectoryName, fi.Length, fi.LastWriteTimeUtc));          
                                           }
                                      });
                                 }
                              }
                        , token);
      tokenSource.Cancel();
      try {
         t.Wait(); 
         Console.WriteLine("Retrieved information for {0} files.", files.Count);
      }
      catch (AggregateException e) {
         Console.WriteLine("Exception messages:");
         foreach (var ie in e.InnerExceptions)
            Console.WriteLine("   {0}: {1}", ie.GetType().Name, ie.Message);

         Console.WriteLine("\nTask status: {0}", t.Status);       
      }
      finally {
         tokenSource.Dispose();
      }
   }
}
// The example displays the following output:
//       Exception messages:
//          TaskCanceledException: A task was canceled.
//       
//       Task status: Canceled

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

Module Example
   Public Sub Main()
      Dim tokenSource As New CancellationTokenSource()
      Dim token As CancellationToken = tokenSource.Token
      Dim files As New List(Of Tuple(Of String, String, Long, Date))()

      Dim t As Task = Task.Factory.StartNew( Sub()
                                   Dim dir As String = "C:\Windows\System32\"
                                   Dim obj As New Object()
                                   If Directory.Exists(dir)Then
                                      Parallel.ForEach(Directory.GetFiles(dir), 
                                         Sub(f)
                                            If token.IsCancellationRequested Then
                                               token.ThrowIfCancellationRequested()
                                            End If  
                                            Dim fi As New FileInfo(f)
                                            SyncLock(obj)
                                              files.Add(Tuple.Create(fi.Name, fi.DirectoryName, fi.Length, fi.LastWriteTimeUtc))          
                                            End SyncLock
                                         End Sub)
                                   End If
                                End Sub, token)
      tokenSource.Cancel()
      Try
         t.Wait() 
         Console.WriteLine("Retrieved information for {0} files.", files.Count)
      Catch e As AggregateException
         Console.WriteLine("Exception messages:")
         For Each ie As Exception In e.InnerExceptions
            Console.WriteLine("   {0}:{1}", ie.GetType().Name, ie.Message)
         Next
         Console.WriteLine()
         Console.WriteLine("Task status: {0}", t.Status)       
      Finally
         tokenSource.Dispose()
      End Try
   End Sub
End Module
' The example displays the following output:
'       Exception messages:
'          TaskCanceledException: A task was canceled.
'       
'       Task status: Canceled

Comentarios

Llamar a StartNew es funcionalmente equivalente a crear una tarea mediante uno de sus constructores y, a continuación, llamar Start a para programarla para su ejecución.

A partir de la .NET Framework 4.5, puede usar el Task.Run(Action, CancellationToken) método como una manera rápida de llamar StartNew(Action, CancellationToken) a con parámetros predeterminados. Tenga en cuenta, sin embargo, que hay una diferencia en el comportamiento entre los dos métodos relacionados con : Task.Run(Action, CancellationToken) de forma predeterminada no permite que las tareas secundarias iniciadas con la TaskCreationOptions.AttachedToParent opción se asocie a la instancia actual Task , mientras StartNew(Action, CancellationToken) que sí. Para obtener más información y ejemplos de código, vea Task.Run vs Task.Factory.StartNew en el blog Programación en paralelo con .NET.

Consulte también

Se aplica a

.NET 7 y otras versiones

Producto	Versiones
.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
.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
.NET Standard	1.0, 1.1, 1.2, 1.3, 1.4, 1.6, 2.0, 2.1
UWP	10.0

StartNew(Action, TaskCreationOptions)

Crea e inicia una tarea para las opciones de creación y delegado de acción especificadas.

public:
 System::Threading::Tasks::Task ^ StartNew(Action ^ action, System::Threading::Tasks::TaskCreationOptions creationOptions);

public System.Threading.Tasks.Task StartNew (Action action, System.Threading.Tasks.TaskCreationOptions creationOptions);

member this.StartNew : Action * System.Threading.Tasks.TaskCreationOptions -> System.Threading.Tasks.Task

Public Function StartNew (action As Action, creationOptions As TaskCreationOptions) As Task

Parámetros

action: Action

Delegado de acción que se va a ejecutar de forma asincrónica.

creationOptions: TaskCreationOptions

Uno de los valores de enumeración que controla el comportamiento de la tarea creada.

Devoluciones

Task

La tarea iniciada.

Excepciones

ArgumentNullException

action es null.

ArgumentOutOfRangeException

creationOptions especifica un valor TaskCreationOptions no válido.

Comentarios

Llamar a StartNew es funcionalmente equivalente a crear una tarea mediante uno de sus constructores y, a continuación, llamar Start a para programarla para su ejecución.

A partir de la .NET Framework 4.5, puede usar el Run método con un Action objeto como una manera rápida de llamar StartNew a con parámetros predeterminados. Para obtener más información y ejemplos de código, vea Task.Run vs Task.Factory.StartNew en el blog Programación en paralelo con .NET.

Consulte también

Se aplica a

.NET 7 y otras versiones

Producto	Versiones
.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
.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
.NET Standard	1.0, 1.1, 1.2, 1.3, 1.4, 1.6, 2.0, 2.1
UWP	10.0

StartNew(Action)

Crea e inicia una tarea para el delegado de acción especificado.

public:
 System::Threading::Tasks::Task ^ StartNew(Action ^ action);

public System.Threading.Tasks.Task StartNew (Action action);

member this.StartNew : Action -> System.Threading.Tasks.Task

Public Function StartNew (action As Action) As Task

Parámetros

action: Action

Delegado de acción que se va a ejecutar de forma asincrónica.

Devoluciones

Task

La tarea iniciada.

Excepciones

ArgumentNullException

El argumento action es null.

Ejemplos

En el ejemplo siguiente se usa el StartNew(Action) método para invocar repetidamente un Action delegado que genera un número aleatorio, lo interpreta como un punto de código Unicode, lo convierte en una unidad de código con codificación UTF16 y muestra información sobre el carácter o los caracteres resultantes.

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

public class Example
{
   public static void Main()
   {
      Random rnd = new Random();
      List<Task> tasks  = new List<Task>();
      // Execute the task 10 times.
      for (int ctr = 1; ctr <= 9; ctr++) {
         tasks.Add(Task.Factory.StartNew( () => {
                                            int utf32 = 0;
                                            lock(rnd) {
                                               // Get UTF32 value.
                                               utf32 = rnd.Next(0, 0xE01F0);
                                            }
                                            // Convert it to a UTF16-encoded character.
                                            string utf16 = Char.ConvertFromUtf32(utf32);
                                            // Display information about the character.
                                            Console.WriteLine("0x{0:X8} --> '{1,2}' ({2})", 
                                                              utf32, utf16, ShowHex(utf16));
                                         }));                           
      }
      Task.WaitAll(tasks.ToArray()); 
   }

   private static string ShowHex(string value)
   {
      string hexString = null;
      // Handle only non-control characters.
      if (! Char.IsControl(value, 0)) {
         foreach (var ch in value)
            hexString += $"0x{(ushort)ch:X} ";
      }   
      return hexString.Trim();
   }
}
// The example displays the following output:
//       0x00097103 --> '򗄃' (0x55836 0x56579)
//       0x000A98A1 --> '򩢡' (0x55910 0x56481)
//       0x00050002 --> '񐀂' (0x55552 0x56322)
//       0x0000FEF1 --> 'ﻱ' (0x65265)
//       0x0008BC0A --> '򋰊' (0x55791 0x56330)
//       0x000860EA --> '򆃪' (0x55768 0x56554)
//       0x0009AC5A --> '򚱚' (0x55851 0x56410)
//       0x00053320 --> '񓌠' (0x55564 0x57120)
//       0x000874EF --> '򇓯' (0x55773 0x56559)

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

Public Module Example
   Public Sub Main()
      Dim rnd As New Random()
      Dim tasks As New List(Of Task)
      ' Execute the task 10 times.
      For ctr As Integer = 1 To 9
         tasks.Add(Task.Factory.StartNew(Sub()
                                            Dim utf32 As Integer
                                            SyncLock(rnd)
                                               ' Get UTF32 value.
                                               utf32 = rnd.Next(0, &hE01F0)
                                            End SyncLock
                                            ' Convert it to a UTF16-encoded character.
                                            Dim utf16 As String = Char.ConvertFromUtf32(utf32)
                                            ' Display information about the character.
                                            Console.WriteLine("0x{0:X8} --> '{1,2}' ({2})", 
                                                              utf32, utf16, ShowHex(utf16))
                                         End Sub))                           
      Next
      Task.WaitAll(tasks.ToArray()) 
   End Sub
   
   Private Function ShowHex(value As String) As String
      Dim hexString As String = Nothing
      ' Handle only non-control characters.
      If Not Char.IsControl(value, 0) Then
         For Each ch In value
            hexString += String.Format("0x{0} ", Convert.ToUInt16(ch))
         Next
      End If   
      Return hexString.Trim()
   End Function
End Module
' The example displays output similar to the following:
'       0x00097103 --> '򗄃' (0x55836 0x56579)
'       0x000A98A1 --> '򩢡' (0x55910 0x56481)
'       0x00050002 --> '񐀂' (0x55552 0x56322)
'       0x0000FEF1 --> 'ﻱ' (0x65265)
'       0x0008BC0A --> '򋰊' (0x55791 0x56330)
'       0x000860EA --> '򆃪' (0x55768 0x56554)
'       0x0009AC5A --> '򚱚' (0x55851 0x56410)
'       0x00053320 --> '񓌠' (0x55564 0x57120)
'       0x000874EF --> '򇓯' (0x55773 0x56559)

Comentarios

Llamar a StartNew es funcionalmente equivalente a crear una tarea mediante uno de sus constructores y, a continuación, llamar al Task.Start método para programar la tarea para su ejecución.

A partir de la .NET Framework 4.5, puede usar el Task.Run(Action) método como una manera rápida de llamar StartNew(Action) a con parámetros predeterminados. Tenga en cuenta, sin embargo, que hay una diferencia en el comportamiento entre los dos métodos relacionados con : Task.Run(Action) de forma predeterminada no permite que las tareas secundarias iniciadas con la TaskCreationOptions.AttachedToParent opción se asocie a la instancia actual Task , mientras StartNew(Action) que sí. Para obtener más información y ejemplos de código, vea Task.Run vs Task.Factory.StartNew en el blog Programación en paralelo con .NET.

Consulte también

Se aplica a

.NET 7 y otras versiones

Producto	Versiones
.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
.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
.NET Standard	1.0, 1.1, 1.2, 1.3, 1.4, 1.6, 2.0, 2.1
UWP	10.0

StartNew(Action<Object>, Object)

Crea e inicia una tarea para el delegado y el estado de acción especificados.

public:
 System::Threading::Tasks::Task ^ StartNew(Action<System::Object ^> ^ action, System::Object ^ state);

public System.Threading.Tasks.Task StartNew (Action<object> action, object state);

public System.Threading.Tasks.Task StartNew (Action<object?> action, object? state);

member this.StartNew : Action<obj> * obj -> System.Threading.Tasks.Task

Public Function StartNew (action As Action(Of Object), state As Object) As Task

Parámetros

action: Action<Object>

Delegado de acción que se va a ejecutar de forma asincrónica.

state: Object

Objeto que contiene los datos que el delegado de action va a usar.

Devoluciones

Task

La tarea iniciada.

Excepciones

ArgumentNullException

El argumento action es null.

Ejemplos

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

public class Example
{
   public static void Main()
   {
      var tasks = new List<Task>();
      Random rnd = new Random();
      Object lockObj = new Object();
      String[] words6 = { "reason", "editor", "rioter", "rental",
                          "senior", "regain", "ordain", "rained" };

      foreach (var word6 in words6)
         tasks.Add(Task.Factory.StartNew( (word) => { Char[] chars = word.ToString().ToCharArray();
                                                      double[] order = new double[chars.Length];
                                                      lock (lockObj) {
                                                         for (int ctr = 0; ctr < order.Length; ctr++)
                                                             order[ctr] = rnd.NextDouble();
                                                      }
                                                      Array.Sort(order, chars);
                                                      Console.WriteLine("{0} --> {1}", word,
                                                                        new String(chars));
                                                    }, word6));

      Task.WaitAll(tasks.ToArray());
   }
}
// The example displays output like the following:
//    regain --> irnaeg
//    ordain --> rioadn
//    reason --> soearn
//    rained --> rinade
//    rioter --> itrore
//    senior --> norise
//    rental --> atnerl
//    editor --> oteird

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

Module Example
   Public Sub Main()
      Dim tasks As New List(Of Task)()
      Dim rnd As New Random()
      Dim lockObj As New Object()
      Dim words6() As String = { "reason", "editor", "rioter", "rental",
                                 "senior", "regain", "ordain", "rained" }

      For Each word6 in words6
         tasks.Add(Task.Factory.StartNew( Sub(word)
                                              Dim chars() As Char = word.ToString().ToCharArray()
                                              Dim order(chars.Length - 1) As Double
                                              SyncLock lockObj
                                                 For ctr As Integer = 0 To order.Length - 1
                                                    order(ctr) = rnd.NextDouble()
                                                 Next
                                              End SyncLock
                                              Array.Sort(order, chars)
                                              Console.WriteLine("{0} --> {1}", word,
                                                                new String(chars))
                                          End Sub, word6))
      Next
      Task.WaitAll(tasks.ToArray())
   End Sub
End Module
' The example displays output like the following:
'       regain --> irnaeg
'       ordain --> rioadn
'       reason --> soearn
'       rained --> rinade
'       rioter --> itrore
'       senior --> norise
'       rental --> atnerl
'       editor --> oteird

Tenga en cuenta que el ejemplo inicializa un único generador de números aleatorios, que está protegido por un bloqueo. Para la necesidad de un bloqueo, vea "La seguridad de subprocesos y la clase System.Random" en el tema de la Random clase.

Comentarios

Llamar a StartNew es funcionalmente equivalente a crear mediante Task uno de sus constructores y, a continuación, llamar al Start método para programarlo para su ejecución.

Consulte también

Se aplica a

.NET 7 y otras versiones

Producto	Versiones
.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
.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
.NET Standard	1.0, 1.1, 1.2, 1.3, 1.4, 1.6, 2.0, 2.1
UWP	10.0

StartNew<TResult>(Func<TResult>, CancellationToken, TaskCreationOptions, TaskScheduler)

Crea e inicia una tarea de tipo TResult para el delegado de función, el token de cancelación, las opciones de creación y el programador de tareas especificados.

public:
generic <typename TResult>
 System::Threading::Tasks::Task<TResult> ^ StartNew(Func<TResult> ^ function, System::Threading::CancellationToken cancellationToken, System::Threading::Tasks::TaskCreationOptions creationOptions, System::Threading::Tasks::TaskScheduler ^ scheduler);

public System.Threading.Tasks.Task<TResult> StartNew<TResult> (Func<TResult> function, System.Threading.CancellationToken cancellationToken, System.Threading.Tasks.TaskCreationOptions creationOptions, System.Threading.Tasks.TaskScheduler scheduler);

member this.StartNew : Func<'Result> * System.Threading.CancellationToken * System.Threading.Tasks.TaskCreationOptions * System.Threading.Tasks.TaskScheduler -> System.Threading.Tasks.Task<'Result>

Public Function StartNew(Of TResult) (function As Func(Of TResult), cancellationToken As CancellationToken, creationOptions As TaskCreationOptions, scheduler As TaskScheduler) As Task(Of TResult)

Parámetros de tipo

TResult

Tipo del resultado disponible a través de la tarea.

Parámetros

function: Func<TResult>

Delegado de función que devuelve el resultado futuro que va a estar disponible a través de la tarea.

cancellationToken: CancellationToken

Token de cancelación que se va a asignar a la nueva tarea.

creationOptions: TaskCreationOptions

Uno de los valores de enumeración que controla el comportamiento de la tarea creada.

scheduler: TaskScheduler

Programador de tareas que se usó para programar la tarea creada.

Devoluciones

Task<TResult>

La tarea iniciada.

Excepciones

ObjectDisposedException

Ya se eliminó el CancellationToken proporcionado.

ArgumentNullException

function es null.

O bien scheduler es null.

ArgumentOutOfRangeException

Comentarios

Llamar a StartNew es funcionalmente equivalente a crear mediante Task<TResult> uno de sus constructores y, a continuación, llamar Start a para programarlo para su ejecución.

A partir de la .NET Framework 4.5, puede usar el Run método con un Action objeto como una manera rápida de llamar StartNew a con parámetros predeterminados. Para obtener más información y ejemplos de código, vea la entrada Task.Run frente a Task.Factory.StartNew en el blog Programación en paralelo con .NET.

Consulte también

Se aplica a

.NET 7 y otras versiones

Producto	Versiones
.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
.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
.NET Standard	1.0, 1.1, 1.2, 1.3, 1.4, 1.6, 2.0, 2.1
UWP	10.0

StartNew<TResult>(Func<TResult>)

Crea e inicia una tarea de tipo TResult para el delegado de función especificado.

public:
generic <typename TResult>
 System::Threading::Tasks::Task<TResult> ^ StartNew(Func<TResult> ^ function);

public System.Threading.Tasks.Task<TResult> StartNew<TResult> (Func<TResult> function);

member this.StartNew : Func<'Result> -> System.Threading.Tasks.Task<'Result>

Public Function StartNew(Of TResult) (function As Func(Of TResult)) As Task(Of TResult)

Parámetros de tipo

TResult

Tipo del resultado disponible a través de la tarea.

Parámetros

function: Func<TResult>

Delegado de función que devuelve el resultado futuro que va a estar disponible a través de la tarea.

Devoluciones

Task<TResult>

La tarea iniciada.

Excepciones

ArgumentNullException

El argumento function es null.

Ejemplos

El ejemplo siguiente es una aplicación de adición sencilla que genera dos números aleatorios y pide al usuario que escriba su suma. A continuación, indica si la respuesta es correcta o, si la respuesta del usuario no es un número válido, pide al usuario que vuelva a escribir un número válido. StartNew se usa para crear los Task<TResult> objetos que devuelven los números aleatorios que se van a agregar.

using System;
using System.Threading.Tasks;

public class Example
{
   public static void Main()
   {
      Random rnd = new Random();
      Task<int>[] tasks = new Task<int>[2];
      Object obj = new Object();
      
      while (true) {
         for (int ctr = 0; ctr <= 1; ctr++)
            tasks[ctr] = Task.Factory.StartNew(() => { int i = 0;
                                                       lock(obj) {
                                                          i = rnd.Next(101);
                                                       }
                                                       return i; });

         Task.WaitAll(tasks);
         int n1 = tasks[0].Result;
         int n2 = tasks[1].Result;
         int result = n1 + n2;
         bool validInput = false;
         while (! validInput) {
            ShowMessage(n1, n2);
            string userInput = Console.ReadLine();
            // Process user input.
            if (userInput.Trim().ToUpper() == "X") return;
            int answer;
            validInput = Int32.TryParse(userInput, out answer);
            if (! validInput)
               Console.WriteLine("Invalid input. Try again, but enter only numbers. ");
            else if (answer == result)
               Console.WriteLine("Correct!");
            else
               Console.WriteLine("Incorrect. The correct answer is {0}.", result);
         }
      }
   }

   private static void ShowMessage(int n1, int n2)
   {
      Console.WriteLine("\nEnter 'x' to exit...");
      Console.Write("{0} + {1} = ", n1, n2);
   }
}
// The example displays the following output:
//       Enter 'x' to exit...
//       15 + 11 = 26
//       Correct!
//
//       Enter 'x' to exit...
//       75 + 33 = adc
//       Invalid input. Try again, but enter only numbers.
//
//       Enter 'x' to exit...
//       75 + 33 = 108
//       Correct!
//
//       Enter 'x' to exit...
//       67 + 55 = 133
//       Incorrect. The correct answer is 122.
//
//       Enter 'x' to exit...
//       92 + 51 = 133
//       Incorrect. The correct answer is 143.
//
//       Enter 'x' to exit...
//       81 + 65 = x

   
Imports System.Threading.Tasks

Module AdditionTester
   Public Sub Main()
      Dim rnd As New Random()
      Dim tasks(1) As Task(Of Integer)
      Dim obj As New Object()
      
      Do While True
         For ctr As Integer = 0 To 1
            tasks(ctr) = Task.Factory.StartNew(Function()
                                                  Dim i As Integer
                                                  SyncLock(obj)
                                                     i = rnd.Next(101)
                                                  End SyncLock
                                                  Return i
                                               End Function)
         Next
         Task.WaitAll(tasks)
         Dim n1 As Integer = tasks(0).Result
         Dim n2 As Integer = tasks(1).Result
         Dim result As Integer = n1 + n2
         Dim validInput As Boolean = False
         Do While Not validInput
            ShowMessage(n1, n2)
            Dim userInput As String = Console.ReadLine()
            ' Process user input.
            If userInput.Trim().ToUpper = "X" Then Exit Sub
            Dim answer As Integer
            validInput = Int32.TryParse(userInput, answer)
            If Not validInput Then
               Console.WriteLine("Invalid input. Try again, but enter only numbers. ")
            Else If answer = result Then
               Console.WriteLine("Correct!")
            Else
               Console.WriteLine("Incorrect. The correct answer is {0}.", result)
            End If
         Loop
      Loop
   End Sub
   
   Private Sub ShowMessage(n1 As Integer, n2 As Integer)
      Console.WriteLine()
      Console.WriteLine("Enter 'x' to exit...")
      Console.Write("{0} + {1} = ", n1, n2)
   End Sub
End Module
' The example displays output like the following:
'       Enter 'x' to exit...
'       15 + 11 = 26
'       Correct!
'
'       Enter 'x' to exit...
'       75 + 33 = adc
'       Invalid input. Try again, but enter only numbers.
'
'       Enter 'x' to exit...
'       75 + 33 = 108
'       Correct!
'
'       Enter 'x' to exit...
'       67 + 55 = 133
'       Incorrect. The correct answer is 122.
'
'       Enter 'x' to exit...
'       92 + 51 = 133
'       Incorrect. The correct answer is 143.
'
'       Enter 'x' to exit...
'       81 + 65 = x

Comentarios

Llamar StartNew a es funcionalmente equivalente a crear un Task<TResult> mediante uno de sus constructores y, a continuación, llamar Start a para programarlo para su ejecución.

A partir de la .NET Framework 4.5, puede llamar al Task.Run<TResult>(Func<TResult>) método como una manera rápida de llamar StartNew a con parámetros predeterminados. Sin embargo, tenga en cuenta que hay una diferencia en el comportamiento entre los dos métodos relacionados con : Task.Run<TResult>(Func<TResult>) de forma predeterminada no permite que las tareas secundarias se inicien con la TaskCreationOptions.AttachedToParent opción de adjuntar a la instancia actual Task<TResult> , mientras StartNew<TResult>(Func<TResult>) que sí. Para obtener más información y ejemplos de código, vea la entrada Task.Run vs. Task.Factory.StartNew en el blog Programación en paralelo con .NET.

Consulte también

Se aplica a

.NET 7 y otras versiones

Producto	Versiones
.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
.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
.NET Standard	1.0, 1.1, 1.2, 1.3, 1.4, 1.6, 2.0, 2.1
UWP	10.0

StartNew<TResult>(Func<Object,TResult>, Object)

Crea e inicia una tarea de tipo TResult para el delegado y el estado de función especificados.

public:
generic <typename TResult>
 System::Threading::Tasks::Task<TResult> ^ StartNew(Func<System::Object ^, TResult> ^ function, System::Object ^ state);

public System.Threading.Tasks.Task<TResult> StartNew<TResult> (Func<object,TResult> function, object state);

public System.Threading.Tasks.Task<TResult> StartNew<TResult> (Func<object?,TResult> function, object? state);

member this.StartNew : Func<obj, 'Result> * obj -> System.Threading.Tasks.Task<'Result>

Public Function StartNew(Of TResult) (function As Func(Of Object, TResult), state As Object) As Task(Of TResult)

Parámetros de tipo

TResult

Tipo del resultado disponible a través de la tarea.

Parámetros

function: Func<Object,TResult>

Delegado de función que devuelve el resultado futuro que va a estar disponible a través de la tarea.

state: Object

Objeto que contiene los datos que el delegado de function va a usar.

Devoluciones

Task<TResult>

La tarea iniciada.

Excepciones

ArgumentNullException

function es null.

Comentarios

Llamar a StartNew es funcionalmente equivalente a crear un Task<TResult> mediante uno de sus constructores y, a continuación, llamar Start a para programarlo para su ejecución.

A partir de la .NET Framework 4.5, puede usar el Run método con un Action objeto como una manera rápida de llamar StartNew con parámetros predeterminados. Para obtener más información y ejemplos de código, vea la entrada Task.Run vs. Task.Factory.StartNew en el blog Programación en paralelo con .NET.

Consulte también

Se aplica a

.NET 7 y otras versiones

Producto	Versiones
.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
.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
.NET Standard	1.0, 1.1, 1.2, 1.3, 1.4, 1.6, 2.0, 2.1
UWP	10.0

StartNew<TResult>(Func<TResult>, CancellationToken)

Crea e inicia una tarea de tipo TResult para el delegado de función y el token de cancelación especificados.

public:
generic <typename TResult>
 System::Threading::Tasks::Task<TResult> ^ StartNew(Func<TResult> ^ function, System::Threading::CancellationToken cancellationToken);

public System.Threading.Tasks.Task<TResult> StartNew<TResult> (Func<TResult> function, System.Threading.CancellationToken cancellationToken);

member this.StartNew : Func<'Result> * System.Threading.CancellationToken -> System.Threading.Tasks.Task<'Result>

Public Function StartNew(Of TResult) (function As Func(Of TResult), cancellationToken As CancellationToken) As Task(Of TResult)

Parámetros de tipo

TResult

Tipo del resultado disponible a través de la tarea.

Parámetros

function: Func<TResult>

Delegado de función que devuelve el resultado futuro que va a estar disponible a través de la tarea.

cancellationToken: CancellationToken

Token de cancelación que se va a asignar a la nueva tarea.

Devoluciones

Task<TResult>

La tarea iniciada.

Excepciones

ObjectDisposedException

Ya se eliminó el CancellationToken proporcionado.

ArgumentNullException

function es null.

Ejemplos

En el ejemplo siguiente se usan dos tareas para calcular la secuencia de Fibonacci que termina en F100 = F100-1 + F100-2 con valores de inicialización F1= 1, F2 = 1 y F1 = 0, F2= 1. Aproximadamente la mitad del tiempo, se establece un token de cancelación a medida que se ejecutan las operaciones. La salida del ejemplo muestra el resultado si las dos tareas se completan correctamente y si se cancela el token.

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

public class Example
{
   public static void Main()
   {
      var rnd = new Random();
      var tasks = new List<Task<BigInteger[]>>();
      var source = new CancellationTokenSource();
      var token = source.Token;
      for (int ctr = 0; ctr <= 1; ctr++) {
         int start = ctr;
         tasks.Add(Task.Run( () => { BigInteger[] sequence = new BigInteger[100];
                                     sequence[0] = start;
                                     sequence[1] = 1;
                                     for (int index = 2; index <= sequence.GetUpperBound(0); index++) {
                                        token.ThrowIfCancellationRequested();
                                        sequence[index] = sequence[index - 1] + sequence[index - 2];
                                     }
                                     return sequence;
                                   }, token));
      }
      if (rnd.Next(0, 2) == 1)
         source.Cancel();
      try {
         Task.WaitAll(tasks.ToArray());
         foreach (var t in tasks)
            Console.WriteLine("{0}, {1}...{2:N0}", t.Result[0], t.Result[1],
                              t.Result[99]);
      }
      catch (AggregateException e) {
         foreach (var ex in e.InnerExceptions)
            Console.WriteLine("{0}: {1}", ex.GetType().Name, ex.Message);
      }
   }
}
// The example displays either the following output:
//    0, 1...218,922,995,834,555,169,026
//    1, 1...354,224,848,179,261,915,075
// or the following output:
//    TaskCanceledException: A task was canceled.
//    TaskCanceledException: A task was canceled.

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

Module Example
   Public Sub Main()
      Dim rnd As New Random()
      Dim tasks As New List(Of Task(Of BigInteger()))
      Dim source As New CancellationTokenSource
      Dim token As CancellationToken = source.Token
      For ctr As Integer = 0 To 1
         Dim start As Integer = ctr
         tasks.Add(Task.Run(Function()
                               Dim sequence(99) As BigInteger
                               sequence(0) = start
                               sequence(1) = 1
                               For index As Integer = 2 To sequence.GetUpperBound(0)
                                  token.ThrowIfCancellationRequested()
                                  sequence(index) = sequence(index - 1) + sequence(index - 2)
                               Next
                               Return sequence
                            End Function, token))
      Next
      If rnd.Next(0, 2) = 1 Then source.Cancel
      Try
         Task.WaitAll(tasks.ToArray())
         For Each t In tasks
            Console.WriteLine("{0}, {1}...{2:N0}", t.Result(0), t.Result(1),
                              t.Result(99))
         Next
      Catch e As AggregateException
         For Each ex In e.InnerExceptions
            Console.WriteLine("{0}: {1}", ex.GetType().Name, ex.Message)
         Next
      End Try
   End Sub
End Module
' The example displays either the following output:
'    0, 1...218,922,995,834,555,169,026
'    1, 1...354,224,848,179,261,915,075
' or the following output:
'    TaskCanceledException: A task was canceled.
'    TaskCanceledException: A task was canceled.

Comentarios

Llamar StartNew a es funcionalmente equivalente a crear un Task<TResult> mediante uno de sus constructores y, a continuación, llamar Start a para programarlo para su ejecución.

A partir de la .NET Framework 4.5, puede usar el Task.Run<TResult>(Func<TResult>, CancellationToken) método como una manera rápida de llamar StartNew<TResult>(Func<TResult>, CancellationToken) con parámetros predeterminados. Sin embargo, tenga en cuenta que hay una diferencia en el comportamiento entre los dos métodos relacionados con : Task.Run<TResult>(Func<TResult>, CancellationToken) de forma predeterminada no permite que las tareas secundarias se inicien con la TaskCreationOptions.AttachedToParent opción de adjuntar a la instancia actual Task<TResult> , mientras StartNew<TResult>(Func<TResult>, CancellationToken) que sí. Para obtener más información y ejemplos de código, vea la entrada Task.Run vs. Task.Factory.StartNew en el blog Programación en paralelo con .NET.

Consulte también

Se aplica a

.NET 7 y otras versiones

Producto	Versiones
.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
.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
.NET Standard	1.0, 1.1, 1.2, 1.3, 1.4, 1.6, 2.0, 2.1
UWP	10.0

StartNew<TResult>(Func<TResult>, TaskCreationOptions)

Crea e inicia una tarea de tipo TResult para las opciones de creación y delegado de función especificadas.

public:
generic <typename TResult>
 System::Threading::Tasks::Task<TResult> ^ StartNew(Func<TResult> ^ function, System::Threading::Tasks::TaskCreationOptions creationOptions);

public System.Threading.Tasks.Task<TResult> StartNew<TResult> (Func<TResult> function, System.Threading.Tasks.TaskCreationOptions creationOptions);

member this.StartNew : Func<'Result> * System.Threading.Tasks.TaskCreationOptions -> System.Threading.Tasks.Task<'Result>

Public Function StartNew(Of TResult) (function As Func(Of TResult), creationOptions As TaskCreationOptions) As Task(Of TResult)

Parámetros de tipo

TResult

Tipo del resultado disponible a través de la tarea.

Parámetros

function: Func<TResult>

Delegado de función que devuelve el resultado futuro que va a estar disponible a través de la tarea.

creationOptions: TaskCreationOptions

Uno de los valores de enumeración que controla el comportamiento de la tarea creada.

Devoluciones

Task<TResult>

La tarea iniciada.

Excepciones

ArgumentNullException

function es null.

ArgumentOutOfRangeException

Comentarios

Llamar a StartNew es funcionalmente equivalente a crear mediante Task<TResult> uno de sus constructores y, a continuación, llamar Start a para programarlo para su ejecución.

A partir de la .NET Framework 4.5, puede usar el Run método con un Action objeto como una manera rápida de llamar StartNew a con parámetros predeterminados. Para obtener más información y ejemplos de código, vea la entrada Task.Run frente a Task.Factory.StartNew en el blog Programación en paralelo con .NET.

Consulte también

Se aplica a

.NET 7 y otras versiones

Producto	Versiones
.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
.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
.NET Standard	1.0, 1.1, 1.2, 1.3, 1.4, 1.6, 2.0, 2.1
UWP	10.0

StartNew<TResult>(Func<Object,TResult>, Object, CancellationToken)

Crea e inicia una tarea de tipo TResult para el delegado de función, el estado y el token de cancelación especificados.

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

public System.Threading.Tasks.Task<TResult> StartNew<TResult> (Func<object,TResult> function, object state, System.Threading.CancellationToken cancellationToken);

public System.Threading.Tasks.Task<TResult> StartNew<TResult> (Func<object?,TResult> function, object? state, System.Threading.CancellationToken cancellationToken);

member this.StartNew : Func<obj, 'Result> * obj * System.Threading.CancellationToken -> System.Threading.Tasks.Task<'Result>

Public Function StartNew(Of TResult) (function As Func(Of Object, TResult), state As Object, cancellationToken As CancellationToken) As Task(Of TResult)

Parámetros de tipo

TResult

Tipo del resultado disponible a través de la tarea.

Parámetros

function: Func<Object,TResult>

Delegado de función que devuelve el resultado futuro que va a estar disponible a través de la tarea.

state: Object

Objeto que contiene los datos que el delegado de function va a usar.

cancellationToken: CancellationToken

Token de cancelación que se va a asignar a la nueva tarea.

Devoluciones

Task<TResult>

La tarea iniciada.

Excepciones

ObjectDisposedException

Ya se eliminó el CancellationToken proporcionado.

ArgumentNullException

function es null.

Comentarios

Llamar a StartNew es funcionalmente equivalente a crear mediante Task<TResult> uno de sus constructores y, a continuación, llamar Start a para programarlo para su ejecución.

A partir de la .NET Framework 4.5, puede usar el Run método con un Action objeto como una manera rápida de llamar StartNew a con parámetros predeterminados. Para obtener más información y ejemplos de código, vea la entrada Task.Run frente a Task.Factory.StartNew en el blog Programación en paralelo con .NET.

Consulte también

Se aplica a

.NET 7 y otras versiones

Producto	Versiones
.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
.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
.NET Standard	1.0, 1.1, 1.2, 1.3, 1.4, 1.6, 2.0, 2.1
UWP	10.0

StartNew<TResult>(Func<Object,TResult>, Object, TaskCreationOptions)

Crea e inicia una tarea de tipo TResult para las opciones de delegado de función, estado y creación especificadas.

public:
generic <typename TResult>
 System::Threading::Tasks::Task<TResult> ^ StartNew(Func<System::Object ^, TResult> ^ function, System::Object ^ state, System::Threading::Tasks::TaskCreationOptions creationOptions);

public System.Threading.Tasks.Task<TResult> StartNew<TResult> (Func<object,TResult> function, object state, System.Threading.Tasks.TaskCreationOptions creationOptions);

public System.Threading.Tasks.Task<TResult> StartNew<TResult> (Func<object?,TResult> function, object? state, System.Threading.Tasks.TaskCreationOptions creationOptions);

member this.StartNew : Func<obj, 'Result> * obj * System.Threading.Tasks.TaskCreationOptions -> System.Threading.Tasks.Task<'Result>

Public Function StartNew(Of TResult) (function As Func(Of Object, TResult), state As Object, creationOptions As TaskCreationOptions) As Task(Of TResult)

Parámetros de tipo

TResult

Tipo del resultado disponible a través de la tarea.

Parámetros

function: Func<Object,TResult>

Delegado de función que devuelve el resultado futuro que va a estar disponible a través de la tarea.

state: Object

Objeto que contiene los datos que el delegado de function va a usar.

creationOptions: TaskCreationOptions

Uno de los valores de enumeración que controla el comportamiento de la tarea creada.

Devoluciones

Task<TResult>

La tarea iniciada.

Excepciones

ArgumentNullException

function es null.

ArgumentOutOfRangeException

Comentarios

Llamar a StartNew es funcionalmente equivalente a crear mediante Task<TResult> uno de sus constructores y, a continuación, llamar Start a para programarlo para su ejecución.

A partir de la .NET Framework 4.5, puede usar el Run método con un Action objeto como una manera rápida de llamar StartNew a con parámetros predeterminados. Para obtener más información y ejemplos de código, vea la entrada Task.Run frente a Task.Factory.StartNew en el blog Programación en paralelo con .NET.

Consulte también

Se aplica a

.NET 7 y otras versiones

Producto	Versiones
.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
.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
.NET Standard	1.0, 1.1, 1.2, 1.3, 1.4, 1.6, 2.0, 2.1
UWP	10.0

StartNew<TResult>(Func<Object,TResult>, Object, CancellationToken, TaskCreationOptions, TaskScheduler)

Crea e inicia una tarea de tipo TResult para el delegado de función, el estado, el token de cancelación, las opciones de creación y el programador de tareas especificados.

public:
generic <typename TResult>
 System::Threading::Tasks::Task<TResult> ^ StartNew(Func<System::Object ^, TResult> ^ function, System::Object ^ state, System::Threading::CancellationToken cancellationToken, System::Threading::Tasks::TaskCreationOptions creationOptions, System::Threading::Tasks::TaskScheduler ^ scheduler);

public System.Threading.Tasks.Task<TResult> StartNew<TResult> (Func<object,TResult> function, object state, System.Threading.CancellationToken cancellationToken, System.Threading.Tasks.TaskCreationOptions creationOptions, System.Threading.Tasks.TaskScheduler scheduler);

public System.Threading.Tasks.Task<TResult> StartNew<TResult> (Func<object?,TResult> function, object? state, System.Threading.CancellationToken cancellationToken, System.Threading.Tasks.TaskCreationOptions creationOptions, System.Threading.Tasks.TaskScheduler scheduler);

member this.StartNew : Func<obj, 'Result> * obj * System.Threading.CancellationToken * System.Threading.Tasks.TaskCreationOptions * System.Threading.Tasks.TaskScheduler -> System.Threading.Tasks.Task<'Result>

Public Function StartNew(Of TResult) (function As Func(Of Object, TResult), state As Object, cancellationToken As CancellationToken, creationOptions As TaskCreationOptions, scheduler As TaskScheduler) As Task(Of TResult)

Parámetros de tipo

TResult

Tipo del resultado disponible a través de la tarea.

Parámetros

function: Func<Object,TResult>

Delegado de función que devuelve el resultado futuro que va a estar disponible a través de la tarea.

state: Object

Objeto que contiene los datos que el delegado de function va a usar.

cancellationToken: CancellationToken

Token de cancelación que se va a asignar a la nueva tarea.

creationOptions: TaskCreationOptions

Uno de los valores de enumeración que controla el comportamiento de la tarea creada.

scheduler: TaskScheduler

Programador de tareas que se usó para programar la tarea creada.

Devoluciones

Task<TResult>

La tarea iniciada.

Excepciones

ObjectDisposedException

Ya se eliminó el CancellationToken proporcionado.

ArgumentNullException

function es null.

O bien scheduler es null.

ArgumentOutOfRangeException

Comentarios

Llamar a StartNew es funcionalmente equivalente a crear mediante Task<TResult> uno de sus constructores y, a continuación, llamar Start a para programarlo para su ejecución.

A partir de la .NET Framework 4.5, puede usar el Run método con un Action objeto como una manera rápida de llamar StartNew a con parámetros predeterminados. Para obtener más información y ejemplos de código, vea la entrada Task.Run frente a Task.Factory.StartNew en el blog Programación en paralelo con .NET.

Consulte también

Se aplica a

.NET 7 y otras versiones

Producto	Versiones
.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
.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
.NET Standard	1.0, 1.1, 1.2, 1.3, 1.4, 1.6, 2.0, 2.1
UWP	10.0

Compartir a través de

TaskFactory.StartNew Método

Definición

Sobrecargas

Comentarios

StartNew(Action<Object>, Object, CancellationToken, TaskCreationOptions, TaskScheduler)

Parámetros

Devoluciones

Excepciones

Comentarios

Consulte también

Se aplica a

StartNew(Action, CancellationToken, TaskCreationOptions, TaskScheduler)

Parámetros

Devoluciones

Excepciones

Comentarios

Consulte también

Se aplica a

StartNew(Action<Object>, Object, TaskCreationOptions)

Parámetros

Devoluciones

Excepciones

Comentarios

Consulte también

Se aplica a

StartNew(Action<Object>, Object, CancellationToken)

Parámetros

Devoluciones

Excepciones

Ejemplos

Comentarios

Consulte también

Se aplica a

StartNew(Action, CancellationToken)

Parámetros

Devoluciones

Excepciones

Ejemplos

Comentarios

Consulte también

Se aplica a

StartNew(Action, TaskCreationOptions)

Parámetros

Devoluciones

Excepciones

Comentarios

Consulte también

Se aplica a

StartNew(Action)

Parámetros

Devoluciones

Excepciones

Ejemplos

Comentarios

Consulte también

Se aplica a

StartNew(Action<Object>, Object)

Parámetros

Devoluciones

Excepciones

Ejemplos

Comentarios

Consulte también

Se aplica a

StartNew<TResult>(Func<TResult>, CancellationToken, TaskCreationOptions, TaskScheduler)

Parámetros de tipo

Parámetros

Devoluciones

Excepciones

Comentarios

Consulte también

Se aplica a

StartNew<TResult>(Func<TResult>)

Parámetros de tipo

Parámetros

Devoluciones

Excepciones

Ejemplos

Comentarios