TimeTrigger Класс

Определение

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

Windows.ApplicationModel.Background

Представляет событие времени, которое запускает фоновую задачу для выполнения.

public ref class TimeTrigger sealed

/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Standard)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.MTA)]
/// [Windows.Foundation.Metadata.Activatable(Windows.ApplicationModel.Background.ITimeTriggerFactory, 65536, "Windows.Foundation.UniversalApiContract")]
class TimeTrigger final

[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Standard)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.MTA)]
[Windows.Foundation.Metadata.Activatable(typeof(Windows.ApplicationModel.Background.ITimeTriggerFactory), 65536, "Windows.Foundation.UniversalApiContract")]
public sealed class TimeTrigger

function TimeTrigger(freshnessTime, oneShot)

Public NotInheritable Class TimeTrigger

Наследование

Object Platform::Object IInspectable TimeTrigger

Атрибуты

ActivatableAttribute ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Реализации

IBackgroundTrigger

Требования к Windows

Семейство устройств	Windows 10 (появилось в 10.0.10240.0)
API contract	Windows.Foundation.UniversalApiContract (появилось в v1.0)

Примеры

В следующем примере показано, как создать и зарегистрировать триггер времени.

//
// A friendly task name.
//
String name = "ExampleTaskName";

//
// Must be the same entry point that is specified in the manifest.
//
String taskEntryPoint = "ExampleNamespace.ExampleTaskName";

//
// A time trigger that repeats at 15-minute intervals.
//
IBackgroundTrigger trigger = new TimeTrigger(15, false);

//
// Builds the background task.
//
BackgroundTaskBuilder builder = new BackgroundTaskBuilder();

builder.Name = name;
builder.TaskEntryPoint = taskEntryPoint;
builder.SetTrigger(trigger);

//
// Registers the background task, and get back a BackgroundTaskRegistration object representing the registered task.
//
BackgroundTaskRegistration task = builder.Register();

Комментарии

Перед успешной регистрацией фоновая задача должна быть объявлена в манифесте. Вам не нужно добавлять приложение на экран блокировки, чтобы использовать фоновые задачи в Windows 10, но вам все равно нужно вызвать BackgroundExecutionManager.RequestAccessAsync , чтобы запросить фоновый доступ.

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

Примечание

Этот класс не является гибким, что означает, что необходимо учитывать его потоковую модель и поведение маршалинга. Дополнительные сведения см. в разделах Потоки и маршалинг (C++/CX) и Использование объектов среда выполнения Windows в многопоточной среде (.NET).

Конструкторы

TimeTrigger(UInt32, Boolean)

Инициализирует новый экземпляр триггера события времени.

Свойства

FreshnessTime	Возвращает интервал триггера события времени.
OneShot	Возвращает значение, указывающее, будет ли триггер события времени использоваться только один раз или каждый раз, когда истекает интервал FreshnessTime .