Task Clase

Definición

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
Task
Derivado
Implementaciones

Comentarios

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

Constructores

Task(Action)

Inicializa una nueva instancia de Task con la acción especificada.

Task(Action, CancellationToken)

Inicializa una nueva instancia de Task con la acción especificada y CancellationToken.

Task(Action, CancellationToken, TaskCreationOptions)

Inicializa un nuevo objeto Task con la acción y las opciones de creación especificadas.

Task(Action, TaskCreationOptions)

Inicializa un nuevo objeto Task con la acción y las opciones de creación especificadas.

Task(Action<Object>, Object)

Inicializa una nueva instancia de Task con la acción y el estado especificados.

Task(Action<Object>, Object, CancellationToken)

Inicializa un nuevo Task objeto con la acción, el estado y CancellationToken.

Task(Action<Object>, Object, CancellationToken, TaskCreationOptions)

Inicializa un nuevo objeto Task con la acción, el estado y las opciones especificados.

Task(Action<Object>, Object, TaskCreationOptions)

Inicializa un nuevo objeto Task con la acción, el estado y las opciones especificados.

Propiedades

AsyncState

Obtiene el objeto de estado que se proporcionó al crearse el objeto Task, o null si no se proporcionó ningún objeto de estado.

CompletedTask

Obtiene una tarea que ya ha finalizado correctamente.

CreationOptions

Obtiene el objeto TaskCreationOptions usado para crear esta tarea.

CurrentId

Devuelve el identificador del objeto Task que se está ejecutando actualmente.

Exception

Obtiene la excepción AggregateException que causó la finalización prematura del objeto Task. Si Task se completó correctamente o no ha iniciado ninguna excepción, el valor devuelto será null.

Factory

Proporciona acceso a patrones de diseño para crear y configurar instancias de Task y Task<TResult>.

Id

Obtiene un identificador para esta instancia de Task.

IsCanceled

Obtiene un valor que indica si esta instancia de Task ha completado su ejecución debido a una cancelación.

IsCompleted

Obtiene un valor que indica si la tarea se ha completado.

IsCompletedSuccessfully

Obtiene si la tarea se ejecutó hasta completarse.

IsFaulted

Obtiene un valor que indica si el objeto Task se ha completado debido a una excepción no controlada.

Status

Obtiene el objeto TaskStatus de esta tarea.

Métodos

ConfigureAwait(Boolean)

Configura un awaiter utilizado para esperar a este objeto Task.

ConfigureAwait(ConfigureAwaitOptions)

Configura un awaiter utilizado para esperar a este objeto 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 el elemento Task de destino se completa.

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 el elemento Task de destino se completa.

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 el elemento Task de destino se completa. La continuación se ejecuta según 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 el elemento Task de destino se completa. La continuación se ejecuta según 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 el elemento Task de destino se completa. La continuación usa un programador especificado.

ContinueWith(Action<Task>)

Crea una continuación que se ejecuta de manera asincrónica cuando se completa el objeto 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 el elemento Task de destino se completa.

ContinueWith(Action<Task>, CancellationToken, TaskContinuationOptions, TaskScheduler)

Crea una continuación que se ejecuta cuando se completa la tarea de destino según el elemento TaskContinuationOptions especificado. 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 elemento TaskContinuationOptions especificado.

ContinueWith(Action<Task>, TaskScheduler)

Crea una continuación que se ejecuta de manera asincrónica cuando se completa el objeto 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 elemento Task de destino se completa 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 elemento Task de destino se 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 según las opciones de continuación de la tarea especificadas cuando el elemento Task de destino se 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 según las opciones de continuación de la tarea especificadas cuando el elemento Task de destino se completa. 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 manera asincrónica cuando se completa el objeto Task de destino. La continuación recibe información de estado proporcionada por el autor de la llamada y usa a un programador especificado.

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

Crea una continuación que se ejecuta de forma asincrónica cuando el elemento Task<TResult> de destino se completa y devuelve un valor.

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

Crea una continuación que se ejecuta de forma asincrónica cuando el elemento Task de destino se 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. Se pasa un token de cancelación a la continuació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 elemento Task de destino se 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 específico.

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 específico.

Dispose()

Libera todos los recursos usados por la instancia actual de la clase Task.

Dispose(Boolean)

Desecha el objeto Task y libera todos sus recursos no administrados.

Equals(Object)

Determina si el objeto especificado es igual que el objeto actual.

(Heredado de Object)
FromCanceled(CancellationToken)

Crea una Task que se finaliza debido a la cancelación con un token de cancelación especificado.

FromCanceled<TResult>(CancellationToken)

Crea una Task<TResult> que se finaliza debido a la cancelación con un token de cancelación especificado.

FromException(Exception)

Crea una Task que finalizó con una excepción especificada.

FromException<TResult>(Exception)

Crea una Task<TResult> que finalizó con una excepción especificada.

FromResult<TResult>(TResult)

Crea un objeto Task<TResult> que se ha completado correctamente con el resultado especificado.

GetAwaiter()

Obtiene un awaiter utilizado para esperar a este objeto Task.

GetHashCode()

Sirve 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 Object actual.

(Heredado de Object)
Run(Action)

Pone en cola el trabajo especificado para ejecutarlo en el grupo de subprocesos y devuelve un objeto Task que representa ese trabajo.

Run(Action, CancellationToken)

Pone en cola el trabajo especificado para ejecutarlo 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 ejecutarlo 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 ejecutarlo 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 ejecutarlo en el grupo de subprocesos y devuelve un proxy para Task(TResult) que devuelve 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 ejecutarlo en el grupo de subprocesos y devuelve un proxy para Task(TResult) que devuelve function.

Run<TResult>(Func<TResult>)

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

RunSynchronously()

Ejecuta sincrónicamente el objeto Task en el objeto TaskScheduler actual.

RunSynchronously(TaskScheduler)

Ejecuta sincrónicamente el objeto Task en el objeto TaskScheduler proporcionado.

Start()

Inicia el objeto Task, programando su ejecución en el objeto TaskScheduler actual.

Start(TaskScheduler)

Inicia el objeto Task, programando su ejecución en el objeto TaskScheduler especificado.

ToString()

Devuelve una cadena que representa el objeto actual.

(Heredado de Object)
Wait()

Espera a que se complete la ejecución del objeto Task.

Wait(CancellationToken)

Espera a que se complete la ejecución del objeto Task. La espera finalizará si un token de cancelación se cancela antes de que finalice la tarea.

Wait(Int32)

Espera a que el objeto Task complete la ejecución dentro de un número especificado de milisegundos.

Wait(Int32, CancellationToken)

Espera a que se complete la ejecución del objeto Task. La espera finalizará si transcurre un intervalo de tiempo de espera o un token de cancelación se cancela antes de que finalice la tarea.

Wait(TimeSpan)

Espera a que Task complete la ejecución dentro de un intervalo de tiempo especificado.

Wait(TimeSpan, CancellationToken)

Espera a que se complete la ejecución del objeto Task.

WaitAll(Task[])

Espera que se complete la ejecución de todos los objetos Task proporcionados.

WaitAll(Task[], CancellationToken)

Espera que se complete la ejecución de todos los objetos Task proporcionados, a menos que se cancele la espera.

WaitAll(Task[], Int32)

Espera a que todos los objetos proporcionados de Task 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 Task cancelables que se hayan proporcionado completen la ejecución en un intervalo de tiempo especificado.

WaitAny(Task[])

Espera a que se complete la ejecución de cualquiera de los objetos Task proporcionados.

WaitAny(Task[], CancellationToken)

Espera que se complete la ejecución de cualquiera de los objetos Task proporcionados, a menos que se cancele la espera.

WaitAny(Task[], Int32)

Espera a que cualquiera de los objetos Task que se hayan proporcionado complete su 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 se complete la ejecución de cualquier objeto Task proporcionado en un intervalo de tiempo especificado.

WaitAsync(CancellationToken)

Obtiene un Task objeto que se completará cuando se complete o Task cuando se haya solicitado la cancelación especificada CancellationToken .

WaitAsync(TimeSpan)

Obtiene un Task objeto que se completará cuando finalice o Task cuando expire el tiempo de espera especificado.

WaitAsync(TimeSpan, CancellationToken)

Obtiene un Task objeto que se completará cuando Task finalice, cuando expire el tiempo de espera especificado o cuando se haya solicitado la cancelación especificada CancellationToken .

WaitAsync(TimeSpan, TimeProvider)

Obtiene un Task objeto que se completará cuando finalice o Task cuando expire el tiempo de espera especificado.

WaitAsync(TimeSpan, TimeProvider, CancellationToken)

Obtiene un Task objeto que se completará cuando Task finalice, cuando expire el tiempo de espera especificado o cuando se haya solicitado la cancelación especificada CancellationToken .

WhenAll(IEnumerable<Task>)

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

WhenAll(Task[])

Crea una tarea que se completará cuando todos los objetos Task de una matriz se hayan completado.

WhenAll<TResult>(IEnumerable<Task<TResult>>)

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

WhenAll<TResult>(Task<TResult>[])

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

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 finalizará 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>, Task<TResult>)

Crea una tarea que se finalizará 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 que admite "await" que, de forma asincrónica, devuelve al contexto actual cuando es "awaited".

Implementaciones de interfaz explícitas

IAsyncResult.AsyncWaitHandle

Obtiene un identificador WaitHandle que se puede usar para esperar a que se complete la tarea.

IAsyncResult.CompletedSynchronously

Obtiene un valor que indica si la operación se ha completado sincrónicamente.

Métodos de extensión

DispatcherOperationWait(Task)

Espera indefinidamente a que se complete la DispatcherOperation subyacente.

DispatcherOperationWait(Task, TimeSpan)

Espera la cantidad de tiempo especificada para que se complete el DispatcherOperation subyacente.

IsDispatcherOperationTask(Task)

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

AsAsyncAction(Task)

Devuelve una acción asincrónica de Windows Runtime que representa una tarea iniciada.

Se aplica a

Seguridad para subprocesos

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

Consulte también