WebUIBackgroundTaskInstance.Current Eigenschaft

Definition

Namespace:

Windows.UI.WebUI

Ruft die aktuelle Hintergrundaufgabe ab.

public:
 static property IWebUIBackgroundTaskInstance ^ Current { IWebUIBackgroundTaskInstance ^ get(); };

static IWebUIBackgroundTaskInstance Current();

public static IWebUIBackgroundTaskInstance Current { get; }

var iWebUIBackgroundTaskInstance = WebUIBackgroundTaskInstance.current;

Public Shared ReadOnly Property Current As IWebUIBackgroundTaskInstance

Eigenschaftswert

IWebUIBackgroundTaskInstance

Die aktuelle Hintergrundaufgabe. Auf diese Eigenschaft kann nur im Kontext einer Hintergrundaufgabe zugegriffen werden. Diese Eigenschaft ist null in einer Vordergrund-App.

Hinweise

Eine App erstellt mithilfe der BackgroundTaskBuilder-Klasse eine Hintergrundaufgabe. Die SetTrigger-Methode muss auf den Ereignistrigger für den Task festgelegt werden. TaskEntryPoint muss eine JavaScript-Datei angeben, die den auszuführenden Code enthält. Die App registriert dann die Hintergrundaufgabe, indem sie die Register-Methode aufruft. Wenn der Trigger ausgelöst wird, führt das System den Code in der JavaScript-Datei aus.

Die App muss auch die JavaScript-Datei im <Extensions> Abschnitt des App-Manifests angeben. Beispiel: <Extension Category="windows.backgroundTasks" StartPage = "js\backgroundtask.js">..

Wenn eine Hintergrundaufgabe ausgeführt wird, kann sie das von der Current-Eigenschaft zurückgegebene Objekt verwenden, um den Erfolg oder Fehler der Hintergrundaufgabe festzulegen und auf Die Eigenschaften der Aufgabe zuzugreifen.

Nachdem die Hintergrundaufgabe ihre Arbeit abgeschlossen hat, muss die Aufgabe die Web Worker-Close-Methode aufrufen, um sich selbst zu beenden. Auf diese Weise wird der Arbeitsspeicher und Akku des Benutzers nicht mehr verbraucht. Darüber hinaus kann nur eine Hintergrundaufgabe für denselben Trigger gleichzeitig ausgeführt werden, sodass die vorherige Aufgabe geschlossen werden muss, bevor ein neuer Task ausgelöst werden kann.

Hinweis

Hintergrundaufgaben sind kurzlebige Aufgaben. Im Allgemeinen sollten Sie sich nicht für Ereignisrückrufe in einer Hintergrundaufgabe registrieren. Wenn Sie sich für ein Windows-Runtime-Ereignis registrieren und der Vordergrund instance Ihrer App auch für dieses Ereignis registriert wird, ist der Rückruf in Ihrer Hintergrundaufgabe möglicherweise unzuverlässig.