Task Classe

Definição

Espaço de Nomes:
System.Threading.Tasks
Assemblagens:
mscorlib.dll, System.Threading.Tasks.dll
Assemblagem:
mscorlib.dll
Assemblagem:
System.Threading.Tasks.dll
Assemblagem:
netstandard.dll

Representa uma operação assíncrona.

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
Herança
Object
Task
Derivado
Implementações
IAsyncResult IDisposable

Observações

Para mais informações sobre esta API, consulte Observações suplementares da API para Tarefa.

Construtores

Name Description
Task(Action, CancellationToken, TaskCreationOptions)

Inicializa um novo Task com as opções de ação e criação especificadas.
Task(Action, CancellationToken)

Inicializa um novo Task com a ação especificada e CancellationToken.
Task(Action, TaskCreationOptions)

Inicializa um novo Task com as opções de ação e criação especificadas.
Task(Action)

Inicializa um novo Task com a ação especificada.
Task(Action<Object>, Object, CancellationToken, TaskCreationOptions)

Inicializa um novo Task com a ação, estado e opções especificados.
Task(Action<Object>, Object, CancellationToken)

Inicializa um novo Task com a ação, estado e CancellationToken. especificados.
Task(Action<Object>, Object, TaskCreationOptions)

Inicializa um novo Task com a ação, estado e opções especificados.
Task(Action<Object>, Object)

Inicializa um novo Task com a ação e o estado especificados.

Propriedades

Name Description
AsyncState

Recebe o objeto de estado fornecido quando foi criado Task , ou nulo se não tiver sido fornecido.
CompletedTask

Recebe uma tarefa que já foi concluída com sucesso.
CreationOptions

É o TaskCreationOptions que se usa para criar esta tarefa.
CurrentId

Devolve o ID do que está a executar Taskatualmente .
Exception

Obtém o AggregateException que causou o Task fim prematuro. Se o Task completar com sucesso ou ainda não tiver lançado exceções, isto devolverá null.
Factory

Fornece acesso a métodos de fábrica para criar e configurar Task instâncias Task<TResult> .
Id

Obtém um ID para este Task caso.
IsCanceled

Percebe se esta Task instância concluiu a execução devido ao cancelamento.
IsCompleted

Recebe um valor que indica se a tarefa foi concluída.
IsCompletedSuccessfully

Percebe se a tarefa foi concluída.
IsFaulted

Obtém se o Task concluído devido a uma exceção não tratada.
Status

Percebe TaskStatus esta tarefa.

Métodos

Name Description
ConfigureAwait(Boolean)

Configura um awaiter usado para aguardar isto Task.
ContinueWith(Action<Task,Object>, Object, CancellationToken, TaskContinuationOptions, TaskScheduler)

Cria uma continuação que recebe informação de estado fornecida pelo chamador e um token de cancelamento, que é executada quando o destino Task é concluído. A continuação é executada com base num conjunto de condições especificadas e utiliza um agendador especificado.
ContinueWith(Action<Task,Object>, Object, CancellationToken)

Cria uma continuação que recebe informação de estado fornecida pelo chamador e um token de cancelamento, e que é executada de forma assíncrona quando o destino Task termina.
ContinueWith(Action<Task,Object>, Object, TaskContinuationOptions)

Cria uma continuação que recebe informações de estado fornecidas pelo chamador e executa-se quando o destino Task termina. A continuação é executada com base num conjunto de condições especificadas.
ContinueWith(Action<Task,Object>, Object, TaskScheduler)

Cria uma continuação que recebe informação de estado fornecida pelo chamador e executa assíncrona quando o destino Task termina. A continuação utiliza um escalonador especificado.
ContinueWith(Action<Task,Object>, Object)

Cria uma continuação que recebe informações de estado fornecidas pelo chamador e executa-se quando o destino Task termina.
ContinueWith(Action<Task>, CancellationToken, TaskContinuationOptions, TaskScheduler)

Cria uma continuação que se executa quando a tarefa-alvo compete de acordo com o especificado TaskContinuationOptions. A continuação recebe um token de cancelamento e utiliza um escalonador especificado.
ContinueWith(Action<Task>, CancellationToken)

Cria uma continuação que recebe um token de cancelamento e executa assíncronamente quando o destino Task é concluído.
ContinueWith(Action<Task>, TaskContinuationOptions)

Cria uma continuação que se executa quando a tarefa alvo é concluída de acordo com o especificado TaskContinuationOptions.
ContinueWith(Action<Task>, TaskScheduler)

Cria uma continuação que é executada assíncrona quando o destino Task termina. A continuação utiliza um escalonador especificado.
ContinueWith(Action<Task>)

Cria uma continuação que é executada assíncrona quando o destino Task termina.
ContinueWith<TResult>(Func<Task,Object,TResult>, Object, CancellationToken, TaskContinuationOptions, TaskScheduler)

Cria uma continuação que é executada com base nas opções de continuação de tarefa especificadas quando o destino Task é concluído e devolve um valor. A continuação recebe informações de estado fornecidas pelo chamador e um token de cancelamento, utilizando o escalonador especificado.
ContinueWith<TResult>(Func<Task,Object,TResult>, Object, CancellationToken)

Cria uma continuação que se executa assíncrona quando o destino Task termina e devolve um valor. A continuação recebe informações de estado fornecidas pelo chamador e um token de cancelamento.
ContinueWith<TResult>(Func<Task,Object,TResult>, Object, TaskContinuationOptions)

Cria uma continuação que é executada com base nas opções de continuação da tarefa especificadas quando o destino Task é concluído. A continuação recebe informações de estado fornecidas pelo chamador.
ContinueWith<TResult>(Func<Task,Object,TResult>, Object, TaskScheduler)

Cria uma continuação que é executada assíncrona quando o destino Task termina. A continuação recebe informações de estado fornecidas pelo chamador e utiliza um agendador especificado.
ContinueWith<TResult>(Func<Task,Object,TResult>, Object)

Cria uma continuação que recebe informação de estado fornecida pelo chamador e executa assíncronamente quando o destino Task termina e devolve um valor.
ContinueWith<TResult>(Func<Task,TResult>, CancellationToken, TaskContinuationOptions, TaskScheduler)

Cria uma continuação que se executa de acordo com as opções de continuação especificadas e devolve um valor. A continuação recebe um token de cancelamento e utiliza um escalonador especificado.
ContinueWith<TResult>(Func<Task,TResult>, CancellationToken)

Cria uma continuação que se executa assíncrona quando o destino Task termina e devolve um valor. A continuação recebe um token de cancelamento.
ContinueWith<TResult>(Func<Task,TResult>, TaskContinuationOptions)

Cria uma continuação que se executa de acordo com as opções de continuação especificadas e devolve um valor.
ContinueWith<TResult>(Func<Task,TResult>, TaskScheduler)

Cria uma continuação que se executa assíncrona quando o destino Task termina e devolve um valor. A continuação utiliza um escalonador especificado.
ContinueWith<TResult>(Func<Task,TResult>)

Cria uma continuação que se executa assíncrona quando o destino Task<TResult> termina e devolve um valor.
Delay(Int32, CancellationToken)

Cria uma tarefa cancelável que se completa após um número especificado de milissegundos.
Delay(Int32)

Cria uma tarefa que se completa após um número especificado de milissegundos.
Delay(TimeSpan, CancellationToken)

Cria uma tarefa cancelável que é concluída após um intervalo de tempo especificado.
Delay(TimeSpan)

Cria uma tarefa que é concluída após um intervalo de tempo especificado.
Dispose()

Liberta todos os recursos usados pela instância atual da Task classe.
Dispose(Boolean)

Elimina o Task, libertando todos os seus recursos não geridos.
Equals(Object)

Determina se o objeto especificado é igual ao objeto atual.

(Herdado de Object)
FromCanceled(CancellationToken)

Cria um Task que é concluído devido ao cancelamento com um token de cancelamento especificado.
FromCanceled<TResult>(CancellationToken)

Cria um Task<TResult> que é concluído devido ao cancelamento com um token de cancelamento especificado.
FromException(Exception)

Cria um Task que terminou com uma exceção especificada.
FromException<TResult>(Exception)

Cria um Task<TResult> que é concluído com uma exceção especificada.
FromResult<TResult>(TResult)

Cria um Task<TResult> que é concluído com sucesso com o resultado especificado.
GetAwaiter()

Acostuma um empregado para esperar por isto Task.
GetHashCode()

Serve como função de hash predefinida.

(Herdado de Object)
GetType()

Obtém o Type da instância atual.

(Herdado de Object)
MemberwiseClone()

Cria uma cópia superficial do atual Object.

(Herdado de Object)
Run(Action, CancellationToken)

Coloca o trabalho especificado para executar no pool de threads e devolve um Task objeto que representa esse trabalho. Um token de cancelamento permite que a obra seja cancelada se ainda não tiver começado.
Run(Action)

Coloca o trabalho especificado para executar no pool de threads e devolve um Task objeto que representa esse trabalho.
Run(Func<Task>, CancellationToken)

Coloca o trabalho especificado na fila para executar no pool de threads e retorna um proxy para a tarefa devolvida por function. Um token de cancelamento permite que a obra seja cancelada se ainda não tiver começado.
Run(Func<Task>)

Coloca o trabalho especificado na fila para executar no pool de threads e retorna um proxy para a tarefa devolvida por function.
Run<TResult>(Func<Task<TResult>>, CancellationToken)

Coloca o trabalho especificado na fila para correr no pool de threads e retorna um proxy para o Task(TResult) devolvido por function.
Run<TResult>(Func<Task<TResult>>)

Coloca o trabalho especificado na fila para correr no pool de threads e retorna um proxy para o Task(TResult) devolvido por function. Um token de cancelamento permite que a obra seja cancelada se ainda não tiver começado.
Run<TResult>(Func<TResult>, CancellationToken)

Coloca o trabalho especificado para executar no pool de threads e devolve um Task(TResult) objeto que representa esse trabalho.
Run<TResult>(Func<TResult>)

Coloca o trabalho especificado para executar no pool de threads e devolve um Task<TResult> objeto que representa esse trabalho. Um token de cancelamento permite que a obra seja cancelada se ainda não tiver começado.
RunSynchronously()

Executa sincronizadamente Task com a corrente TaskScheduler.
RunSynchronously(TaskScheduler)

Executa o Task sistema síncronicamente no TaskScheduler fornecido.
Start()

Inicia o Task, agendando-o para execução para o atual TaskScheduler.
Start(TaskScheduler)

Inicia o Task, agendando-o para execução ao especificado TaskScheduler.
ToString()

Devolve uma cadeia que representa o objeto atual.

(Herdado de Object)
Wait()

Espera que a Task execução seja concluída.
Wait(CancellationToken)

Espera que a Task execução seja concluída. A espera termina se um token de cancelamento for cancelado antes da tarefa concluir.
Wait(Int32, CancellationToken)

Espera que a Task execução seja concluída. A espera termina se passar um intervalo de tempo ou se um token de cancelamento for cancelado antes da tarefa ser concluída.
Wait(Int32)

Espera que a Task execução seja concluída dentro de um número especificado de milissegundos.
Wait(TimeSpan)

Espera que a Task execução seja concluída dentro de um intervalo de tempo especificado.
WaitAll(Task[], CancellationToken)

Espera que todos os objetos fornecidos Task concluam a execução, a menos que a espera seja cancelada.
WaitAll(Task[], Int32, CancellationToken)

Espera que todos os objetos fornecidos Task completem a execução dentro de um número especificado de milissegundos ou até que a espera seja cancelada.
WaitAll(Task[], Int32)

Espera que todos os objetos fornecidos Task concluam a execução dentro de um número especificado de milissegundos.
WaitAll(Task[], TimeSpan)

Espera que todos os objetos canceláveis Task fornecidos concluam a execução dentro de um intervalo de tempo especificado.
WaitAll(Task[])

Espera que todos os objetos fornecidos Task sejam concluídos na execução.
WaitAny(Task[], CancellationToken)

Espera que qualquer um dos objetos fornecidos Task conclua a execução, a menos que a espera seja cancelada.
WaitAny(Task[], Int32, CancellationToken)

Aguarda que qualquer um dos objetos fornecidos Task complete a execução dentro de um número especificado de milissegundos ou até que um token de cancelamento seja cancelado.
WaitAny(Task[], Int32)

Aguarda que qualquer um dos objetos fornecidos Task complete a execução dentro de um número especificado de milissegundos.
WaitAny(Task[], TimeSpan)

Aguarda que qualquer um dos objetos fornecidos Task complete a execução dentro de um intervalo de tempo especificado.
WaitAny(Task[])

Espera que qualquer um dos objetos fornecidos Task complete a execução.
WhenAll(IEnumerable<Task>)

Cria uma tarefa que será concluída quando todos os Task objetos de uma coleção enumerável estiverem concluídos.
WhenAll(Task[])

Cria uma tarefa que será concluída quando todos os Task objetos de um array estiverem concluídos.
WhenAll<TResult>(IEnumerable<Task<TResult>>)

Cria uma tarefa que será concluída quando todos os Task<TResult> objetos de uma coleção enumerável estiverem concluídos.
WhenAll<TResult>(Task<TResult>[])

Cria uma tarefa que será concluída quando todos os Task<TResult> objetos de um array estiverem concluídos.
WhenAny(IEnumerable<Task>)

Cria uma tarefa que será concluída quando qualquer uma das tarefas fornecidas estiver concluída.
WhenAny(Task[])

Cria uma tarefa que será concluída quando qualquer uma das tarefas fornecidas estiver concluída.
WhenAny<TResult>(IEnumerable<Task<TResult>>)

Cria uma tarefa que será concluída quando qualquer uma das tarefas fornecidas estiver concluída.
WhenAny<TResult>(Task<TResult>[])

Cria uma tarefa que será concluída quando qualquer uma das tarefas fornecidas estiver concluída.
Yield()

Cria uma tarefa aguardável que retorna assíncronamente ao contexto atual quando aguardada.

Implementações de Interface Explícita

Name Description
IAsyncResult.AsyncWaitHandle

Obtém um WaitHandle que pode ser usado para esperar que a tarefa seja concluída.
IAsyncResult.CompletedSynchronously

Obtém uma indicação de se a operação foi concluída de forma síncrona.

Métodos da Extensão

Name Description
AsAsyncAction(Task)

Retorna uma ação assíncrona do Windows Runtime que representa uma tarefa iniciada.
DispatcherOperationWait(Task, TimeSpan)

Espera o tempo especificado para que o subjacente DispatcherOperation seja concluído.
DispatcherOperationWait(Task)

Espera indefinidamente que o subjacente DispatcherOperation seja concluído.
IsDispatcherOperationTask(Task)

Devolve um valor que indica se isto Task está associado a um DispatcherOperation.

Aplica-se a

Segurança de Thread

Todos os membros de Task, exceto Dispose(), são seguros para threads e podem ser usados a partir de múltiplas threads em simultâneo.

Ver também