WebUIBackgroundTaskInstance.Current Propiedad

Definición

Espacio de nombres:

Windows.UI.WebUI

Obtiene la tarea en segundo plano actual.

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

Valor de propiedad

IWebUIBackgroundTaskInstance

Tarea en segundo plano actual. Solo se puede acceder a esta propiedad en el contexto de una tarea en segundo plano. Esta propiedad es null en una aplicación en primer plano.

Comentarios

Una aplicación crea una tarea en segundo plano mediante la clase BackgroundTaskBuilder . El método SetTrigger debe establecerse en el desencadenador de eventos para la tarea. TaskEntryPoint debe especificar un archivo JavaScript que contenga el código que se va a ejecutar. A continuación, la aplicación registra la tarea en segundo plano llamando al método Register . Cuando se activa el desencadenador, el sistema ejecuta el código en el archivo JavaScript.

La aplicación también debe especificar el archivo JavaScript en la <Extensions> sección del manifiesto de la aplicación. Por ejemplo: <Extension Category="windows.backgroundTasks" StartPage = "js\backgroundtask.js">..

Cuando se ejecuta una tarea en segundo plano, puede usar el objeto devuelto desde la propiedad Current para establecer el éxito o error de la tarea en segundo plano y para tener acceso a las propiedades de la tarea.

Una vez finalizada la tarea en segundo plano, la tarea debe llamar al método close Trabajos web para finalizarse. De este modo, no sigue usando la memoria y la batería del usuario. Además, solo se puede ejecutar una tarea en segundo plano para el mismo desencadenador a la vez, por lo que la tarea anterior debe cerrarse antes de que se pueda desencadenar una nueva.

Nota

Las tareas en segundo plano están pensadas para ser tareas de corta duración. En general, no debe registrarse para devoluciones de llamada de eventos en una tarea en segundo plano. En caso de que se registre para un evento de Windows Runtime y la instancia de primer plano de la aplicación también se registra para ese evento, la devolución de llamada en la tarea en segundo plano puede no ser confiable.