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 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á |
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 |
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 |
Run<TResult>(Func<Task<TResult>>) |
Coloca o trabalho especificado na fila para execução no pool de threads e retorna um proxy para |
Run<TResult>(Func<Task<TResult>>, CancellationToken) |
Coloca o trabalho especificado na fila para execução no pool de threads e retorna um proxy para |
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 |
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(IEnumerable<Task>, CancellationToken) |
Representa uma operação assíncrona. |
WaitAll(ReadOnlySpan<Task>) |
Representa uma operação assíncrona. |
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(ReadOnlySpan<Task>) |
Representa uma operação assíncrona. |
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>>) |
Representa uma operação assíncrona. |
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(ReadOnlySpan<Task>) |
Representa uma operação assíncrona. |
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>(ReadOnlySpan<Task<TResult>>) |
Representa uma operação assíncrona. |
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 |
WhenEach(IEnumerable<Task>) |
Representa uma operação assíncrona. |
WhenEach(ReadOnlySpan<Task>) |
Representa uma operação assíncrona. |
WhenEach(Task[]) |
Representa uma operação assíncrona. |
WhenEach<TResult>(IEnumerable<Task<TResult>>) |
Representa uma operação assíncrona. |
WhenEach<TResult>(ReadOnlySpan<Task<TResult>>) |
Representa uma operação assíncrona. |
WhenEach<TResult>(Task<TResult>[]) |
Representa uma operação assíncrona. |
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
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) |
Representa uma operação assíncrona. |
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
Comentários
https://aka.ms/ContentUserFeedback.
Em breve: Ao longo de 2024, eliminaremos os problemas do GitHub como o mecanismo de comentários para conteúdo e o substituiremos por um novo sistema de comentários. Para obter mais informações, consulteEnviar e exibir comentários de