Freigeben über


create_task-Funktion

Erstellt ein Objekt Aufgabe PPL.create_task kann überall Sie haben einen Konstruktor Aufgaben verwendet wird.Es wird hauptsächlich für Benutzerfreundlichkeit bereitgestellt, da es die Verwendung des auto-Schlüsselwort beim Erstellen von Aufgaben ermöglicht.

template<
   typename _Ty
>
auto create_task(
   _Ty_Param
) -> task<typename details::_TaskTypeFromParam<_Ty>::_Type>;

template<
   typename _Ty
>
auto create_task(
   _Ty_Param,
   cancellation_token _Token
) -> task<typename details::_TaskTypeFromParam<_Ty>::_Type>;

Parameter

  • _Ty
    Der Typ des Parameters, von dem die Aufgabe erstellt werden soll.

  • _Param
    Der Parameter, von dem die Aufgabe erstellt werden soll.Diese könnte ein Lambda oder ein Funktionsobjekt, ein task_completion_event ein anderes Objekt task-Objekt oder eine Windows::Foundation::IAsyncInfo-Schnittstelle sein, wenn Sie Aufgaben in der App im Metro-Stil verwenden.

  • _Token
    Das der Aufgabe zuzuordnen, Abbruchtoken.Wenn die Quelle für dieses Token abgebrochen wird, wird das Abbrechen der Aufgabe angefordert.

Rückgabewert

Eine neue Aufgabe des Typs T, das von _Param abgeleitet.

Hinweise

Die erste Überladung verhält sich wie ein Task Konstruktor, der einen einzelnen Parameter akzeptiert.

Die zweite Überladung ordnet das Abbruchtoken, das der neu erstellten Aufgabe bereitgestellt wird.Wenn Sie diese Überladung verwenden, sind Sie nicht in einen anderen task-Objekt als erster Parameter zulässt.

Der Typ der zurückgegebenen Aufgabe wird vom ersten Parameter der Funktion abgeleitet.Wenn _Paramtask_completion_event<T>, task<T> oder ein Funktionselement ist, das entweder Typ T oder task<T> zurückgibt, ist der Typ der erstellten Funktion task<T>.

In einer App Metro-Stil wenn im _Param von ^ Typ Windows::Foundation::IAsyncOperation<T>oder ^ Windows::Foundation::IAsyncOperationWithProgress<T, P>ist, oder in ein Funktionselement, das einen dieser Typen zurückgibt, ist die erstellte Funktion vom Typ task<T>.Wenn _Param vom Typ Windows::Foundation::IAsyncAction^ oder ^ Windows::Foundation::IAsyncActionWithProgress<P>oder ein Funktionselement ist, das jeden dieser Typen zurückgibt, hat die task<void>-Typ Aufgabe erstellt hat.

Anforderungen

Header: ppltasks.h

Namespace: Parallelität

Siehe auch

Referenz

concurrency-Namespace

Aufgaben-Klasse

Konzepte

Aufgabenparallelität (Concurrency Runtime)