Task Classe

  • Referência

Definição

Namespace:
System.Threading.Tasks
Assembly:
System.Threading.Tasks.dll
Assembly:
System.Runtime.dll
Assembly:
mscorlib.dll
Assembly:
netstandard.dll
Origem:
Task.cs
Origem:
Task.cs
Origem:
Task.cs

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

Comentários

Para obter mais informações sobre essa API, consulte Comentários da API Complementar para Tarefa.

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 a ação especificada e opções de criação.
Task(Action, TaskCreationOptions)

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

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

Inicializa um novo Task com a ação, o estado e CancellationTokeno .
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 não foi fornecido.
CompletedTask

Obtém uma tarefa que já foi concluída com êxito.
CreationOptions

Obtém o TaskCreationOptions usado para criar esta tarefa.
CurrentId

Retorna a ID de execução que atualmente está executando Task.
Exception

Obtém o AggregateException que fez com que o Task fosse encerrado prematuramente. Se o Task tiver sido concluído com êxito ou ainda não tiver lançado exceções, isso retornará null.
Factory

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

Obtém uma ID para esta instância Task.
IsCanceled

Obtém se essa instância Task concluiu sua execução porque foi cancelada.
IsCompleted

Obtém um valor que indica se a tarefa foi concluída.
IsCompletedSuccessfully

Determina se a tarefa foi executada até a conclusão.
IsFaulted

Obtém se o Task foi concluído devido a uma exceção sem tratamento.
Status

Obtém o TaskStatus dessa tarefa.

Métodos

ConfigureAwait(Boolean)

Configura um awaiter usado para aguardar este Task.
ConfigureAwait(ConfigureAwaitOptions)

Configura um awaiter usado para aguardar este Task.
ContinueWith(Action<Task,Object>, Object)

Cria uma continuação que recebe informações de estado fornecidas pelo chamador e executa quando Task de destino for concluída.
ContinueWith(Action<Task,Object>, Object, CancellationToken)

Cria uma continuação que recebe informações de estado e um token de cancelamento fornecidos pelo chamador e que será executada de maneira assíncrona quando a Task de destino for concluída.
ContinueWith(Action<Task,Object>, Object, CancellationToken, TaskContinuationOptions, TaskScheduler)

Cria uma continuação que recebe informações de estado e um token de cancelamento fornecidos pelo chamador e que será executada quando a Task de destino for concluída. 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 executa quando Task de destino for concluída. 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 executa de forma assíncrona quando o destino Task for concluído. A continuação usa um agendador especificado.
ContinueWith(Action<Task>)

Criará uma continuação executada de forma assíncrona quando o Task de destino for 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 conforme o TaskContinuationOptions especificado. 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 conforme o TaskContinuationOptions especificado.
ContinueWith(Action<Task>, TaskScheduler)

Criará uma continuação executada de forma assíncrona quando o Task de destino for 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 que é executada de forma assíncrona quando o Task de destino é concluído e retorna um valor.
ContinueWith<TResult>(Func<Task,Object,TResult>, Object, CancellationToken)

Criará uma continuação executada de forma assíncrona quando o Task de destino for concluído e retornar um valor. A continuação recebe informações de estado fornecido pelo chamador e um token de cancelamento.
ContinueWith<TResult>(Func<Task,Object,TResult>, Object, CancellationToken, TaskContinuationOptions, TaskScheduler)

Cria uma continuação executada com base nas opções de continuação de tarefas especificadas quando o Task de destino for concluído e retornar 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 tarefas 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)

Criará uma continuação executada de forma assíncrona quando o Task de destino for concluído. A continuação recebe informações de estado fornecidas pelo chamador e usa um agendador especificado.
ContinueWith<TResult>(Func<Task,TResult>)

Criará uma continuação executada de forma assíncrona quando o Task<TResult> de destino for concluído e retornar um valor.
ContinueWith<TResult>(Func<Task,TResult>, CancellationToken)

Criará uma continuação executada de forma assíncrona quando o Task de destino for concluído e retornar um valor. A continuação recebe um token de cancelamento.
ContinueWith<TResult>(Func<Task,TResult>, CancellationToken, TaskContinuationOptions, TaskScheduler)

Cria uma continuação que executa de acordo com as opções de continuação especificadas e retorna um valor. Um token de cancelamento é passado à continuação e ela usa um agendador especificado.
ContinueWith<TResult>(Func<Task,TResult>, TaskContinuationOptions)

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

Criará uma continuação executada de forma assíncrona quando o Task de destino for concluído e retornar 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 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 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 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 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 foi concluído 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 êxito com o resultado especificado.
GetAwaiter()

Obtém um awaiter 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 Object atual.

(Herdado de Object)
Run(Action)

Coloca o trabalho especificado em fila para execução no pool de threads e retorna um objeto Task que representa o trabalho.
Run(Action, CancellationToken)

Coloca o trabalho especificado em fila para execução no pool de threads e retorna um objeto Task que representa o trabalho. Um token de cancelamento permite que o trabalho seja cancelado caso ele ainda não tenha sido iniciado.
Run(Func<Task>)

Coloca o trabalho especificado na fila para execução no pool de threads e retorna um proxy para a tarefa retornada pelo function.
Run(Func<Task>, CancellationToken)

Coloca o trabalho especificado na fila para execução no pool de threads e retorna um proxy para a tarefa retornada pelo function. Um token de cancelamento permite que o trabalho seja cancelado caso ele ainda não tenha sido iniciado.
Run<TResult>(Func<Task<TResult>>)

Coloca o trabalho especificado na fila para execução no pool de threads e retorna um proxy para Task(TResult) retornado por function. Um token de cancelamento permite que o trabalho seja cancelado caso ele ainda não tenha sido iniciado.
Run<TResult>(Func<Task<TResult>>, CancellationToken)

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

Coloca o trabalho especificado em fila para execução no pool de threads e retorna um objeto Task<TResult> que representa o trabalho. Um token de cancelamento permite que o trabalho seja cancelado caso ele ainda não tenha sido iniciado.
Run<TResult>(Func<TResult>, CancellationToken)

Coloca o trabalho especificado em fila para execução no pool de threads e retorna um objeto Task(TResult) que representa o trabalho.
RunSynchronously()

Executa o Task de forma síncrona no TaskScheduler atual.
RunSynchronously(TaskScheduler)

Executa o Task de forma síncrona no TaskScheduler fornecido.
Start()

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

Inicia o Task, agendando-o para execução no TaskScheduler especificado.
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 termina se um token de cancelamento for cancelado antes que a tarefa seja concluída.
Wait(Int32)

Aguarda o Task concluir 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 expirar ou um token de cancelamento for cancelado antes que a tarefa seja concluída.
Wait(TimeSpan)

Aguarda o Task concluir a execução dentro de um intervalo especificado.
Wait(TimeSpan, CancellationToken)

Aguarda o Task concluir a execução.
WaitAll(Task[])

Aguarda até que todos os objetos Task fornecidos tenham concluído a execução.
WaitAll(Task[], CancellationToken)

Aguarda até que todos os objetos Task fornecidos tenham concluído a execução, a menos que a espera seja cancelada.
WaitAll(Task[], Int32)

Aguarda todos os objetos Task fornecidos concluírem a execução dentro de um número especificado de milissegundos.
WaitAll(Task[], Int32, CancellationToken)

Aguarda todos os objetos Task fornecidos concluírem a execução em um número especificado de milissegundos ou até que a espera seja cancelada.
WaitAll(Task[], TimeSpan)

Aguarda todos os objetos Task canceláveis fornecidos concluírem a execução dentro de um intervalo de tempo especificado.
WaitAny(Task[])

Aguarda até que todos os objetos Task fornecidos tenham concluído a execução.
WaitAny(Task[], CancellationToken)

Aguarda até que os objetos Task fornecidos tenham concluído a execução, a menos que a espera seja cancelada.
WaitAny(Task[], Int32)

Aguarda qualquer um dos objetos Task fornecidos concluírem a execução dentro de um número especificado de milissegundos.
WaitAny(Task[], Int32, CancellationToken)

Aguarda alguns dos objetos Task fornecidos concluírem a execução em um número especificado de milissegundos ou até que o token de cancelamento seja cancelado.
WaitAny(Task[], TimeSpan)

Aguarda algum dos objetos Task fornecidos concluir a execução em um intervalo especificado.
WaitAsync(CancellationToken)

Obtém um Task que será concluído quando isso Task for concluído ou quando o especificado CancellationToken tiver o cancelamento solicitado.
WaitAsync(TimeSpan)

Obtém um Task que será concluído quando isso Task for concluído ou quando o tempo limite especificado expirar.
WaitAsync(TimeSpan, CancellationToken)

Obtém um Task que será concluído quando isso Task for concluído, quando o tempo limite especificado expirar ou quando o especificado CancellationToken tiver o cancelamento solicitado.
WaitAsync(TimeSpan, TimeProvider)

Obtém um Task que será concluído quando isso Task for concluído ou quando o tempo limite especificado expirar.
WaitAsync(TimeSpan, TimeProvider, CancellationToken)

Obtém um Task que será concluído quando isso Task for concluído, quando o tempo limite especificado expirar ou quando o especificado CancellationToken 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 foi concluída
WhenAny(Task, Task)

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

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

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

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

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

Cria uma tarefa que é possível aguardar que retorna assincronamente para o 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

DispatcherOperationWait(Task)

Aguarda indefinidamente a conclusão do DispatcherOperation subjacente.
DispatcherOperationWait(Task, TimeSpan)

Aguarda a conclusão do DispatcherOperation subjacente pelo período de tempo especificado.
IsDispatcherOperationTask(Task)

Retorna um valor que indica se este Task está associado a um DispatcherOperation.
AsAsyncAction(Task)

Retorna uma ação assíncrona do Windows Runtime que representa uma tarefa iniciada.

Aplica-se a

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