Compartir a través de


task_completion_event (Clase)

La clase task_completion_event permite retrasar la ejecución de una tarea hasta que se satisfaga una condición, o iniciar una tarea en respuesta a un evento externo.

template<
   typename _ResultType
>
class task_completion_event;

template<>
class task_completion_event<void>;

Parámetros

  • _ResultType
    El tipo de resultado de esta clase task_completion_event.

  • T

Miembros

Constructores públicos

Name

Descripción

task_completion_event::task_completion_event (Constructor)

Construye un objeto task_completion_event.

Métodos públicos

Name

Descripción

task_completion_event::set (Método)

Sobrecargado. Establece el evento de finalización de la tarea.

task_completion_event::set_exception (Método)

Sobrecargado. Propaga una excepción a todas las tareas asociadas con este evento.

Comentarios

Use una tarea creada a partir de un evento de finalización de la tarea cuando su escenario requiere la creación de una tarea que completar, y así tendrá las continuaciones programadas para su ejecución en el futuro. task_completion_event debe tener el mismo tipo que la tarea que se crea, así como poder llamar al método set en el evento de finalización de la tarea con un valor de ese tipo, lo que provocará que se complete la tarea asociada y proporcionará ese valor como resultado de sus continuaciones.

Si el evento de finalización de la tarea nunca se señala, cualquier tarea creada a partir de ese evento se cancelará cuando se destruye.

El objeto task_completion_event se comporta como un puntero inteligente y debe pasar por valor.

Jerarquía de herencia

task_completion_event

Requisitos

Encabezado: ppltasks.h

Espacio de nombres: simultaneidad

Vea también

Referencia

concurrency (Espacio de nombres)

task (Clase)