TimeTrigger Classe

Definizione

Spazio dei nomi:

Windows.ApplicationModel.Background

Rappresenta un evento temporale che attiva l'esecuzione di un'attività in 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

Ereditarietà

Object Platform::Object IInspectable TimeTrigger

Attributi

ActivatableAttribute ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Implementazioni

IBackgroundTrigger

Requisiti Windows

Famiglia di dispositivi	Windows 10 (è stato introdotto in 10.0.10240.0)
API contract	Windows.Foundation.UniversalApiContract (è stato introdotto in v1.0)

Esempio

Nell'esempio seguente viene illustrato come creare e registrare un trigger temporale.

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

Commenti

L'attività in background deve essere dichiarata nel manifesto prima che la registrazione possa essere completata correttamente. Non è necessario aggiungere l'app alla schermata di blocco per usare le attività in background in Windows 10, ma è comunque necessario chiamare BackgroundExecutionManager.RequestAccessAsync per richiedere l'accesso in background.

TimeTriggers non funziona quando il dispositivo è in modalità risparmio batteria. Se l'utente vuole che l'app possa eseguire attività in background quando il dispositivo è in modalità risparmio batteria, può fare un'eccezione per tale app nel pannello Consenti l'esecuzione delle app nel pannello delle impostazioni in background.

Nota

Questa classe non è agile, il che significa che è necessario considerare il modello di threading e il comportamento di marshalling. Per altre informazioni, vedere Threading e marshalling (C++/CX) e Uso di oggetti Windows Runtime in un ambiente multithreading (.NET).

Costruttori

TimeTrigger(UInt32, Boolean)

Inizializza una nuova istanza di un trigger di evento temporale.

Proprietà

FreshnessTime	Ottiene l'intervallo di un trigger di evento temporale.
OneShot	Ottiene un valore che indica se il trigger dell'evento temporale verrà utilizzato una sola volta o ogni volta che è trascorso l'intervallo FreshnessTime .