Task Classe

Definição

Namespace:

System.Threading.Tasks

Assembly:

System.Runtime.dll

Origem:

Task.cs

Representa uma operação assíncrona.

public ref class Task : IAsyncResult, IDisposable

public class Task : IAsyncResult, IDisposable

type Task = class
    interface IAsyncResult
    interface IDisposable

Public Class Task
Implements IAsyncResult, IDisposable

Herança

Object

Task

Derivado

System.Threading.Tasks.Task<TResult>

Implementações

IAsyncResult IDisposable

Comentários

Para obter mais informações sobre essa API, consulte comentários da API Suplementar para o Task.

Construtores

Task(Action)	Inicializa um novo Task com a ação especificada.
Task(Action, CancellationToken)	Inicializa um novo Task com a ação especificada e CancellationToken.
Task(Action, CancellationToken, TaskCreationOptions)	Inicializa um novo Task com as opções de ação e criação especificadas.
Task(Action, TaskCreationOptions)	Inicializa um novo Task com as opções de ação e criação especificadas.
Task(Action<Object>, Object)	Inicializa um novo Task com a ação e o estado especificados.
Task(Action<Object>, Object, CancellationToken)	Inicializa um novo Task com a ação, o estado e o CancellationTokenespecificados.
Task(Action<Object>, Object, CancellationToken, TaskCreationOptions)	Inicializa um novo Task com a ação, o estado e as opções especificados.
Task(Action<Object>, Object, TaskCreationOptions)	Inicializa um novo Task com a ação, o estado e as opções especificados.

Propriedades

AsyncState	Obtém o objeto de estado fornecido quando o Task foi criado ou nulo se nenhum foi fornecido.
CompletedTask	Obtém uma tarefa que já foi concluída com êxito.
CreationOptions	Obtém o TaskCreationOptions usado para criar essa tarefa.
CurrentId	Retorna a ID do Taskem execução no momento.
Exception	Obtém o AggregateException que fez com que o Task acabasse prematuramente. Se o Task concluído com êxito ou ainda não tiver gerado exceções, isso retornará null.
Factory	Fornece acesso aos métodos de fábrica para criar e configurar instâncias de Task e Task<TResult>.
Id	Obtém uma ID para esta instância de Task.
IsCanceled	Obtém se essa Task instância concluiu a execução devido ao cancelamento.
IsCompleted	Obtém um valor que indica se a tarefa foi concluída.
IsCompletedSuccessfully	Obtém se a tarefa foi executada até a conclusão.
IsFaulted	Obtém se o Task concluído devido a uma exceção sem tratamento.
Status	Obtém o TaskStatus desta tarefa.

Métodos

ConfigureAwait(Boolean)	Configura um aguardador usado para aguardar esta Task.
ConfigureAwait(ConfigureAwaitOptions)	Configura um aguardador usado para aguardar esta Task.
ContinueWith(Action<Task,Object>, Object)	Cria uma continuação que recebe informações de estado fornecidas pelo chamador e é executada quando o Task de destino é concluído.
ContinueWith(Action<Task,Object>, Object, CancellationToken)	Cria uma continuação que recebe informações de estado fornecidas pelo chamador e um token de cancelamento e que é executado de forma assíncrona quando o Task de destino é concluído.
ContinueWith(Action<Task,Object>, Object, CancellationToken, TaskContinuationOptions, TaskScheduler)	Cria uma continuação que recebe informações de estado fornecidas pelo chamador e um token de cancelamento e que é executado quando o Task de destino é concluído. A continuação é executada com base em um conjunto de condições especificadas e usa um agendador especificado.
ContinueWith(Action<Task,Object>, Object, TaskContinuationOptions)	Cria uma continuação que recebe informações de estado fornecidas pelo chamador e é executada quando o Task de destino é concluído. A continuação é executada com base em um conjunto de condições especificadas.
ContinueWith(Action<Task,Object>, Object, TaskScheduler)	Cria uma continuação que recebe informações de estado fornecidas pelo chamador e é executada de forma assíncrona quando o Task de destino é concluído. A continuação usa um agendador especificado.
ContinueWith(Action<Task>)	Cria uma continuação que é executada de forma assíncrona quando o Task de destino é concluído.
ContinueWith(Action<Task>, CancellationToken)	Cria uma continuação que recebe um token de cancelamento e é executada de forma assíncrona quando o Task de destino é concluído.
ContinueWith(Action<Task>, CancellationToken, TaskContinuationOptions, TaskScheduler)	Cria uma continuação que é executada quando a tarefa de destino compete de acordo com o TaskContinuationOptionsespecificado. A continuação recebe um token de cancelamento e usa um agendador especificado.
ContinueWith(Action<Task>, TaskContinuationOptions)	Cria uma continuação que é executada quando a tarefa de destino é concluída de acordo com o TaskContinuationOptionsespecificado.
ContinueWith(Action<Task>, TaskScheduler)	Cria uma continuação que é executada de forma assíncrona quando o Task de destino é concluído. A continuação usa um agendador especificado.
ContinueWith<TResult>(Func<Task,Object,TResult>, Object)	Cria uma continuação que recebe informações de estado fornecidas pelo chamador e é executada de forma assíncrona quando o Task de destino é concluído e retorna um valor.
ContinueWith<TResult>(Func<Task,Object,TResult>, Object, CancellationToken)	Cria uma continuação que é executada de forma assíncrona quando o Task de destino é concluído e retorna 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, CancellationToken, TaskContinuationOptions, TaskScheduler)	Cria uma continuação que é executada com base nas opções de continuação de tarefa especificadas quando o Task de destino é concluído e retorna um valor. A continuação recebe informações de estado fornecidas pelo chamador e um token de cancelamento e usa o agendador especificado.
ContinueWith<TResult>(Func<Task,Object,TResult>, Object, TaskContinuationOptions)	Cria uma continuação que é executada com base nas opções de continuação de tarefa especificadas quando o Task de destino é 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 de forma assíncrona quando o Task de destino é concluído. A continuação recebe informações de estado fornecidas pelo chamador e usa um agendador especificado.
ContinueWith<TResult>(Func<Task,TResult>)	Cria uma continuação que é executada de forma assíncrona quando o Task<TResult> de destino é concluído e retorna um valor.
ContinueWith<TResult>(Func<Task,TResult>, CancellationToken)	Cria uma continuação que é executada de forma assíncrona quando o Task de destino é concluído e retorna um valor. A continuação recebe um token de cancelamento.
ContinueWith<TResult>(Func<Task,TResult>, CancellationToken, TaskContinuationOptions, TaskScheduler)	Cria uma continuação que é executada de acordo com as opções de continuação especificadas e retorna um valor. A continuação é passada por um token de cancelamento e usa um agendador especificado.
ContinueWith<TResult>(Func<Task,TResult>, TaskContinuationOptions)	Cria uma continuação que é executada de acordo com as opções de continuação especificadas e retorna um valor.
ContinueWith<TResult>(Func<Task,TResult>, TaskScheduler)	Cria uma continuação que é executada de forma assíncrona quando o Task de destino é concluído e retorna um valor. A continuação usa um agendador especificado.
Delay(Int32)	Cria uma tarefa que é concluída após um número especificado de milissegundos.
Delay(Int32, CancellationToken)	Cria uma tarefa cancelável que é concluída após um número especificado de milissegundos.
Delay(TimeSpan)	Cria uma tarefa que é concluída após um intervalo de tempo especificado.
Delay(TimeSpan, CancellationToken)	Cria uma tarefa cancelável que é concluída após um intervalo de tempo especificado.
Delay(TimeSpan, TimeProvider)	Cria uma tarefa que é concluída após um intervalo de tempo especificado.
Delay(TimeSpan, TimeProvider, CancellationToken)	Cria uma tarefa cancelável que é concluída após um intervalo de tempo especificado.
Dispose()	Libera todos os recursos usados pela instância atual da classe Task.
Dispose(Boolean)	Descarta o Task, liberando todos os seus recursos não gerenciados.
Equals(Object)	Determina se o objeto especificado é igual ao objeto atual. (Herdado de Object)
FromCanceled(CancellationToken)	Cria um Task concluído devido ao cancelamento com um token de cancelamento especificado.
FromCanceled<TResult>(CancellationToken)	Cria um Task<TResult> concluído devido ao cancelamento com um token de cancelamento especificado.
FromException(Exception)	Cria um Task concluído com uma exceção especificada.
FromException<TResult>(Exception)	Cria um Task<TResult> concluído com uma exceção especificada.
FromResult<TResult>(TResult)	Cria um Task<TResult> concluído com êxito com o resultado especificado.
GetAwaiter()	Obtém um aguardador usado para aguardar este Task.
GetHashCode()	Serve como a função de hash padrão. (Herdado de Object)
GetType()	Obtém o Type da instância atual. (Herdado de Object)
MemberwiseClone()	Cria uma cópia superficial do Objectatual. (Herdado de Object)
Run(Action)	Enfileira o trabalho especificado para ser executado no pool de threads e retorna um objeto Task que representa esse trabalho.
Run(Action, CancellationToken)	Enfileira o trabalho especificado para ser executado no pool de threads e retorna um objeto Task que representa esse trabalho. Um token de cancelamento permite que o trabalho seja cancelado se ele ainda não tiver sido iniciado.
Run(Func<Task>)	Enfileira o trabalho especificado para ser executado no pool de threads e retorna um proxy para a tarefa retornada por function.
Run(Func<Task>, CancellationToken)	Enfileira o trabalho especificado para ser executado no pool de threads e retorna um proxy para a tarefa retornada por function. Um token de cancelamento permite que o trabalho seja cancelado se ele ainda não tiver sido iniciado.
Run<TResult>(Func<Task<TResult>>)	Enfileira o trabalho especificado para execução no pool de threads e retorna um proxy para o Task(TResult) retornado por function. Um token de cancelamento permite que o trabalho seja cancelado se ele ainda não tiver sido iniciado.
Run<TResult>(Func<Task<TResult>>, CancellationToken)	Enfileira o trabalho especificado para execução no pool de threads e retorna um proxy para o Task(TResult) retornado por function.
Run<TResult>(Func<TResult>)	Enfileira o trabalho especificado para ser executado no pool de threads e retorna um objeto Task<TResult> que representa esse trabalho. Um token de cancelamento permite que o trabalho seja cancelado se ele ainda não tiver sido iniciado.
Run<TResult>(Func<TResult>, CancellationToken)	Enfileira o trabalho especificado para ser executado no pool de threads e retorna um objeto Task(TResult) que representa esse trabalho.
RunSynchronously()	Executa o Task de forma síncrona no TaskScheduleratual.
RunSynchronously(TaskScheduler)	Executa o Task de forma síncrona no TaskScheduler fornecido.
Start()	Inicia o Task, agendando-o para execução no TaskScheduleratual.
Start(TaskScheduler)	Inicia o Task, agendando-o para execução no TaskSchedulerespecificado.
ToString()	Retorna uma cadeia de caracteres que representa o objeto atual. (Herdado de Object)
Wait()	Aguarda o Task concluir a execução.
Wait(CancellationToken)	Aguarda o Task concluir a execução. A espera será encerrada se um token de cancelamento for cancelado antes da conclusão da tarefa.
Wait(Int32)	Aguarda que o Task conclua a execução dentro de um número especificado de milissegundos.
Wait(Int32, CancellationToken)	Aguarda o Task concluir a execução. A espera termina se um intervalo de tempo limite decorrido ou um token de cancelamento for cancelado antes da conclusão da tarefa.
Wait(TimeSpan)	Aguarda que o Task conclua a execução dentro de um intervalo de tempo especificado.
Wait(TimeSpan, CancellationToken)	Aguarda o Task concluir a execução.
WaitAll(Task[])	Aguarda que todos os objetos de Task fornecidos concluam a execução.
WaitAll(Task[], CancellationToken)	Aguarda que todos os objetos Task fornecidos concluam a execução, a menos que a espera seja cancelada.
WaitAll(Task[], Int32)	Aguarda que todos os objetos Task fornecidos concluam a execução dentro de um número especificado de milissegundos.
WaitAll(Task[], Int32, CancellationToken)	Aguarda que todos os objetos Task fornecidos concluam a execução dentro de um número especificado de milissegundos ou até que a espera seja cancelada.
WaitAll(Task[], TimeSpan)	Aguarda que todos os objetos de Task canceláveis fornecidos concluam a execução em um intervalo de tempo especificado.
WaitAny(Task[])	Aguarda que qualquer um dos objetos Task fornecidos conclua a execução.
WaitAny(Task[], CancellationToken)	Aguarda que qualquer um dos objetos Task fornecidos conclua a execução, a menos que a espera seja cancelada.
WaitAny(Task[], Int32)	Aguarda que qualquer um dos objetos Task fornecidos conclua a execução dentro de um número especificado de milissegundos.
WaitAny(Task[], Int32, CancellationToken)	Aguarda que qualquer um dos objetos Task fornecidos conclua a execução dentro de um número especificado de milissegundos ou até que um token de cancelamento seja cancelado.
WaitAny(Task[], TimeSpan)	Aguarda que qualquer um dos objetos Task fornecidos conclua a execução dentro de um intervalo de tempo especificado.
WaitAsync(CancellationToken)	Obtém um Task que será concluído quando esse Task for concluído ou quando o CancellationToken especificado tiver o cancelamento solicitado.
WaitAsync(TimeSpan)	Obtém um Task que será concluído quando esse Task for concluído ou quando o tempo limite especificado expirar.
WaitAsync(TimeSpan, CancellationToken)	Obtém um Task que será concluído quando esse Task for concluído, quando o tempo limite especificado expirar ou quando o CancellationToken especificado tiver o cancelamento solicitado.
WaitAsync(TimeSpan, TimeProvider)	Obtém um Task que será concluído quando esse Task for concluído ou quando o tempo limite especificado expirar.
WaitAsync(TimeSpan, TimeProvider, CancellationToken)	Obtém um Task que será concluído quando esse Task for concluído, quando o tempo limite especificado expirar ou quando o CancellationToken especificado tiver o cancelamento solicitado.
WhenAll(IEnumerable<Task>)	Cria uma tarefa que será concluída quando todos os objetos Task em uma coleção enumerável forem concluídos.
WhenAll(Task[])	Cria uma tarefa que será concluída quando todos os objetos Task em uma matriz forem concluídos.
WhenAll<TResult>(IEnumerable<Task<TResult>>)	Cria uma tarefa que será concluída quando todos os objetos Task<TResult> em uma coleção enumerável forem concluídos.
WhenAll<TResult>(Task<TResult>[])	Cria uma tarefa que será concluída quando todos os objetos Task<TResult> em uma matriz forem concluídos.
WhenAny(IEnumerable<Task>)	Cria uma tarefa que será concluída quando qualquer uma das tarefas fornecidas for concluída.
WhenAny(Task, Task)	Cria uma tarefa que será concluída quando qualquer uma das tarefas fornecidas for concluída.
WhenAny(Task[])	Cria uma tarefa que será concluída quando qualquer uma das tarefas fornecidas for concluída.
WhenAny<TResult>(IEnumerable<Task<TResult>>)	Cria uma tarefa que será concluída quando qualquer uma das tarefas fornecidas for concluída.
WhenAny<TResult>(Task<TResult>, Task<TResult>)	Cria uma tarefa que será concluída quando qualquer uma das tarefas fornecidas for concluída.
WhenAny<TResult>(Task<TResult>[])	Cria uma tarefa que será concluída quando qualquer uma das tarefas fornecidas for concluída.
Yield()	Cria uma tarefa aguardada que retorna de forma assíncrona ao contexto atual quando aguardada.

Implantações explícitas de interface

IAsyncResult.AsyncWaitHandle	Obtém um WaitHandle que pode ser usado para aguardar a conclusão da tarefa.
IAsyncResult.CompletedSynchronously	Obtém uma indicação de se a operação foi concluída de forma síncrona.

Métodos de Extensão

AsyncWait<TException>(Task)	Representa uma operação assíncrona.
AwaitWithTimeout(Task, TimeSpan)	Representa uma operação assíncrona.
ToApm(Task, AsyncCallback, Object)	Representa uma operação assíncrona.
ToApmEnd(IAsyncResult)	Representa uma operação assíncrona.
ToApmEnd<TResult>(IAsyncResult)	Representa uma operação assíncrona.
Wait(Task, TimeSpan, Action<Exception,TimeSpan,String>, String)	Representa uma operação assíncrona.
WaitForCompletion(Task)	Representa uma operação assíncrona.
WaitForCompletionNoSpin(Task)	Representa uma operação assíncrona.
WaitForCompletionNoSpin(Task, TimeSpan)	Representa uma operação assíncrona.
WaitAsync(Task, TimeSpan, TimeProvider, CancellationToken)	Obtém um Task que será concluído quando esse Task for concluído, quando o tempo limite especificado expirar ou quando o CancellationToken especificado tiver o cancelamento solicitado.

Acesso thread-safe

Todos os membros de Task, exceto Dispose(), são thread-safe e podem ser usados de vários threads simultaneamente.

Confira também

• Task<TResult>
• da TPL (Biblioteca Paralela de Tarefas)
• TAP (padrão assíncrono baseado em tarefa) no .NET: introdução e visão geral
• de programação assíncrona baseada em tarefa
• exemplos de programação paralela com o .NET Core e o .NET Standard