Task Clase

Definición

Espacio de nombres:
System.Threading.Tasks
Ensamblados:
mscorlib.dll, System.Threading.Tasks.dll
Ensamblado:
mscorlib.dll
Ensamblado:
System.Threading.Tasks.dll
Ensamblado:
netstandard.dll

Representa una operación asincrónica.

public ref class Task : IAsyncResult
public ref class Task : IAsyncResult, IDisposable
public class Task : IAsyncResult
public class Task : IAsyncResult, IDisposable
type Task = class
    interface IAsyncResult
type Task = class
    interface IAsyncResult
    interface IDisposable
Public Class Task
Implements IAsyncResult
Public Class Task
Implements IAsyncResult, IDisposable
Herencia
Object
Task
Derivado
Implementaciones
IAsyncResult IDisposable

Comentarios

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

Constructores

Nombre Description
Task(Action, CancellationToken, TaskCreationOptions)

Inicializa un nuevo Task con las opciones de acción y creación especificadas.
Task(Action, CancellationToken)

Inicializa un nuevo Task con la acción especificada y CancellationToken.
Task(Action, TaskCreationOptions)

Inicializa un nuevo Task con las opciones de acción y creación especificadas.
Task(Action)

Inicializa un nuevo Task con la acción especificada.
Task(Action<Object>, Object, CancellationToken, TaskCreationOptions)

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

Inicializa un nuevo Task con la acción, el estado y CancellationTokenespecificados.
Task(Action<Object>, Object, TaskCreationOptions)

Inicializa un nuevo Task con la acción, el estado y las opciones especificados.
Task(Action<Object>, Object)

Inicializa un nuevo Task con la acción y el estado especificados.

Propiedades

Nombre Description
AsyncState

Obtiene el objeto de estado proporcionado cuando Task se creó o null si no se proporcionó ninguno.
CompletedTask

Obtiene una tarea que ya se ha completado correctamente.
CreationOptions

Obtiene el TaskCreationOptions objeto utilizado para crear esta tarea.
CurrentId

Devuelve el identificador del objeto que se está Taskejecutando actualmente.
Exception

Obtiene el AggregateException objeto que provocó que finalizara Task prematuramente. Si se Task 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 Task instancias y Task<TResult> .
Id

Obtiene un identificador para esta Task instancia.
IsCanceled

Obtiene si esta Task instancia 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 se Task completó debido a una excepción no controlada.
Status

Obtiene el TaskStatus de esta tarea.

Métodos

Nombre Description
ConfigureAwait(Boolean)

Configura un awaiter que se usa para esperar a este Task.
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 destino Task . La continuación se ejecuta en función de un conjunto de condiciones especificadas y usa un programador especificado.
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 destino Task .
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,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>, CancellationToken, TaskContinuationOptions, TaskScheduler)

Crea una continuación que se ejecuta cuando la tarea de destino compite según el especificado TaskContinuationOptions. La continuación recibe un token de cancelación y usa un programador especificado.
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 destino Task .
ContinueWith(Action<Task>, TaskContinuationOptions)

Crea una continuación que se ejecuta cuando se completa la tarea de destino según el especificado TaskContinuationOptions.
ContinueWith(Action<Task>, TaskScheduler)

Crea una continuación que 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 destino Task .
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 finaliza 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, CancellationToken)

Crea una continuación que se ejecuta de forma asincrónica cuando el destino Task finaliza 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, 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 destino Task . La continuación recibe información de estado proporcionada por el autor de la llamada y 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,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>, CancellationToken)

Crea una continuación que se ejecuta de forma asincrónica cuando el destino Task finaliza y devuelve un valor. La continuación recibe un token de cancelación.
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 finaliza y devuelve un valor. La continuación 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> finaliza y devuelve un valor.
Delay(Int32, CancellationToken)

Crea una tarea cancelable que se completa después de un número especificado de milisegundos.
Delay(Int32)

Crea una tarea que se completa después de un número especificado de milisegundos.
Delay(TimeSpan, CancellationToken)

Crea una tarea cancelable que se completa después de un intervalo de tiempo especificado.
Delay(TimeSpan)

Crea una tarea que se completa después de un intervalo de tiempo especificado.
Dispose()

Libera todos los recursos usados por la instancia actual de la Task clase .
Dispose(Boolean)

Elimina , Taskliberando todos sus recursos no administrados.
Equals(Object)

Determina si el objeto especificado es igual al objeto actual.

(Heredado de Object)
FromCanceled(CancellationToken)

Crea un objeto Task completado debido a la cancelación con un token de cancelación especificado.
FromCanceled<TResult>(CancellationToken)

Crea un objeto Task<TResult> completado debido a la cancelación con un token de cancelación especificado.
FromException(Exception)

Crea un objeto Task que se ha completado con una excepción especificada.
FromException<TResult>(Exception)

Crea un objeto Task<TResult> que se completa con una excepción especificada.
FromResult<TResult>(TResult)

Crea un objeto Task<TResult> que se completa correctamente con el resultado especificado.
GetAwaiter()

Obtiene un awaiter usado para esperar a este Taskobjeto .
GetHashCode()

Actúa como la 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, CancellationToken)

Pone en cola el trabajo especificado para ejecutarse en el grupo de subprocesos y devuelve un Task objeto que representa ese trabajo. Un token de cancelación permite cancelar el trabajo si aún no se ha iniciado.
Run(Action)

Pone en cola el trabajo especificado para ejecutarse en el grupo de subprocesos y devuelve un Task objeto que representa ese trabajo.
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(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<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<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<TResult>, CancellationToken)

Pone en cola el trabajo especificado para ejecutarse en el grupo de subprocesos y devuelve un Task(TResult) objeto que representa ese trabajo.
Run<TResult>(Func<TResult>)

Pone en cola el trabajo especificado para ejecutarse en el grupo de subprocesos y devuelve un Task<TResult> objeto que representa ese trabajo. Un token de cancelación permite cancelar el trabajo si aún no se ha iniciado.
RunSynchronously()

Ejecuta de Task forma sincrónica en el objeto actual TaskScheduler.
RunSynchronously(TaskScheduler)

Ejecuta la Task sincrónicamente en el TaskScheduler proporcionado.
Start()

Inicia , Tasklo programa para su ejecución en el objeto actual TaskScheduler.
Start(TaskScheduler)

Inicia , Tasklo programa para su ejecución en el especificado TaskScheduler.
ToString()

Devuelve una cadena que representa el objeto actual.

(Heredado de Object)
Wait()

Espera a que se complete la Task ejecución.
Wait(CancellationToken)

Espera a que se complete la Task ejecución. La espera finaliza si se cancela un token de cancelación antes de que se complete la tarea.
Wait(Int32, CancellationToken)

Espera a que se complete la Task 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(Int32)

Espera a que se complete la Task ejecución dentro de un número especificado de milisegundos.
Wait(TimeSpan)

Espera a que se complete la Task ejecución dentro de un intervalo de tiempo especificado.
WaitAll(Task[], CancellationToken)

Espera a que todos los objetos proporcionados Task completen la ejecución a menos que se cancele la espera.
WaitAll(Task[], Int32, CancellationToken)

Espera a que todos los objetos proporcionados Task completen la ejecución dentro de un número especificado de milisegundos o hasta que se cancele la espera.
WaitAll(Task[], Int32)

Espera a que todos los objetos proporcionados Task completen la ejecución dentro de un número especificado de milisegundos.
WaitAll(Task[], TimeSpan)

Espera a que todos los objetos cancelables Task proporcionados completen la ejecución dentro de un intervalo de tiempo especificado.
WaitAll(Task[])

Espera a que todos los objetos proporcionados Task completen la ejecución.
WaitAny(Task[], CancellationToken)

Espera a que cualquiera de los objetos proporcionados Task complete la ejecución a menos que se cancele la espera.
WaitAny(Task[], Int32, CancellationToken)

Espera a que cualquiera de los objetos proporcionados Task complete la ejecución dentro de un número especificado de milisegundos o hasta que se cancele un token de cancelación.
WaitAny(Task[], Int32)

Espera a que cualquiera de los objetos proporcionados Task complete la ejecución dentro de un número especificado de milisegundos.
WaitAny(Task[], TimeSpan)

Espera a que cualquiera de los objetos proporcionados Task complete la ejecución dentro de un intervalo de tiempo especificado.
WaitAny(Task[])

Espera a que cualquiera de los objetos proporcionados Task complete la ejecución.
WhenAll(IEnumerable<Task>)

Crea una tarea que se completará cuando se hayan completado todos los Task objetos de una colección enumerable.
WhenAll(Task[])

Crea una tarea que se completará cuando se hayan completado todos los Task objetos de una matriz.
WhenAll<TResult>(IEnumerable<Task<TResult>>)

Crea una tarea que se completará cuando se hayan completado todos los Task<TResult> objetos de una colección enumerable.
WhenAll<TResult>(Task<TResult>[])

Crea una tarea que se completará cuando se hayan completado todos los Task<TResult> objetos de una matriz.
WhenAny(IEnumerable<Task>)

Crea una tarea que se completará cuando se haya completado cualquiera 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>[])

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

Nombre Description
IAsyncResult.AsyncWaitHandle

Obtiene un WaitHandle objeto 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

Nombre Description
AsAsyncAction(Task)

Devuelve una acción asincrónica de Windows Runtime que representa una tarea iniciada.
DispatcherOperationWait(Task, TimeSpan)

Espera la cantidad de tiempo especificada para que se complete el subyacente DispatcherOperation .
DispatcherOperationWait(Task)

Espera indefinidamente a que se complete el subyacente DispatcherOperation .
IsDispatcherOperationTask(Task)

Devuelve un valor que indica si está Task asociado a .DispatcherOperation

Se aplica a

Seguridad para subprocesos

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

Consulte también