TaskFactory<TResult>.StartNew Método

Definición

Crea e inicia una tarea.

Sobrecargas

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

Crea e inicia una tarea.

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>
Public Function StartNew (function As Func(Of Object, TResult), state As Object, cancellationToken As CancellationToken) As Task(Of TResult)

Parámetros

function
Func<Object,TResult>

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

state
Object

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

cancellationToken
CancellationToken

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

Devoluciones

Tarea iniciada.

Excepciones

El origen del token de cancelación que creó cancellationToken ya se ha eliminado.

El function argumento es null.

Comentarios

La llamada StartNew a es funcionalmente equivalente a crear una tarea mediante uno de los Task<TResult> constructores y, a continuación, llamar al Start método para programarlo para su ejecución.

Sin embargo, a menos que se deba separar la creación y la programación, StartNew es el enfoque recomendado tanto para simplificar como para el rendimiento.

Consulte también

Se aplica a

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

Crea e inicia una tarea.

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 estará disponible a través de la tarea.

state
Object

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

creationOptions
TaskCreationOptions

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

Devoluciones

Tarea iniciada.

Excepciones

El function argumento es null.

El creationOptions parámetro especifica un valor no válido.

Comentarios

La llamada StartNew a es funcionalmente equivalente a crear una tarea mediante uno de los Task<TResult> constructores y, a continuación, llamar al Start método para programarlo para su ejecución.

Sin embargo, a menos que se deba separar la creación y la programación, StartNew es el enfoque recomendado tanto para simplificar como para el rendimiento.

Consulte también

Se aplica a

StartNew(Func<TResult>, TaskCreationOptions)

Crea e inicia una tarea.

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

El objeto iniciado Task<TResult>.

Excepciones

El function argumento es null.

El creationOptions parámetro especifica un valor no válido.

Comentarios

La llamada StartNew a es funcionalmente equivalente a crear una tarea mediante uno de los Task<TResult> constructores y, a continuación, llamar al Start método para programarlo para su ejecución.

Sin embargo, a menos que se deba separar la creación y la programación, StartNew es el enfoque recomendado tanto para simplificar como para el rendimiento.

Consulte también

Se aplica a

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

Crea e inicia una tarea.

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>
Public Function StartNew (function As Func(Of TResult), cancellationToken As CancellationToken, creationOptions As TaskCreationOptions, scheduler As TaskScheduler) As Task(Of TResult)

Parámetros

function
Func<TResult>

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

cancellationToken
CancellationToken

Token de cancelación que se 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 usa para programar la tarea creada.

Devoluciones

Tarea iniciada.

Excepciones

El origen del token de cancelación que creó cancellationToken ya se ha eliminado.

El function argumento es null.

O bien

El scheduler argumento es null.

El creationOptions parámetro especifica un valor no válido.

Comentarios

La llamada StartNew a es funcionalmente equivalente a crear una tarea mediante uno de los Task<TResult> constructores y, a continuación, llamar al Start método para programarlo para su ejecución.

Sin embargo, a menos que se deba separar la creación y la programación, StartNew es el enfoque recomendado tanto para simplificar como para el rendimiento.

Consulte también

Se aplica a

StartNew(Func<Object,TResult>, Object)

Crea e inicia una tarea.

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 estará disponible a través de la tarea.

state
Object

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

Devoluciones

Tarea iniciada.

Excepciones

El function argumento es null.

Comentarios

La llamada StartNew a es funcionalmente equivalente a crear una tarea mediante uno de los Task<TResult> constructores y, a continuación, llamar al Start método para programarlo para su ejecución.

Sin embargo, a menos que se deba separar la creación y la programación, StartNew es el enfoque recomendado tanto para simplificar como para el rendimiento.

Consulte también

Se aplica a

StartNew(Func<TResult>)

Crea e inicia una tarea.

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 estará disponible a través de la tarea.

Devoluciones

Tarea iniciada.

Excepciones

El function argumento es null.

Comentarios

La llamada StartNew a es funcionalmente equivalente a crear una tarea mediante uno de los Task<TResult> constructores y, a continuación, llamar al Start método para programarla para su ejecución.

Sin embargo, a menos que se deba separar la creación y la programación, StartNew es el enfoque recomendado tanto para simplificar como para el rendimiento.

Consulte también

Se aplica a

StartNew(Func<TResult>, CancellationToken)

Crea e inicia una tarea.

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>
Public Function StartNew (function As Func(Of TResult), cancellationToken As CancellationToken) As Task(Of TResult)

Parámetros

function
Func<TResult>

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

cancellationToken
CancellationToken

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

Devoluciones

Tarea iniciada.

Excepciones

El origen del token de cancelación que creó cancellationToken ya se ha eliminado.

El function argumento es null.

Comentarios

La llamada StartNew a es funcionalmente equivalente a crear una tarea mediante uno de los Task<TResult> constructores y, a continuación, llamar al Start método para programarlo para su ejecución.

Sin embargo, a menos que se deba separar la creación y la programación, StartNew es el enfoque recomendado tanto para simplificar como para el rendimiento.

Consulte también

Se aplica a

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

Crea e inicia una tarea.

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>
Public Function StartNew (function As Func(Of Object, TResult), state As Object, cancellationToken As CancellationToken, creationOptions As TaskCreationOptions, scheduler As TaskScheduler) As Task(Of TResult)

Parámetros

function
Func<Object,TResult>

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

state
Object

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

cancellationToken
CancellationToken

Token de cancelación que se 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 usa para programar la tarea creada.

Devoluciones

Tarea iniciada.

Excepciones

El origen del token de cancelación que creó cancellationToken ya se ha eliminado.

El function argumento es null.

O bien

El scheduler argumento es null.

El creationOptions parámetro especifica un valor no válido.

Comentarios

La llamada StartNew a es funcionalmente equivalente a crear una tarea mediante uno de los Task<TResult> constructores y, a continuación, llamar al Start método para programarlo para su ejecución.

Sin embargo, a menos que se deba separar la creación y la programación, StartNew es el enfoque recomendado tanto para simplificar como para el rendimiento.

Consulte también

Se aplica a