TimeTrigger Classe

Definição

Namespace:

Windows.ApplicationModel.Background

Representa um evento de tempo que dispara uma tarefa em segundo plano a ser executada.

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

Herança

Object Platform::Object IInspectable TimeTrigger

Atributos

ActivatableAttribute ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Implementações

IBackgroundTrigger

Requisitos do Windows

Família de dispositivos	Windows 10 (introduzida na 10.0.10240.0)
API contract	Windows.Foundation.UniversalApiContract (introduzida na v1.0)

Exemplos

O exemplo a seguir mostra como criar e registrar um gatilho de tempo.

//
// 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();

Comentários

A tarefa em segundo plano deve ser declarada no manifesto antes que o registro possa ser bem-sucedido. Você não precisa adicionar o aplicativo à tela de bloqueio para usar tarefas em segundo plano no Windows 10, mas ainda precisa chamar BackgroundExecutionManager.RequestAccessAsync para solicitar acesso em segundo plano.

Os TimeTriggers não funcionam quando o dispositivo está no modo de economia de bateria. Se o usuário quiser que o aplicativo possa executar atividades em segundo plano quando o dispositivo estiver no modo de economia de bateria, ele poderá abrir uma exceção para esse aplicativo no painel Permitir que os aplicativos sejam executados no painel de configurações em segundo plano.

Observação

Essa classe não é ágil, o que significa que você precisa considerar seu modelo de threading e comportamento de marshaling. Para obter mais informações, consulte Threading and Marshaling (C++/CX) e Using Windows Runtime objects in a multithreaded environment (.NET).

Construtores

TimeTrigger(UInt32, Boolean)

Inicializa uma nova instância de um gatilho de evento de tempo.

Propriedades

FreshnessTime	Obtém o intervalo de um gatilho de evento de tempo.
OneShot	Obtém se o gatilho de evento de tempo será usado apenas uma vez ou cada vez que o intervalo FreshnessTime ocorrer.