Compartilhar via


Classe task_completion_event

A classe task_completion_event permite que você atrase a execução de uma tarefa até que uma condição seja satisfeita, ou inicie uma tarefa em resposta a um evento externo.

template<
   typename _ResultType
>
class task_completion_event;

template<>
class task_completion_event<void>;

Parâmetros

  • _ResultType
    O tipo de resultado desta tarefa de task_completion_event.

  • T

Membros

Construtores Públicos

Nome

Descrição

Construtor task_completion_event::task_completion_event

Constrói um objeto task_completion_event.

Métodos Públicos

Nome

Descrição

Método task_completion_event::set

Sobrecarregado. Defina o evento de conclusão de tarefas.

Método task_completion_event::set_exception

Sobrecarregado. Propaga uma exceção a todas as tarefas associadas a esse evento.

Comentários

Use uma tarefa criada de um evento de conclusão de tarefa quando seu cenário exigir que você crie uma tarefa que será concluída e, portanto, terá suas continuações agendadas para execução, em algum ponto no futuro. O task_completion_event deve ter o mesmo tipo que a tarefa que você cria, e chamar o método definido no evento de conclusão da tarefa com um valor desse tipo fará com que a tarefa associada seja concluída, e fornecerá esse valor como resultado às suas continuações.

Se o evento de conclusão da tarefa nunca é sinalizado, todas as tarefas criadas a partir dele serão canceladas quando ele for destruído.

task_completion_event se comporta como um ponteiro inteligente e deve ser passado por um valor.

Hierarquia de Herança

task_completion_event

Requisitos

Cabeçalho: ppltasks.h

Namespace: simultaneidade

Consulte também

Referência

Namespace Concurrency

Classe task