TaskFactory<TResult>.StartNew Método

Definición

Crea e inicia una tarea.Creates and starts a task.

Sobrecargas

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

Crea e inicia una tarea.Creates and starts a task.

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

Crea e inicia una tarea.Creates and starts a task.

StartNew(Func<TResult>, TaskCreationOptions)

Crea e inicia una tarea.Creates and starts a task.

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

Crea e inicia una tarea.Creates and starts a task.

StartNew(Func<Object,TResult>, Object)

Crea e inicia una tarea.Creates and starts a task.

StartNew(Func<TResult>)

Crea e inicia una tarea.Creates and starts a task.

StartNew(Func<TResult>, CancellationToken)

Crea e inicia una tarea.Creates and starts a task.

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

Crea e inicia una tarea.Creates and starts a task.

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

Crea e inicia una tarea.Creates and starts a task.

public:
 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 (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>

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.A function delegate that returns the future result to be available through the task.

state
Object

Objeto que contiene los datos que va a utilizar el delegado de function.An object that contains data to be used by the function delegate.

cancellationToken
CancellationToken

Token de cancelación que se va a asignar a la nueva tarea.The cancellation token that will be assigned to the new task.

Devoluciones

La tarea iniciada.The started task.

Excepciones

Ya se ha eliminado el origen de token de cancelación que ha creado cancellationToken.The cancellation token source that created cancellationToken has already been disposed.

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

Comentarios

Una llamada a StartNew es funcionalmente equivalente a la creación de una tarea mediante uno de los Task<TResult> constructores y, a continuación, que realiza la llamada la Start método para programar su ejecución.Calling StartNew is functionally equivalent to creating a task by using one of the Task<TResult> constructors and then calling the Start method to schedule it for execution.

Sin embargo, a menos que la creación y la programación deben estar separados, StartNew es el enfoque recomendado para mayor simplicidad y rendimiento.However, unless creation and scheduling must be separated, StartNew is the recommended approach for both simplicity and performance.

Consulte también:

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

Crea e inicia una tarea.Creates and starts a task.

public:
 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 (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 (function As Func(Of Object, TResult), state As Object, creationOptions As TaskCreationOptions) As Task(Of TResult)

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.A function delegate that returns the future result to be available through the task.

state
Object

Objeto que contiene los datos que va a utilizar el delegado de function.An object that contains data to be used by the function delegate.

creationOptions
TaskCreationOptions

Uno de los valores de enumeración que controla el comportamiento de la tarea creada.One of the enumeration values that controls the behavior of the created task.

Devoluciones

La tarea iniciada.The started task.

Excepciones

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

El parámetro creationOptions especifica un valor no válido.The creationOptions parameter specifies an invalid value.

Comentarios

Una llamada a StartNew es funcionalmente equivalente a la creación de una tarea mediante uno de los Task<TResult> constructores y, a continuación, que realiza la llamada la Start método para programar su ejecución.Calling StartNew is functionally equivalent to creating a task by using one of the Task<TResult> constructors and then calling the Start method to schedule it for execution.

Sin embargo, a menos que la creación y la programación deben estar separados, StartNew es el enfoque recomendado para mayor simplicidad y rendimiento.However, unless creation and scheduling must be separated, StartNew is the recommended approach for both simplicity and performance.

Consulte también:

StartNew(Func<TResult>, TaskCreationOptions)

Crea e inicia una tarea.Creates and starts a task.

public:
 System::Threading::Tasks::Task<TResult> ^ StartNew(Func<TResult> ^ function, System::Threading::Tasks::TaskCreationOptions creationOptions);
public System.Threading.Tasks.Task<TResult> StartNew (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 (function As Func(Of TResult), creationOptions As TaskCreationOptions) As Task(Of TResult)

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.A function delegate that returns the future result to be available through the task.

creationOptions
TaskCreationOptions

Uno de los valores de enumeración que controla el comportamiento de la tarea creada.One of the enumeration values that controls the behavior of the created task.

Devoluciones

Objeto Task<TResult> iniciado.The started Task<TResult>.

Excepciones

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

El parámetro creationOptions especifica un valor no válido.The creationOptions parameter specifies an invalid value.

Comentarios

Una llamada a StartNew es funcionalmente equivalente a la creación de una tarea mediante uno de los Task<TResult> constructores y, a continuación, que realiza la llamada la Start método para programar su ejecución.Calling StartNew is functionally equivalent to creating a task by using one of the Task<TResult> constructors and then calling the Start method to schedule it for execution.

Sin embargo, a menos que la creación y la programación deben estar separados, StartNew es el enfoque recomendado para mayor simplicidad y rendimiento.However, unless creation and scheduling must be separated, StartNew is the recommended approach for both simplicity and performance.

Consulte también:

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

Crea e inicia una tarea.Creates and starts a task.

public:
 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 (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>

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.A function delegate that returns the future result to be available through the task.

cancellationToken
CancellationToken

Token de cancelación que se va a asignar a la nueva tarea.The cancellation token that will be assigned to the new task.

creationOptions
TaskCreationOptions

Uno de los valores de enumeración que controla el comportamiento de la tarea creada.One of the enumeration values that controls the behavior of the created task.

scheduler
TaskScheduler

Programador de tareas que se usó para programar la tarea creada.The task scheduler that is used to schedule the created task.

Devoluciones

La tarea iniciada.The started task.

Excepciones

Ya se ha eliminado el origen de token de cancelación que ha creado cancellationToken.The cancellation token source that created cancellationToken has already been disposed.

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

O bien-or- El argumento scheduler es null.The scheduler argument is null.

El parámetro creationOptions especifica un valor no válido.The creationOptions parameter specifies an invalid value.

Comentarios

Una llamada a StartNew es funcionalmente equivalente a la creación de una tarea mediante uno de los Task<TResult> constructores y, a continuación, que realiza la llamada la Start método para programar su ejecución.Calling StartNew is functionally equivalent to creating a task by using one of the Task<TResult> constructors and then calling the Start method to schedule it for execution.

Sin embargo, a menos que la creación y la programación deben estar separados, StartNew es el enfoque recomendado para mayor simplicidad y rendimiento.However, unless creation and scheduling must be separated, StartNew is the recommended approach for both simplicity and performance.

Consulte también:

StartNew(Func<Object,TResult>, Object)

Crea e inicia una tarea.Creates and starts a task.

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

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.A function delegate that returns the future result to be available through the task.

state
Object

Objeto que contiene los datos que va a utilizar el delegado de function.An object that contains data to be used by the function delegate.

Devoluciones

La tarea iniciada.The started task.

Excepciones

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

Comentarios

Una llamada a StartNew es funcionalmente equivalente a la creación de una tarea mediante uno de los Task<TResult> constructores y, a continuación, que realiza la llamada la Start método para programar su ejecución.Calling StartNew is functionally equivalent to creating a task by using one of the Task<TResult> constructors and then calling the Start method to schedule it for execution.

Sin embargo, a menos que la creación y la programación deben estar separados, StartNew es el enfoque recomendado para mayor simplicidad y rendimiento.However, unless creation and scheduling must be separated, StartNew is the recommended approach for both simplicity and performance.

Consulte también:

StartNew(Func<TResult>)

Crea e inicia una tarea.Creates and starts a task.

public:
 System::Threading::Tasks::Task<TResult> ^ StartNew(Func<TResult> ^ function);
public System.Threading.Tasks.Task<TResult> StartNew (Func<TResult> function);
member this.StartNew : Func<'Result> -> System.Threading.Tasks.Task<'Result>
Public Function StartNew (function As Func(Of TResult)) As Task(Of TResult)

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.A function delegate that returns the future result to be available through the task.

Devoluciones

La tarea iniciada.The started task.

Excepciones

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

Comentarios

Una llamada a StartNew es funcionalmente equivalente a la creación de una tarea mediante uno de los Task<TResult> constructores y llamadas a continuación, el Start método para programar su ejecución.Calling StartNew is functionally equivalent to creating a task by using one of the Task<TResult> constructors, and then calling the Start method to schedule it for execution.

Sin embargo, a menos que la creación y la programación deben estar separados, StartNew es el enfoque recomendado para mayor simplicidad y rendimiento.However, unless creation and scheduling must be separated, StartNew is the recommended approach for both simplicity and performance.

Consulte también:

StartNew(Func<TResult>, CancellationToken)

Crea e inicia una tarea.Creates and starts a task.

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

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.A function delegate that returns the future result to be available through the task.

cancellationToken
CancellationToken

Token de cancelación que se va a asignar a la nueva tarea.The cancellation token that will be assigned to the new task.

Devoluciones

La tarea iniciada.The started task.

Excepciones

Ya se ha eliminado el origen de token de cancelación que ha creado cancellationToken.The cancellation token source that created cancellationToken has already been disposed.

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

Comentarios

Una llamada a StartNew es funcionalmente equivalente a la creación de una tarea mediante uno de los Task<TResult> constructores y, a continuación, que realiza la llamada la Start método para programar su ejecución.Calling StartNew is functionally equivalent to creating a task by using one of the Task<TResult> constructors and then calling the Start method to schedule it for execution.

Sin embargo, a menos que la creación y la programación deben estar separados, StartNew es el enfoque recomendado para mayor simplicidad y rendimiento.However, unless creation and scheduling must be separated, StartNew is the recommended approach for both simplicity and performance.

Consulte también:

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

Crea e inicia una tarea.Creates and starts a task.

public:
 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 (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>

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.A function delegate that returns the future result to be available through the task.

state
Object

Objeto que contiene los datos que va a utilizar el delegado de function.An object that contains data to be used by the function delegate.

cancellationToken
CancellationToken

Token de cancelación que se va a asignar a la nueva tarea.The cancellation token that will be assigned to the new task.

creationOptions
TaskCreationOptions

Uno de los valores de enumeración que controla el comportamiento de la tarea creada.One of the enumeration values that controls the behavior of the created task.

scheduler
TaskScheduler

Programador de tareas que se usó para programar la tarea creada.The task scheduler that is used to schedule the created task.

Devoluciones

La tarea iniciada.The started task.

Excepciones

Ya se ha eliminado el origen de token de cancelación que ha creado cancellationToken.The cancellation token source that created cancellationToken has already been disposed.

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

O bien-or- El argumento scheduler es null.The scheduler argument is null.

El parámetro creationOptions especifica un valor no válido.The creationOptions parameter specifies an invalid value.

Comentarios

Una llamada a StartNew es funcionalmente equivalente a la creación de una tarea mediante uno de los Task<TResult> constructores y, a continuación, que realiza la llamada la Start método para programar su ejecución.Calling StartNew is functionally equivalent to creating a task by using one of the Task<TResult> constructors and then calling the Start method to schedule it for execution.

Sin embargo, a menos que la creación y la programación deben estar separados, StartNew es el enfoque recomendado para mayor simplicidad y rendimiento.However, unless creation and scheduling must be separated, StartNew is the recommended approach for both simplicity and performance.

Consulte también:

Se aplica a