WebUIBackgroundTaskInstance.Current Propriedade

Definição

Namespace:

Windows.UI.WebUI

Obtém a tarefa em segundo plano atual.

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 da propriedade

IWebUIBackgroundTaskInstance

A tarefa em segundo plano atual. Essa propriedade só pode ser acessada no contexto de uma tarefa em segundo plano. Essa propriedade é nula em um aplicativo em primeiro plano.

Comentários

Um aplicativo cria uma tarefa em segundo plano usando a classe BackgroundTaskBuilder . O método SetTrigger deve ser definido como o gatilho de evento para a tarefa. O TaskEntryPoint deve especificar um arquivo JavaScript que contenha o código a ser executado. Em seguida, o aplicativo registra a tarefa em segundo plano chamando o método Register . Quando o gatilho é acionado, o sistema executa o código no arquivo JavaScript.

O aplicativo também deve especificar o arquivo JavaScript na <Extensions> seção do manifesto do aplicativo. Por exemplo: <Extension Category="windows.backgroundTasks" StartPage = "js\backgroundtask.js">..

Quando uma tarefa em segundo plano é executada, ela pode usar o objeto retornado da propriedade Current para definir o êxito ou a falha da tarefa em segundo plano e acessar as propriedades da tarefa.

Depois que a tarefa em segundo plano concluir seu trabalho, a tarefa deverá chamar o método de fechamento de Trabalhos Web para terminar sozinho. Dessa forma, ele não continua consumindo a memória e a bateria do usuário. Além disso, apenas uma tarefa em segundo plano para o mesmo gatilho pode ser executada por vez, portanto, a tarefa anterior deve ser fechada antes que uma nova possa ser disparada.

Observação

As tarefas em segundo plano devem ser tarefas de curta duração. Em geral, você não deve se registrar para retornos de chamada de evento em uma tarefa em segundo plano. No caso de você se registrar para um evento Windows Runtime e a instância em primeiro plano do aplicativo também se registrar para esse evento, o retorno de chamada em sua tarefa em segundo plano pode não ser confiável.