TimeTrigger Clase

Definición

Espacio de nombres:

Windows.ApplicationModel.Background

Representa un evento de hora que desencadena una tarea en segundo plano que se va a ejecutar.

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

Herencia

Object Platform::Object IInspectable TimeTrigger

Atributos

ActivatableAttribute ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Implementaciones

IBackgroundTrigger

Requisitos de Windows

Familia de dispositivos	Windows 10 (se introdujo en la versión 10.0.10240.0)
API contract	Windows.Foundation.UniversalApiContract (se introdujo en la versión v1.0)

Ejemplos

En el ejemplo siguiente se muestra cómo crear y registrar un desencadenador de hora.

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

Comentarios

La tarea en segundo plano debe declararse en el manifiesto para que el registro se pueda realizar correctamente. No es necesario agregar la aplicación a la pantalla de bloqueo para usar tareas en segundo plano en Windows 10, pero todavía tienes que llamar a BackgroundExecutionManager.RequestAccessAsync para solicitar acceso en segundo plano.

TimeTriggers no funcionan cuando el dispositivo está en modo de ahorro de batería. Si el usuario quiere que la aplicación pueda realizar la actividad en segundo plano cuando el dispositivo está en modo de ahorro de batería, puede hacer una excepción para esa aplicación en el panel Permitir que las aplicaciones se ejecuten en el panel de configuración en segundo plano .

Nota:

Esta clase no es ágil, lo que significa que debe tener en cuenta su modelo de subprocesos y el comportamiento de serialización. Para obtener más información, vea Subprocesos y serialización (C++/CX) y Uso de objetos Windows Runtime en un entorno multiproceso (.NET).

Constructores

TimeTrigger(UInt32, Boolean)

Inicializa una nueva instancia de un desencadenador de evento de hora.

Propiedades

FreshnessTime	Obtiene el intervalo de un desencadenador de evento de hora.
OneShot	Obtiene si el desencadenador de evento de hora se usará solo una vez o cada vez que transcurre el intervalo FreshnessTime .