WebUIBackgroundTaskInstance.Current Propriété

Définition

Espace de noms:

Windows.UI.WebUI

Obtient la tâche en arrière-plan actuelle.

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

Valeur de propriété

IWebUIBackgroundTaskInstance

Tâche en arrière-plan actuelle. Cette propriété est accessible uniquement dans le contexte d’une tâche en arrière-plan. Cette propriété a la valeur Null dans une application de premier plan.

Remarques

Une application crée une tâche en arrière-plan à l’aide de la classe BackgroundTaskBuilder . La méthode SetTrigger doit être définie sur le déclencheur d’événement pour la tâche. TaskEntryPoint doit spécifier un fichier JavaScript contenant le code à exécuter. L’application inscrit ensuite la tâche en arrière-plan en appelant la méthode Register . Lorsque le déclencheur se déclenche, le système exécute le code dans le fichier JavaScript.

L’application doit également spécifier le fichier JavaScript dans la <Extensions> section du manifeste de l’application. Par exemple : <Extension Category="windows.backgroundTasks" StartPage = "js\backgroundtask.js">..

Lorsqu’une tâche en arrière-plan est exécutée, elle peut utiliser l’objet retourné par la propriété Current pour définir la réussite ou l’échec de la tâche en arrière-plan et pour accéder aux propriétés de la tâche.

Une fois que la tâche en arrière-plan a terminé son travail, la tâche doit appeler la méthode close Web Workers pour se terminer elle-même. De cette façon, il ne continue pas à consommer la mémoire et la batterie de l’utilisateur. En outre, une seule tâche en arrière-plan pour le même déclencheur peut s’exécuter à la fois, de sorte que la tâche précédente doit être fermée avant qu’une nouvelle ne puisse être déclenchée.

Notes

Les tâches en arrière-plan sont destinées à être des tâches de courte durée. En général, vous ne devez pas vous inscrire aux rappels d’événements dans une tâche en arrière-plan. Si vous vous inscrivez à un événement Windows Runtime et que le instance de premier plan de votre application s’inscrit également pour cet événement, le rappel de votre tâche en arrière-plan peut ne pas être fiable.