Task Classe
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
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
-
Task
- Derivado
- Implementações
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á |
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 |
Run(Func<Task>, CancellationToken) |
Enfileira o trabalho especificado para ser executado no pool de threads e retorna um proxy para a tarefa retornada por |
Run<TResult>(Func<Task<TResult>>) |
Enfileira o trabalho especificado para execução no pool de threads e retorna um proxy para o |
Run<TResult>(Func<Task<TResult>>, CancellationToken) |
Enfileira o trabalho especificado para execução no pool de threads e retorna um proxy para o |
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 |
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(IEnumerable<Task>, CancellationToken) |
Aguarda que todos os objetos Task fornecidos concluam a execução, a menos que a espera seja cancelada. |
WaitAll(ReadOnlySpan<Task>) |
Aguarda que todos os objetos de Task fornecidos concluam 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(ReadOnlySpan<Task>) |
Cria uma tarefa que será concluída quando todas as tarefas fornecidas forem concluídas. |
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>(ReadOnlySpan<Task<TResult>>) |
Cria uma tarefa que será concluída quando todas as tarefas fornecidas forem concluídas. |
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(ReadOnlySpan<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>(ReadOnlySpan<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. |
WhenEach(IEnumerable<Task>) |
Cria um IAsyncEnumerable<T> que produzirá as tarefas fornecidas à medida que essas tarefas forem concluídas. |
WhenEach(ReadOnlySpan<Task>) |
Cria um IAsyncEnumerable<T> que produzirá as tarefas fornecidas à medida que essas tarefas forem concluídas. |
WhenEach(Task[]) |
Cria um IAsyncEnumerable<T> que produzirá as tarefas fornecidas à medida que essas tarefas forem concluídas. |
WhenEach<TResult>(IEnumerable<Task<TResult>>) |
Cria um IAsyncEnumerable<T> que produzirá as tarefas fornecidas à medida que essas tarefas forem concluídas. |
WhenEach<TResult>(ReadOnlySpan<Task<TResult>>) |
Cria um IAsyncEnumerable<T> que produzirá as tarefas fornecidas à medida que essas tarefas forem concluídas. |
WhenEach<TResult>(Task<TResult>[]) |
Cria um IAsyncEnumerable<T> que produzirá as tarefas fornecidas à medida que essas tarefas forem concluídas. |
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. |
DispatcherOperationWait(Task) |
Aguarda indefinidamente a conclusão da DispatcherOperation subjacente. |
DispatcherOperationWait(Task, TimeSpan) |
Aguarda a quantidade de tempo especificada para que o DispatcherOperation subjacente seja concluído. |
IsDispatcherOperationTask(Task) |
Retorna um valor que indica se esse 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
- 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