Task Clase

Definición

Espacio de nombres:

System.Threading.Tasks

Ensamblado:

System.Runtime.dll

Source:

Task.cs

Representa una operación asincrónica.

public ref class Task : IAsyncResult, IDisposable

public class Task : IAsyncResult, IDisposable

type Task = class
    interface IAsyncResult
    interface IDisposable

Public Class Task
Implements IAsyncResult, IDisposable

Herencia

Object

Task

Derivado

System.Threading.Tasks.Task<TResult>

Implementaciones

IAsyncResult IDisposable

Comentarios

Para obtener más información sobre esta API, consulte comentarios de API complementarias para Task.

Constructores

Task(Action)	Inicializa un nuevo Task con la acción especificada.
Task(Action, CancellationToken)	Inicializa un nuevo Task con la acción especificada y CancellationToken.
Task(Action, CancellationToken, TaskCreationOptions)	Inicializa un nuevo Task con las opciones de acción y creación especificadas.
Task(Action, TaskCreationOptions)	Inicializa un nuevo Task con las opciones de acción y creación especificadas.
Task(Action<Object>, Object)	Inicializa un nuevo Task con la acción y el estado especificados.
Task(Action<Object>, Object, CancellationToken)	Inicializa un nuevo Task con la acción, el estado y CancellationTokenespecificados.
Task(Action<Object>, Object, CancellationToken, TaskCreationOptions)	Inicializa un nuevo Task con la acción, el estado y las opciones especificados.
Task(Action<Object>, Object, TaskCreationOptions)	Inicializa un nuevo Task con la acción, el estado y las opciones especificados.

Propiedades

AsyncState	Obtiene el objeto de estado proporcionado cuando se creó el Task, o null si no se proporcionó ninguno.
CompletedTask	Obtiene una tarea que ya se ha completado correctamente.
CreationOptions	Obtiene el TaskCreationOptions usado para crear esta tarea.
CurrentId	Devuelve el identificador del Taskque se está ejecutando actualmente.
Exception	Obtiene el AggregateException que provocó que el Task finalizara prematuramente. Si el Task se completó correctamente o aún no ha producido ninguna excepción, devolverá null.
Factory	Proporciona acceso a los métodos de fábrica para crear y configurar instancias de Task y Task<TResult>.
Id	Obtiene un identificador para esta instancia de Task.
IsCanceled	Obtiene si esta instancia de Task ha completado la ejecución debido a la cancelación.
IsCompleted	Obtiene un valor que indica si la tarea se ha completado.
IsCompletedSuccessfully	Obtiene si la tarea se ejecutó hasta la finalización.
IsFaulted	Obtiene si el Task completado debido a una excepción no controlada.
Status	Obtiene el TaskStatus de esta tarea.

Métodos

ConfigureAwait(Boolean)	Configura un awaiter usado para esperar este Task.
ConfigureAwait(ConfigureAwaitOptions)	Configura un awaiter usado para esperar este Task.
ContinueWith(Action<Task,Object>, Object)	Crea una continuación que recibe información de estado proporcionada por el autor de la llamada y se ejecuta cuando se completa el destino Task.
ContinueWith(Action<Task,Object>, Object, CancellationToken)	Crea una continuación que recibe información de estado proporcionada por el autor de la llamada y un token de cancelación y que se ejecuta de forma asincrónica cuando se completa el Task de destino.
ContinueWith(Action<Task,Object>, Object, CancellationToken, TaskContinuationOptions, TaskScheduler)	Crea una continuación que recibe información de estado proporcionada por el autor de la llamada y un token de cancelación y que se ejecuta cuando se completa el Task de destino. La continuación se ejecuta en función de un conjunto de condiciones especificadas y usa un programador especificado.
ContinueWith(Action<Task,Object>, Object, TaskContinuationOptions)	Crea una continuación que recibe información de estado proporcionada por el autor de la llamada y se ejecuta cuando se completa el destino Task. La continuación se ejecuta en función de un conjunto de condiciones especificadas.
ContinueWith(Action<Task,Object>, Object, TaskScheduler)	Crea una continuación que recibe información de estado proporcionada por el autor de la llamada y se ejecuta de forma asincrónica cuando se completa el destino Task. La continuación usa un programador especificado.
ContinueWith(Action<Task>)	Crea una continuación que se ejecuta de forma asincrónica cuando se completa el Task de destino.
ContinueWith(Action<Task>, CancellationToken)	Crea una continuación que recibe un token de cancelación y se ejecuta de forma asincrónica cuando se completa el Task de destino.
ContinueWith(Action<Task>, CancellationToken, TaskContinuationOptions, TaskScheduler)	Crea una continuación que se ejecuta cuando la tarea de destino compite según el TaskContinuationOptionsespecificado. La continuación recibe un token de cancelación y usa un programador especificado.
ContinueWith(Action<Task>, TaskContinuationOptions)	Crea una continuación que se ejecuta cuando se completa la tarea de destino según el TaskContinuationOptionsespecificado.
ContinueWith(Action<Task>, TaskScheduler)	Crea una continuación que se ejecuta de forma asincrónica cuando se completa el Task de destino. La continuación usa un programador especificado.
ContinueWith<TResult>(Func<Task,Object,TResult>, Object)	Crea una continuación que recibe información de estado proporcionada por el autor de la llamada y se ejecuta de forma asincrónica cuando el destino Task finaliza y devuelve un valor.
ContinueWith<TResult>(Func<Task,Object,TResult>, Object, CancellationToken)	Crea una continuación que se ejecuta de forma asincrónica cuando el destino Task completa y devuelve un valor. La continuación recibe información de estado proporcionada por el autor de la llamada y un token de cancelación.
ContinueWith<TResult>(Func<Task,Object,TResult>, Object, CancellationToken, TaskContinuationOptions, TaskScheduler)	Crea una continuación que se ejecuta en función de las opciones de continuación de tareas especificadas cuando el destino Task completa y devuelve un valor. La continuación recibe información de estado proporcionada por el autor de la llamada y un token de cancelación y usa el programador especificado.
ContinueWith<TResult>(Func<Task,Object,TResult>, Object, TaskContinuationOptions)	Crea una continuación que se ejecuta en función de las opciones de continuación de tareas especificadas cuando se completa el destino Task. La continuación recibe información de estado proporcionada por el autor de la llamada.
ContinueWith<TResult>(Func<Task,Object,TResult>, Object, TaskScheduler)	Crea una continuación que se ejecuta de forma asincrónica cuando se completa el Task de destino. La continuación recibe información de estado proporcionada por el autor de la llamada y usa un programador especificado.
ContinueWith<TResult>(Func<Task,TResult>)	Crea una continuación que se ejecuta de forma asincrónica cuando el destino Task<TResult> completa y devuelve un valor.
ContinueWith<TResult>(Func<Task,TResult>, CancellationToken)	Crea una continuación que se ejecuta de forma asincrónica cuando el destino Task completa y devuelve un valor. La continuación recibe un token de cancelación.
ContinueWith<TResult>(Func<Task,TResult>, CancellationToken, TaskContinuationOptions, TaskScheduler)	Crea una continuación que se ejecuta según las opciones de continuación especificadas y devuelve un valor. La continuación se pasa un token de cancelación y usa un programador especificado.
ContinueWith<TResult>(Func<Task,TResult>, TaskContinuationOptions)	Crea una continuación que se ejecuta según las opciones de continuación especificadas y devuelve un valor.
ContinueWith<TResult>(Func<Task,TResult>, TaskScheduler)	Crea una continuación que se ejecuta de forma asincrónica cuando el destino Task completa y devuelve un valor. La continuación usa un programador especificado.
Delay(Int32)	Crea una tarea que se completa después de un número especificado de milisegundos.
Delay(Int32, CancellationToken)	Crea una tarea cancelable que se completa después de un número especificado de milisegundos.
Delay(TimeSpan)	Crea una tarea que se completa después de un intervalo de tiempo especificado.
Delay(TimeSpan, CancellationToken)	Crea una tarea cancelable que se completa después de un intervalo de tiempo especificado.
Delay(TimeSpan, TimeProvider)	Crea una tarea que se completa después de un intervalo de tiempo especificado.
Delay(TimeSpan, TimeProvider, CancellationToken)	Crea una tarea cancelable que se completa después de un intervalo de tiempo especificado.
Dispose()	Libera todos los recursos usados por la instancia actual de la clase Task.
Dispose(Boolean)	Elimina el Task, liberando todos sus recursos no administrados.
Equals(Object)	Determina si el objeto especificado es igual al objeto actual. (Heredado de Object)
FromCanceled(CancellationToken)	Crea un Task que se completa debido a la cancelación con un token de cancelación especificado.
FromCanceled<TResult>(CancellationToken)	Crea un Task<TResult> que se completa debido a la cancelación con un token de cancelación especificado.
FromException(Exception)	Crea un Task que se ha completado con una excepción especificada.
FromException<TResult>(Exception)	Crea un Task<TResult> que se completa con una excepción especificada.
FromResult<TResult>(TResult)	Crea un Task<TResult> que se completa correctamente con el resultado especificado.
GetAwaiter()	Obtiene un awaiter usado para esperar este Task.
GetHashCode()	Actúa como función hash predeterminada. (Heredado de Object)
GetType()	Obtiene el Type de la instancia actual. (Heredado de Object)
MemberwiseClone()	Crea una copia superficial del Objectactual. (Heredado de Object)
Run(Action)	Pone en cola el trabajo especificado para ejecutarse en el grupo de subprocesos y devuelve un objeto Task que representa ese trabajo.
Run(Action, CancellationToken)	Pone en cola el trabajo especificado para ejecutarse en el grupo de subprocesos y devuelve un objeto Task que representa ese trabajo. Un token de cancelación permite cancelar el trabajo si aún no se ha iniciado.
Run(Func<Task>)	Pone en cola el trabajo especificado para ejecutarse en el grupo de subprocesos y devuelve un proxy para la tarea devuelta por function.
Run(Func<Task>, CancellationToken)	Pone en cola el trabajo especificado para ejecutarse en el grupo de subprocesos y devuelve un proxy para la tarea devuelta por function. Un token de cancelación permite cancelar el trabajo si aún no se ha iniciado.
Run<TResult>(Func<Task<TResult>>)	Pone en cola el trabajo especificado para ejecutarse en el grupo de subprocesos y devuelve un proxy para el Task(TResult) devuelto por function. Un token de cancelación permite cancelar el trabajo si aún no se ha iniciado.
Run<TResult>(Func<Task<TResult>>, CancellationToken)	Pone en cola el trabajo especificado para ejecutarse en el grupo de subprocesos y devuelve un proxy para el Task(TResult) devuelto por function.
Run<TResult>(Func<TResult>)	Pone en cola el trabajo especificado para ejecutarse en el grupo de subprocesos y devuelve un objeto Task<TResult> que representa ese trabajo. Un token de cancelación permite cancelar el trabajo si aún no se ha iniciado.
Run<TResult>(Func<TResult>, CancellationToken)	Pone en cola el trabajo especificado para ejecutarse en el grupo de subprocesos y devuelve un objeto Task(TResult) que representa ese trabajo.
RunSynchronously()	Ejecuta el Task sincrónicamente en el TaskScheduleractual.
RunSynchronously(TaskScheduler)	Ejecuta el Task sincrónicamente en el TaskScheduler proporcionado.
Start()	Inicia el Task, programando para su ejecución en el TaskScheduleractual.
Start(TaskScheduler)	Inicia el Task, programando para su ejecución en el TaskSchedulerespecificado.
ToString()	Devuelve una cadena que representa el objeto actual. (Heredado de Object)
Wait()	Espera a que el Task complete la ejecución.
Wait(CancellationToken)	Espera a que el Task complete la ejecución. La espera finaliza si se cancela un token de cancelación antes de que se complete la tarea.
Wait(Int32)	Espera a que el Task complete la ejecución dentro de un número especificado de milisegundos.
Wait(Int32, CancellationToken)	Espera a que el Task complete la ejecución. La espera finaliza si transcurre un intervalo de tiempo de espera o se cancela un token de cancelación antes de que se complete la tarea.
Wait(TimeSpan)	Espera a que el Task complete la ejecución dentro de un intervalo de tiempo especificado.
Wait(TimeSpan, CancellationToken)	Espera a que el Task complete la ejecución.
WaitAll(Task[])	Espera a que todos los objetos de Task proporcionados completen la ejecución.
WaitAll(Task[], CancellationToken)	Espera a que todos los objetos de Task proporcionados completen la ejecución a menos que se cancele la espera.
WaitAll(Task[], Int32)	Espera a que todos los objetos de Task proporcionados completen la ejecución dentro de un número especificado de milisegundos.
WaitAll(Task[], Int32, CancellationToken)	Espera a que todos los objetos Task proporcionados completen la ejecución dentro de un número especificado de milisegundos o hasta que se cancele la espera.
WaitAll(Task[], TimeSpan)	Espera a que todos los objetos cancelables proporcionados Task completen la ejecución dentro de un intervalo de tiempo especificado.
WaitAny(Task[])	Espera a que cualquiera de los objetos de Task proporcionados complete la ejecución.
WaitAny(Task[], CancellationToken)	Espera a que cualquiera de los objetos de Task proporcionados complete la ejecución a menos que se cancele la espera.
WaitAny(Task[], Int32)	Espera a que cualquiera de los objetos Task proporcionados complete la ejecución dentro de un número especificado de milisegundos.
WaitAny(Task[], Int32, CancellationToken)	Espera a que cualquiera de los objetos Task proporcionados complete la ejecución dentro de un número especificado de milisegundos o hasta que se cancele un token de cancelación.
WaitAny(Task[], TimeSpan)	Espera a que cualquiera de los objetos de Task proporcionados complete la ejecución dentro de un intervalo de tiempo especificado.
WaitAsync(CancellationToken)	Obtiene un Task que se completará cuando se complete este Task o cuando se haya solicitado la cancelación del CancellationToken especificado.
WaitAsync(TimeSpan)	Obtiene un Task que se completará cuando se complete este Task o cuando expire el tiempo de espera especificado.
WaitAsync(TimeSpan, CancellationToken)	Obtiene un Task que se completará cuando finalice este Task, cuando expire el tiempo de espera especificado o cuando se haya solicitado la cancelación del CancellationToken especificado.
WaitAsync(TimeSpan, TimeProvider)	Obtiene un Task que se completará cuando se complete este Task o cuando expire el tiempo de espera especificado.
WaitAsync(TimeSpan, TimeProvider, CancellationToken)	Obtiene un Task que se completará cuando finalice este Task, cuando expire el tiempo de espera especificado o cuando se haya solicitado la cancelación del CancellationToken especificado.
WhenAll(IEnumerable<Task>)	Crea una tarea que se completará cuando se hayan completado todos los objetos Task de una colección enumerable.
WhenAll(Task[])	Crea una tarea que se completará cuando se hayan completado todos los objetos Task de una matriz.
WhenAll<TResult>(IEnumerable<Task<TResult>>)	Crea una tarea que se completará cuando se hayan completado todos los objetos Task<TResult> de una colección enumerable.
WhenAll<TResult>(Task<TResult>[])	Crea una tarea que se completará cuando se hayan completado todos los objetos Task<TResult> de una matriz.
WhenAny(IEnumerable<Task>)	Crea una tarea que se completará cuando se haya completado cualquiera de las tareas proporcionadas.
WhenAny(Task, Task)	Crea una tarea que se completará cuando se haya completado alguna de las tareas proporcionadas.
WhenAny(Task[])	Crea una tarea que se completará cuando se haya completado cualquiera de las tareas proporcionadas.
WhenAny<TResult>(IEnumerable<Task<TResult>>)	Crea una tarea que se completará cuando se haya completado cualquiera de las tareas proporcionadas.
WhenAny<TResult>(Task<TResult>, Task<TResult>)	Crea una tarea que se completará cuando se haya completado alguna de las tareas proporcionadas.
WhenAny<TResult>(Task<TResult>[])	Crea una tarea que se completará cuando se haya completado cualquiera de las tareas proporcionadas.
Yield()	Crea una tarea a la espera que se devuelve de forma asincrónica al contexto actual cuando se espera.

Implementaciones de interfaz explícitas

IAsyncResult.AsyncWaitHandle	Obtiene un WaitHandle que se puede usar para esperar a que se complete la tarea.
IAsyncResult.CompletedSynchronously	Obtiene una indicación de si la operación se completó sincrónicamente.

Métodos de extensión

AsyncWait<TException>(Task)	Representa una operación asincrónica.
AwaitWithTimeout(Task, TimeSpan)	Representa una operación asincrónica.
ToApm(Task, AsyncCallback, Object)	Representa una operación asincrónica.
ToApmEnd(IAsyncResult)	Representa una operación asincrónica.
ToApmEnd<TResult>(IAsyncResult)	Representa una operación asincrónica.
Wait(Task, TimeSpan, Action<Exception,TimeSpan,String>, String)	Representa una operación asincrónica.
WaitForCompletion(Task)	Representa una operación asincrónica.
WaitForCompletionNoSpin(Task)	Representa una operación asincrónica.
WaitForCompletionNoSpin(Task, TimeSpan)	Representa una operación asincrónica.
WaitAsync(Task, TimeSpan, TimeProvider, CancellationToken)	Obtiene un Task que se completará cuando finalice este Task, cuando expire el tiempo de espera especificado o cuando se haya solicitado la cancelación del CancellationToken especificado.

Seguridad para subprocesos

Todos los miembros de Task, excepto para Dispose(), son seguros para subprocesos y se pueden usar de varios subprocesos simultáneamente.

Consulte también

• Task<TResult>
• biblioteca paralela de tareas (TPL) de
• patrón asincrónico basado en tareas (TAP) en .NET: Introducción e información general
• programación asincrónica basada en tareas
• ejemplos de para la programación en paralelo con .NET Core y .NET Standard