Task<TResult> Task<TResult> Task<TResult> Task<TResult> Constructors

Definición

Sobrecargas

Task<TResult>(Func<TResult>) Task<TResult>(Func<TResult>) Task<TResult>(Func<TResult>) Task<TResult>(Func<TResult>)

Inicializa una nueva Task<TResult> con la función especificada.Initializes a new Task<TResult> with the specified function.

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

Inicializa una nueva instancia de Task<TResult> con la función y el estado especificados.Initializes a new Task<TResult> with the specified function and state.

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

Inicializa una nueva Task<TResult> con la función especificada.Initializes a new Task<TResult> with the specified function.

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

Inicializa una nueva Task<TResult> con la función y las opciones de creación especificadas.Initializes a new Task<TResult> with the specified function and creation options.

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

Inicializa un nuevo objeto Task<TResult> con la acción, el estado y las opciones especificados.Initializes a new Task<TResult> with the specified action, state, and options.

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

Inicializa un nuevo objeto Task<TResult> con la acción, el estado y las opciones especificados.Initializes a new Task<TResult> with the specified action, state, and options.

Task<TResult>(Func<TResult>, CancellationToken, TaskCreationOptions) Task<TResult>(Func<TResult>, CancellationToken, TaskCreationOptions) Task<TResult>(Func<TResult>, CancellationToken, TaskCreationOptions)

Inicializa una nueva Task<TResult> con la función y las opciones de creación especificadas.Initializes a new Task<TResult> with the specified function and creation options.

Task<TResult>(Func<Object,TResult>, Object, CancellationToken, TaskCreationOptions) Task<TResult>(Func<Object,TResult>, Object, CancellationToken, TaskCreationOptions) Task<TResult>(Func<Object,TResult>, Object, CancellationToken, TaskCreationOptions)

Inicializa un nuevo objeto Task<TResult> con la acción, el estado y las opciones especificados.Initializes a new Task<TResult> with the specified action, state, and options.

Task<TResult>(Func<TResult>) Task<TResult>(Func<TResult>) Task<TResult>(Func<TResult>) Task<TResult>(Func<TResult>)

Inicializa una nueva Task<TResult> con la función especificada.Initializes a new Task<TResult> with the specified function.

public:
 Task(Func<TResult> ^ function);
public Task (Func<TResult> function);
new System.Threading.Tasks.Task<'Result> : Func<'Result> -> System.Threading.Tasks.Task<'Result>
Public Sub New (function As Func(Of TResult))

Parámetros

function
Func<TResult> Func<TResult> Func<TResult> Func<TResult>

El delegado que representa el código que se va a ejecutar en la tarea.The delegate that represents the code to execute in the task. Cuando se complete la función, se establecerá la propiedad Result de la tarea para que se devuelva el valor de resultado de la función.When the function has completed, the task's Result property will be set to return the result value of the function.

Excepciones

El argumento function es null.The function argument is null.

El argumento function es null.The function argument is null.

Ejemplos

El ejemplo siguiente cuenta el número aproximado de palabras en los archivos de texto que representan libros publicados.The following example counts the approximate number of words in text files that represent published books. Cada tarea es responsable de abrir un archivo, leer todo su contenido de forma asincrónica y calcular el recuento de palabras mediante el uso de una expresión regular.Each task is responsible for opening a file, reading its entire contents asynchronously, and calculating the word count by using a regular expression. El Task.WaitAll(Task[]) método se llama para asegurarse de que se han completado todas las tareas antes de mostrar el recuento de palabras de cada libro en la consola.The Task.WaitAll(Task[]) method is called to ensure that all tasks have completed before displaying the word count of each book to the console.

Creación de instancias de objeto se separa de objetos de la ejecución en este ejemplo, para que el ejemplo puede asegurarse de que cada archivo existe.Object instantiation is separated from object execution in this example so that the example can ensure that each file exists. Si no lo hace, muestra el nombre del archivo que falta.If they do not, it displays the name of the missing file. De lo contrario, llama el Task.Start método para iniciar cada tarea.Otherwise, it calls the Task.Start method to launch each task.

using System;
using System.IO;
using System.Text.RegularExpressions;
using System.Threading.Tasks;

public class Example
{
   public static async Task Main()
   {
      string pattern = @"\p{P}*\s+";
      string[] titles = { "Sister Carrie", "The Financier" };
      Task<int>[] tasks = new Task<int>[titles.Length];

      for (int ctr = 0; ctr < titles.Length; ctr++) {
         string s = titles[ctr];
         tasks[ctr] = new Task<int>( () => {
                                   // Number of words.
                                   int nWords = 0;
                                   // Create filename from title.
                                   string fn = s + ".txt";

                                   StreamReader sr = new StreamReader(fn);
                                   string input = sr.ReadToEndAsync().Result;
                                   sr.Close();
                                   nWords = Regex.Matches(input, pattern).Count;
                                   return nWords;
                                } );
      }
      // Ensure files exist before launching tasks.
      bool allExist = true;
      foreach (var title in titles) {
         string fn = title + ".txt";
         if (! File.Exists(fn)) {
            allExist = false;
            Console.WriteLine("Cannot find '{0}'", fn);
            break;
         }   
      }
      // Launch tasks 
      if (allExist) {
         foreach (var t in tasks)
            t.Start();
      
        await Task.WhenAll(tasks);
  
        Console.WriteLine("Word Counts:\n");
        for (int ctr = 0; ctr < titles.Length; ctr++)
           Console.WriteLine("{0}: {1,10:N0} words", titles[ctr], tasks[ctr].Result);
      }   
   }
}
// The example displays the following output:
//       Sister Carrie:    159,374 words
//       The Financier:    196,362 words
Imports System.IO
Imports System.Text.RegularExpressions
Imports System.Threading.Tasks

Module Example
   Public Sub Main()
      Dim pattern As String = "\p{P}*\s+"
      Dim titles() As String = { "Sister Carrie",
                                 "The Financier" }
      Dim tasks(titles.Length - 1) As Task(Of Integer)

      For ctr As Integer = 0 To titles.Length - 1
         Dim s As String = titles(ctr)
         tasks(ctr) = New Task(Of Integer)( Function()
                                   ' Number of words.
                                   Dim nWords As Integer = 0
                                   ' Create filename from title.
                                   Dim fn As String = s + ".txt"

                                   Dim sr As New StreamReader(fn)
                                   Dim input As String = sr.ReadToEndAsync().Result
                                   sr.Close()
                                   nWords = Regex.Matches(input, pattern).Count
                                   Return nWords
                                End Function)
      Next

      ' Ensure files exist before launching tasks.
      Dim allExist As Boolean = True
      For Each title In titles
         Dim fn As String = title + ".txt"
         If Not File.Exists(fn) Then
            allExist = false
            Console.WriteLine("Cannot find '{0}'", fn)
            Exit For
         End If   
      Next
      ' Launch tasks 
      If allExist Then
         For Each t in tasks
            t.Start()
         Next
         Task.WaitAll(tasks)

         Console.WriteLine("Word Counts:")
         Console.WriteLine()
         For ctr As Integer = 0 To titles.Length - 1
         Console.WriteLine("{0}: {1,10:N0} words", titles(ctr), tasks(ctr).Result)
         Next
      End If   
   End Sub
End Module
' The example displays the following output:
'       Sister Carrie:    159,374 words
'       The Financier:    196,362 words

El patrón de expresión regular \p{P}*\s+ coincide con cero, uno o más caracteres de puntuación, seguidos de uno o varios caracteres de espacio en blanco.The regular expression pattern \p{P}*\s+ matches zero, one, or more punctuation characters followed by one or more white-space characters. Se supone que el número total de coincidencias es igual que el recuento de palabras aproximado.It assumes that the total number of matches equals the approximate word count.

Comentarios

Este constructor sólo debe utilizarse en escenarios avanzados donde es necesario que la creación y el inicio de la tarea está separada.This constructor should only be used in advanced scenarios where it is required that the creation and starting of the task is separated.

En lugar de llamar a este constructor, la manera más común para crear instancias de un Task<TResult> objeto e iniciar una tarea es mediante una llamada a estático Task.Run<TResult>(Func<TResult>) y TaskFactory<TResult>.StartNew(Func<TResult>) métodos.Rather than calling this constructor, the most common way to instantiate a Task<TResult> object and launch a task is by calling the static Task.Run<TResult>(Func<TResult>) and TaskFactory<TResult>.StartNew(Func<TResult>) methods.

Si una tarea sin ninguna acción es necesaria solo para el consumidor de una API para obtener algo parecido a await, un TaskCompletionSource<TResult> debe usarse.If a task with no action is needed just for the consumer of an API to have something to await, a TaskCompletionSource<TResult> should be used.

Consulte también:

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

Inicializa una nueva instancia de Task<TResult> con la función y el estado especificados.Initializes a new Task<TResult> with the specified function and state.

public:
 Task(Func<System::Object ^, TResult> ^ function, System::Object ^ state);
public Task (Func<object,TResult> function, object state);
new System.Threading.Tasks.Task<'Result> : Func<obj, 'Result> * obj -> System.Threading.Tasks.Task<'Result>
Public Sub New (function As Func(Of Object, TResult), state As Object)

Parámetros

function
Func<Object,TResult>

El delegado que representa el código que se va a ejecutar en la tarea.The delegate that represents the code to execute in the task. Cuando se complete la función, se establecerá la propiedad Result de la tarea para que se devuelva el valor de resultado de la función.When the function has completed, the task's Result property will be set to return the result value of the function.

state
Object Object Object Object

Objeto que representa los datos que la acción va a usar.An object representing data to be used by the action.

Excepciones

El argumento function es null.The function argument is null.

El argumento function es null.The function argument is null.

Comentarios

En lugar de llamar a este constructor, la manera más común para crear instancias de un Task<TResult> objeto e iniciar una tarea es mediante una llamada a estático TaskFactory<TResult>.StartNew(Func<Object,TResult>, Object) método.Rather than calling this constructor, the most common way to instantiate a Task<TResult> object and launch a task is by calling the static TaskFactory<TResult>.StartNew(Func<Object,TResult>, Object) method. La única ventaja que ofrece este constructor es que permite la creación de instancias de objeto para separarse de invocación de la tarea.The only advantage offered by this constructor is that it allows object instantiation to be separated from task invocation.

Consulte también:

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

Inicializa una nueva Task<TResult> con la función especificada.Initializes a new Task<TResult> with the specified function.

public:
 Task(Func<TResult> ^ function, System::Threading::CancellationToken cancellationToken);
public Task (Func<TResult> function, System.Threading.CancellationToken cancellationToken);
new System.Threading.Tasks.Task<'Result> : Func<'Result> * System.Threading.CancellationToken -> System.Threading.Tasks.Task<'Result>

Parámetros

function
Func<TResult> Func<TResult> Func<TResult> Func<TResult>

El delegado que representa el código que se va a ejecutar en la tarea.The delegate that represents the code to execute in the task. Cuando se complete la función, se establecerá la propiedad Result de la tarea para que se devuelva el valor de resultado de la función.When the function has completed, the task's Result property will be set to return the result value of the function.

cancellationToken
CancellationToken CancellationToken CancellationToken CancellationToken

CancellationToken que se va a asignar a esta tarea.The CancellationToken to be assigned to this task.

Excepciones

El CancellationTokenSource que creó cancellationToken ya se ha eliminado.The CancellationTokenSource that created cancellationToken has already been disposed.

El argumento function es null.The function argument is null.

El argumento function es null.The function argument is null.

Comentarios

En lugar de llamar a este constructor, la manera más común para crear instancias de un Task<TResult> objeto e iniciar una tarea es mediante una llamada a estático Task.Run<TResult>(Func<TResult>, CancellationToken) y TaskFactory<TResult>.StartNew(Func<TResult>, CancellationToken) métodos.Rather than calling this constructor, the most common way to instantiate a Task<TResult> object and launch a task is by calling the static Task.Run<TResult>(Func<TResult>, CancellationToken) and TaskFactory<TResult>.StartNew(Func<TResult>, CancellationToken) methods. La única ventaja que ofrece este constructor es que permite la creación de instancias de objeto para separarse de invocación de la tarea.The only advantage offered by this constructor is that it allows object instantiation to be separated from task invocation.

Consulte también:

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

Inicializa una nueva Task<TResult> con la función y las opciones de creación especificadas.Initializes a new Task<TResult> with the specified function and creation options.

public:
 Task(Func<TResult> ^ function, System::Threading::Tasks::TaskCreationOptions creationOptions);
public Task (Func<TResult> function, System.Threading.Tasks.TaskCreationOptions creationOptions);
new System.Threading.Tasks.Task<'Result> : Func<'Result> * System.Threading.Tasks.TaskCreationOptions -> System.Threading.Tasks.Task<'Result>
Public Sub New (function As Func(Of TResult), creationOptions As TaskCreationOptions)

Parámetros

function
Func<TResult> Func<TResult> Func<TResult> Func<TResult>

El delegado que representa el código que se va a ejecutar en la tarea.The delegate that represents the code to execute in the task. Cuando se complete la función, se establecerá la propiedad Result de la tarea para que se devuelva el valor de resultado de la función.When the function has completed, the task's Result property will be set to return the result value of the function.

creationOptions
TaskCreationOptions TaskCreationOptions TaskCreationOptions TaskCreationOptions

El objeto TaskCreationOptions que se usa para personalizar el comportamiento de la tarea.The TaskCreationOptions used to customize the task's behavior.

Excepciones

El argumento creationOptions especifica un valor no válido para TaskCreationOptions.The creationOptions argument specifies an invalid value for TaskCreationOptions.

El argumento function es null.The function argument is null.

El argumento function es null.The function argument is null.

Comentarios

En lugar de llamar a este constructor, la manera más común para crear instancias de un Task<TResult> objeto e iniciar una tarea es mediante una llamada a estático TaskFactory<TResult>.StartNew(Func<TResult>, TaskCreationOptions) método.Rather than calling this constructor, the most common way to instantiate a Task<TResult> object and launch a task is by calling the static TaskFactory<TResult>.StartNew(Func<TResult>, TaskCreationOptions) method. La única ventaja que ofrece este constructor es que permite la creación de instancias de objeto para separarse de invocación de la tarea.The only advantage offered by this constructor is that it allows object instantiation to be separated from task invocation.

Consulte también:

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

Inicializa un nuevo objeto Task<TResult> con la acción, el estado y las opciones especificados.Initializes a new Task<TResult> with the specified action, state, and options.

public:
 Task(Func<System::Object ^, TResult> ^ function, System::Object ^ state, System::Threading::CancellationToken cancellationToken);
public Task (Func<object,TResult> function, object state, System.Threading.CancellationToken cancellationToken);
new System.Threading.Tasks.Task<'Result> : Func<obj, 'Result> * obj * System.Threading.CancellationToken -> System.Threading.Tasks.Task<'Result>

Parámetros

function
Func<Object,TResult>

El delegado que representa el código que se va a ejecutar en la tarea.The delegate that represents the code to execute in the task. Cuando se complete la función, se establecerá la propiedad Result de la tarea para que se devuelva el valor de resultado de la función.When the function has completed, the task's Result property will be set to return the result value of the function.

state
Object Object Object Object

Un objeto que representa los datos que la función va a usar.An object representing data to be used by the function.

cancellationToken
CancellationToken CancellationToken CancellationToken CancellationToken

CancellationToken que se va a asignar a la nueva tarea.The CancellationToken to be assigned to the new task.

Excepciones

El CancellationTokenSource que creó cancellationToken ya se ha eliminado.The CancellationTokenSource that created cancellationToken has already been disposed.

El argumento function es null.The function argument is null.

El argumento function es null.The function argument is null.

Comentarios

En lugar de llamar a este constructor, la manera más común para crear instancias de un Task<TResult> objeto e iniciar una tarea es mediante una llamada a estático TaskFactory<TResult>.StartNew(Func<Object,TResult>, Object, CancellationToken) método.Rather than calling this constructor, the most common way to instantiate a Task<TResult> object and launch a task is by calling the static TaskFactory<TResult>.StartNew(Func<Object,TResult>, Object, CancellationToken) method. La única ventaja que ofrece este constructor es que permite la creación de instancias de objeto para separarse de invocación de la tarea.The only advantage offered by this constructor is that it allows object instantiation to be separated from task invocation.

Consulte también:

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

Inicializa un nuevo objeto Task<TResult> con la acción, el estado y las opciones especificados.Initializes a new Task<TResult> with the specified action, state, and options.

public:
 Task(Func<System::Object ^, TResult> ^ function, System::Object ^ state, System::Threading::Tasks::TaskCreationOptions creationOptions);
public Task (Func<object,TResult> function, object state, System.Threading.Tasks.TaskCreationOptions creationOptions);
new System.Threading.Tasks.Task<'Result> : Func<obj, 'Result> * obj * System.Threading.Tasks.TaskCreationOptions -> System.Threading.Tasks.Task<'Result>
Public Sub New (function As Func(Of Object, TResult), state As Object, creationOptions As TaskCreationOptions)

Parámetros

function
Func<Object,TResult>

El delegado que representa el código que se va a ejecutar en la tarea.The delegate that represents the code to execute in the task. Cuando se complete la función, se establecerá la propiedad Result de la tarea para que se devuelva el valor de resultado de la función.When the function has completed, the task's Result property will be set to return the result value of the function.

state
Object Object Object Object

Un objeto que representa los datos que la función va a usar.An object representing data to be used by the function.

creationOptions
TaskCreationOptions TaskCreationOptions TaskCreationOptions TaskCreationOptions

El objeto TaskCreationOptions que se usa para personalizar el comportamiento de la tarea.The TaskCreationOptions used to customize the task's behavior.

Excepciones

El argumento creationOptions especifica un valor no válido para TaskCreationOptions.The creationOptions argument specifies an invalid value for TaskCreationOptions.

El argumento function es null.The function argument is null.

El argumento function es null.The function argument is null.

Comentarios

En lugar de llamar a este constructor, la manera más común para crear instancias de un Task<TResult> objeto e iniciar una tarea es mediante una llamada a estático TaskFactory<TResult>.StartNew(Func<Object,TResult>, Object, TaskCreationOptions) método.Rather than calling this constructor, the most common way to instantiate a Task<TResult> object and launch a task is by calling the static TaskFactory<TResult>.StartNew(Func<Object,TResult>, Object, TaskCreationOptions) method. La única ventaja que ofrece este constructor es que permite la creación de instancias de objeto para separarse de invocación de la tarea.The only advantage offered by this constructor is that it allows object instantiation to be separated from task invocation.

Consulte también:

Task<TResult>(Func<TResult>, CancellationToken, TaskCreationOptions) Task<TResult>(Func<TResult>, CancellationToken, TaskCreationOptions) Task<TResult>(Func<TResult>, CancellationToken, TaskCreationOptions)

Inicializa una nueva Task<TResult> con la función y las opciones de creación especificadas.Initializes a new Task<TResult> with the specified function and creation options.

public:
 Task(Func<TResult> ^ function, System::Threading::CancellationToken cancellationToken, System::Threading::Tasks::TaskCreationOptions creationOptions);
public Task (Func<TResult> function, System.Threading.CancellationToken cancellationToken, System.Threading.Tasks.TaskCreationOptions creationOptions);
new System.Threading.Tasks.Task<'Result> : Func<'Result> * System.Threading.CancellationToken * System.Threading.Tasks.TaskCreationOptions -> System.Threading.Tasks.Task<'Result>

Parámetros

function
Func<TResult> Func<TResult> Func<TResult> Func<TResult>

El delegado que representa el código que se va a ejecutar en la tarea.The delegate that represents the code to execute in the task. Cuando se complete la función, se establecerá la propiedad Result de la tarea para que se devuelva el valor de resultado de la función.When the function has completed, the task's Result property will be set to return the result value of the function.

cancellationToken
CancellationToken CancellationToken CancellationToken CancellationToken

CancellationToken que se va a asignar a la nueva tarea.The CancellationToken that will be assigned to the new task.

creationOptions
TaskCreationOptions TaskCreationOptions TaskCreationOptions TaskCreationOptions

El objeto TaskCreationOptions que se usa para personalizar el comportamiento de la tarea.The TaskCreationOptions used to customize the task's behavior.

Excepciones

El CancellationTokenSource que creó cancellationToken ya se ha eliminado.The CancellationTokenSource that created cancellationToken has already been disposed.

El argumento creationOptions especifica un valor no válido para TaskCreationOptions.The creationOptions argument specifies an invalid value for TaskCreationOptions.

El argumento function es null.The function argument is null.

El argumento function es null.The function argument is null.

Comentarios

En lugar de llamar a este constructor, la manera más común para crear instancias de un Task<TResult> objeto e iniciar una tarea es mediante una llamada a estático TaskFactory.StartNew<TResult>(Func<TResult>, CancellationToken, TaskCreationOptions, TaskScheduler) método.Rather than calling this constructor, the most common way to instantiate a Task<TResult> object and launch a task is by calling the static TaskFactory.StartNew<TResult>(Func<TResult>, CancellationToken, TaskCreationOptions, TaskScheduler) method. La única ventaja que ofrece este constructor es que permite la creación de instancias de objeto para separarse de invocación de la tarea.The only advantage offered by this constructor is that it allows object instantiation to be separated from task invocation.

Consulte también:

Task<TResult>(Func<Object,TResult>, Object, CancellationToken, TaskCreationOptions) Task<TResult>(Func<Object,TResult>, Object, CancellationToken, TaskCreationOptions) Task<TResult>(Func<Object,TResult>, Object, CancellationToken, TaskCreationOptions)

Inicializa un nuevo objeto Task<TResult> con la acción, el estado y las opciones especificados.Initializes a new Task<TResult> with the specified action, state, and options.

public:
 Task(Func<System::Object ^, TResult> ^ function, System::Object ^ state, System::Threading::CancellationToken cancellationToken, System::Threading::Tasks::TaskCreationOptions creationOptions);
public Task (Func<object,TResult> function, object state, System.Threading.CancellationToken cancellationToken, System.Threading.Tasks.TaskCreationOptions creationOptions);
new System.Threading.Tasks.Task<'Result> : Func<obj, 'Result> * obj * System.Threading.CancellationToken * System.Threading.Tasks.TaskCreationOptions -> System.Threading.Tasks.Task<'Result>

Parámetros

function
Func<Object,TResult>

El delegado que representa el código que se va a ejecutar en la tarea.The delegate that represents the code to execute in the task. Cuando se complete la función, se establecerá la propiedad Result de la tarea para que se devuelva el valor de resultado de la función.When the function has completed, the task's Result property will be set to return the result value of the function.

state
Object Object Object Object

Un objeto que representa los datos que la función va a usar.An object representing data to be used by the function.

cancellationToken
CancellationToken CancellationToken CancellationToken CancellationToken

CancellationToken que se va a asignar a la nueva tarea.The CancellationToken to be assigned to the new task.

creationOptions
TaskCreationOptions TaskCreationOptions TaskCreationOptions TaskCreationOptions

El objeto TaskCreationOptions que se usa para personalizar el comportamiento de la tarea.The TaskCreationOptions used to customize the task's behavior.

Excepciones

El CancellationTokenSource que creó cancellationToken ya se ha eliminado.The CancellationTokenSource that created cancellationToken has already been disposed.

El argumento creationOptions especifica un valor no válido para TaskCreationOptions.The creationOptions argument specifies an invalid value for TaskCreationOptions.

El argumento function es null.The function argument is null.

El argumento function es null.The function argument is null.

Comentarios

En lugar de llamar a este constructor, la manera más común para crear instancias de un Task<TResult> objeto e iniciar una tarea es mediante una llamada a estático TaskFactory<TResult>.StartNew(Func<Object,TResult>, Object, CancellationToken, TaskCreationOptions, TaskScheduler) método.Rather than calling this constructor, the most common way to instantiate a Task<TResult> object and launch a task is by calling the static TaskFactory<TResult>.StartNew(Func<Object,TResult>, Object, CancellationToken, TaskCreationOptions, TaskScheduler) method. La única ventaja que ofrece este constructor es que permite la creación de instancias de objeto para separarse de invocación de la tarea.The only advantage offered by this constructor is that it allows object instantiation to be separated from task invocation.

Consulte también:

Se aplica a