WebUIBackgroundTaskInstance.Current Свойство

Определение

Пространство имен:

Windows.UI.WebUI

Возвращает текущую фоновую задачу.

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

Значение свойства

IWebUIBackgroundTaskInstance

Текущая фоновая задача. Доступ к этому свойству можно получить только в контексте фоновой задачи. Это свойство имеет значение NULL в приложении переднего плана.

Комментарии

Приложение создает фоновую задачу с помощью класса BackgroundTaskBuilder . Для метода SetTrigger необходимо задать триггер события для задачи. TaskEntryPoint должен указать файл JavaScript, содержащий код для запуска. Затем приложение регистрирует фоновую задачу, вызывая метод Register . При срабатывании триггера система выполняет код в файле JavaScript.

Приложение также должно указать файл JavaScript в <Extensions> разделе манифеста приложения. Например: <Extension Category="windows.backgroundTasks" StartPage = "js\backgroundtask.js">..

При выполнении фоновой задачи она может использовать объект, возвращенный из свойства Current, чтобы задать успешное или неудачное выполнение фоновой задачи и получить доступ к свойствам задачи.

После завершения фоновой задачи задача должна вызвать метод закрытия рабочих веб-ролей, чтобы завершить работу. Таким образом, он не будет продолжать потреблять память и батарею пользователя. Кроме того, одновременно может выполняться только одна фоновая задача для одного триггера, поэтому предыдущую задачу необходимо закрыть, прежде чем можно будет активировать новую.

Примечание

Фоновые задачи предназначены для кратковременных задач. Как правило, не следует регистрироваться для обратных вызовов событий в фоновой задаче. Если вы регистрируетесь для события среда выполнения Windows, а экземпляр приложения переднего плана также регистрируется для этого события, обратный вызов в фоновой задаче может оказаться ненадежным.