Task Classe

Definição

Namespace:
System.Threading.Tasks
Assemblies:
mscorlib.dll, System.Threading.Tasks.dll
Assembly:
mscorlib.dll
Assembly:
System.Threading.Tasks.dll
Assembly:
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

Comentários

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

Construtores

Nome 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, o estado e as opções especificados.
Task(Action<Object>, Object, CancellationToken)

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

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

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

Propriedades

Nome Description
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 atualmente em execução Task.
Exception

Obtém o AggregateException que causou o Task fim 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 Task e Task<TResult> instâncias.
Id

Obtém uma ID para essa Task instância.
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 a TaskStatus tarefa.

Métodos

Nome Description
ConfigureAwait(Boolean)

Configura um aguardador usado para aguardar isso Task.
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 destino Task é 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, 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 destino Task é concluído.
ContinueWith(Action<Task,Object>, Object, TaskContinuationOptions)

Cria uma continuação que recebe informações de estado fornecidas pelo chamador e é executada quando o destino Task é 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 destino Task é concluído. A continuação usa um agendador especificado.
ContinueWith(Action<Task,Object>, Object)

Cria uma continuação que recebe informações de estado fornecidas pelo chamador e é executada quando o destino Task é concluído.
ContinueWith(Action<Task>, CancellationToken, TaskContinuationOptions, TaskScheduler)

Cria uma continuação que é executada quando a tarefa de destino compete de acordo com a especificada TaskContinuationOptions. A continuação recebe um token de cancelamento e usa um agendador especificado.
ContinueWith(Action<Task>, CancellationToken)

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

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

Cria uma continuação que é executada de forma assíncrona quando o destino Task é concluído. A continuação usa um agendador especificado.
ContinueWith(Action<Task>)

Cria uma continuação que é executada de forma assíncrona quando o destino Task é concluído.
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 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, CancellationToken)

Cria uma continuação que é executada de forma assíncrona quando o destino Task é 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, TaskContinuationOptions)

Cria uma continuação que é executada com base nas opções de continuação de 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 de forma assíncrona quando o destino Task é concluído. A continuação recebe informações de estado fornecidas pelo chamador e 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 destino Task é concluído e retorna um valor.
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>, CancellationToken)

Cria uma continuação que é executada de forma assíncrona quando o destino Task é concluído e retorna um valor. A continuação recebe um token de cancelamento.
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 destino Task é concluído e retorna um valor. A continuação usa um agendador especificado.
ContinueWith<TResult>(Func<Task,TResult>)

Cria uma continuação que é executada de forma assíncrona quando o destino Task<TResult> é concluído e retorna um valor.
Delay(Int32, CancellationToken)

Cria uma tarefa cancelável que é concluída após um número especificado de milissegundos.
Delay(Int32)

Cria uma tarefa que é concluída 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()

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

Descarta a Taskliberação de 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 aguardador usado para aguardar isso Task.
GetHashCode()

Serve como a função hash predefinida.

(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, 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(Action)

Enfileira o trabalho especificado para ser executado no pool de threads e retorna um objeto Task que representa esse trabalho.
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(Func<Task>)

Enfileira o trabalho especificado para ser executado no pool de threads e retorna um proxy para a tarefa retornada por function.
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<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<TResult>, CancellationToken)

Enfileira o trabalho especificado para ser executado no pool de threads e retorna um objeto Task(TResult) que representa esse trabalho.
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.
RunSynchronously()

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

Executa a Task síncrona 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 para o especificado TaskScheduler.
ToString()

Retorna uma cadeia de caracteres que representa o objeto atual.

(Herdado de Object)
Wait()

Aguarda a conclusão da Task execução.
Wait(CancellationToken)

Aguarda a conclusão da Task execução. A espera será encerrada se um token de cancelamento for cancelado antes da conclusão da tarefa.
Wait(Int32, CancellationToken)

Aguarda a conclusão da Task 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(Int32)

Aguarda a conclusão da Task execução dentro de um número especificado de milissegundos.
Wait(TimeSpan)

Aguarda a conclusão da Task execução dentro de um intervalo de tempo especificado.
WaitAll(Task[], CancellationToken)

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

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

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

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

Aguarda que todos os objetos fornecidos Task concluam a execução.
WaitAny(Task[], CancellationToken)

Aguarda 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 conclua 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 conclua a execução dentro de um número especificado de milissegundos.
WaitAny(Task[], TimeSpan)

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

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

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

Cria uma tarefa que será concluída quando todos os Task objetos em uma matriz forem concluídos.
WhenAll<TResult>(IEnumerable<Task<TResult>>)

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

Cria uma tarefa que será concluída quando todos os Task<TResult> objetos 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[])

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>[])

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

Nome Description
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

Nome Description
AsAsyncAction(Task)

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

Aguarda a quantidade de tempo especificada para que o subjacente DispatcherOperation seja concluído.
DispatcherOperationWait(Task)

Aguarda indefinidamente a conclusão DispatcherOperation do subjacente.
IsDispatcherOperationTask(Task)

Retorna um valor que indica se isso Task está associado a um DispatcherOperation.

Aplica-se a

Acesso thread-safe

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

Confira também