Hinweis
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, sich anzumelden oder das Verzeichnis zu wechseln.
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, das Verzeichnis zu wechseln.
Mit der task_continuation_context-Klasse können Sie angeben, an welcher Stelle eine Fortsetzung ausgeführt werden soll. Es ist nur nützlich, diese Klasse aus einer Windows-Runtime-App zu verwenden. Bei Nicht-Windows-Runtime-Apps wird der Ausführungskontext der Aufgabenfortsetzung durch die Laufzeit bestimmt und nicht konfigurierbar.
Syntax
class task_continuation_context : public details::_ContextCallback;
Mitglieder
Öffentliche Methoden
| Name | Beschreibung |
|---|---|
| get_current_winrt_context | Gibt ein Aufgabenfortsetzungskontextobjekt zurück, das den aktuellen Winrt-Threadkontext darstellt. |
| willkürlich verwenden | Erstellt einen Aufgabenfortsetzungskontext, der der Laufzeit ermöglicht, den Ausführungskontext für eine Fortsetzung zu wählen. |
| use_current | Gibt ein Kontextobjekt für die Aufgabenfortsetzung zurück, das den aktuellen Ausführungskontext darstellt. |
| Standard verwenden | Erstellt den standardmäßigen Aufgabenfortsetzungskontext. |
| use_synchronous_execution | Gibt ein Aufgabenfortsetzungskontextobjekt zurück, das den synchronen Ausführungskontext darstellt. |
Vererbungshierarchie
_ContextCallback
task_continuation_context
Anforderungen
Kopfzeile: ppltasks.h
Namespace: Parallelität
Aktuellen_WinRT_Kontext_abrufen
Gibt ein Aufgabenfortsetzungskontextobjekt zurück, das den aktuellen WinRT-Threadkontext darstellt.
Syntax
static task_continuation_context get_current_winrt_context();
Rückgabewert
Der aktuelle Windows-Runtime Threadkontext. Gibt eine leere task_continuation_context zurück, wenn sie aus einem Kontext ohne Windows-Runtime aufgerufen wird.
Hinweise
Die get_current_winrt_context Methode erfasst den Windows-Runtime Threadkontext des Aufrufers. Er gibt einen leeren Kontext an Nicht-Windows-Runtime Aufrufer zurück.
Der von get_current_winrt_context zurückgegebene Wert kann verwendet werden, um anzugeben, dass die Fortsetzung im Apartmentmodell des erfassten Kontexts (STA vs MTA) ausgeführt werden soll, unabhängig davon, ob die vorgängige Aufgabe Apartment-bewusst ist. Eine im Kontext einer Apartmentstruktur operierende Aufgabe ist eine Aufgabe, die eine Windows-Runtime-IAsyncInfo-Schnittstelle öffnet, oder eine Aufgabe, die von einer solchen abgeleitet ist.
Diese Methode ähnelt der use_current Methode, ist aber auch für systemeigene c++-Code ohne C++/CX-Erweiterungsunterstützung verfügbar. Sie ist für die Verwendung durch erweiterte Benutzer vorgesehen, die C++/CX-agnostischen Bibliothekscode sowohl für systemeigene als auch für Windows-Runtime Aufrufer schreiben. Sofern Sie diese Funktionalität nicht benötigen, empfehlen wir die use_current Methode, die nur für C++/CX-Clients verfügbar ist.
use_arbitrary
Erstellt einen Aufgabenfortsetzungskontext, der es der Laufzeitumgebung ermöglicht, den Ausführungskontext für eine Fortsetzung auszuwählen.
Syntax
static task_continuation_context use_arbitrary();
Rückgabewert
Ein Aufgabenfortsetzungskontext, der einen beliebigen Ort darstellt.
Hinweise
Wenn dieser Fortsetzungskontext verwendet wird, wird die Fortsetzung in einem Kontext ausgeführt, den die Laufzeit selbst auswählt, auch wenn die Vorgängeraufgabe apartmentfähig ist.
use_arbitrary kann verwendet werden, um das Standardverhalten für eine Fortsetzung einer Apartment-unterstützten Aufgabe zu deaktivieren, die in einem STA erstellt wurde.
Diese Methode ist nur für Windows-Runtime Apps verfügbar.
use_current
Gibt ein Kontextobjekt für die Aufgabenfortsetzung zurück, das den aktuellen Ausführungskontext darstellt.
static task_continuation_context use_current();
Rückgabewert
Der aktuelle Ausführungskontext.
Hinweise
Diese Methode erfasst den Windows-Runtime-Kontext des Aufrufers, sodass Fortsetzungen im richtigen Apartment ausgeführt werden können.
Der Wert, der von use_current zurückgegeben wird, teilt der Runtime mit, dass die Fortsetzung im erfassten Kontext (STA oder MTA) ausgeführt werden soll, unabhängig davon, ob die Vorgängeraufgabe apartmentfähig ist. Eine Apartment-Aware-Task ist eine Aufgabe, die eine Windows Runtime-Schnittstelle entpackt, oder eine Aufgabe, die von einer solchen Aufgabe abgeleitet wird.
Diese Methode ist nur für Windows-Runtime Apps verfügbar.
Standard verwenden
Erstellt den standardmäßigen Aufgabenfortsetzungskontext.
static task_continuation_context use_default();
Rückgabewert
Der standardmäßige Fortsetzungskontext.
Hinweise
Der Standardkontext wird verwendet, wenn Sie beim Aufrufen der then Methode keinen Fortsetzungskontext angeben. In Windows-Anwendungen für Windows 7 und älter sowie in Desktopanwendungen für Windows 8 und höher bestimmt die Laufzeit, wo Aufgabenfortsetzungen ausgeführt werden. In einer Windows-Runtime-App ist jedoch der Standardkontext für Fortsetzungen einer Apartment-aware-Aufgabe das Apartment, in dem then aufgerufen wird.
Eine im Kontext einer Apartmentstruktur operierende Aufgabe ist eine Aufgabe, die eine Windows-Runtime-IAsyncInfo-Schnittstelle öffnet, oder eine Aufgabe, die von einer solchen abgeleitet ist. Wenn Sie eine Fortsetzung einer apartmentfähigen Aufgabe in einem Windows-Runtime-STA planen, wird die Fortsetzung daher in diesem STA ausgeführt.
Eine Fortsetzung einer nicht apartment-bewussten Aufgabe wird in einem Kontext ausgeführt, den die Laufzeitumgebung auswählt.
task_continuation_context::use_synchronous_execution (Verwendung synchroner Ausführung)
Gibt ein Aufgabenfortsetzungskontextobjekt zurück, das den synchronen Ausführungskontext darstellt.
Syntax
static task_continuation_context use_synchronous_execution();
Rückgabewert
Der synchrone Ausführungskontext.
Hinweise
Die use_synchronous_execution Methode erzwingt, dass die Fortsetzungsaufgabe synchron im Kontext ausgeführt wird, was durch den Abschluss der vorhergehenden Aufgabe ausgelöst wird.
Wenn die vorgängige Aufgabe bereits abgeschlossen ist, wenn die Fortsetzung angefügt wird, wird die Fortsetzung synchron im Ausführungskontext ausgeführt, an den die Fortsetzung angefügt wird.