WebUIBackgroundTaskInstance.Current Propriété
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
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é
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.