TimeTrigger Klasse

Definition

Namespace:

Windows.ApplicationModel.Background

Stellt ein Zeitereignis dar, das eine Hintergrundaufgabe auslöst, die ausgeführt werden soll.

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

Vererbung

Object Platform::Object IInspectable TimeTrigger

Attribute

ActivatableAttribute ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Implementiert

IBackgroundTrigger

Windows-Anforderungen

Gerätefamilie	Windows 10 (eingeführt in 10.0.10240.0)
API contract	Windows.Foundation.UniversalApiContract (eingeführt in v1.0)

Beispiele

Das folgende Beispiel zeigt, wie Sie einen Zeittrigger erstellen und registrieren.

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

Hinweise

Die Hintergrundaufgabe muss im Manifest deklariert werden, bevor die Registrierung erfolgreich sein kann. Sie müssen die App nicht zum Sperrbildschirm hinzufügen, um Hintergrundaufgaben in Windows 10 verwenden zu können, aber Sie müssen trotzdem BackgroundExecutionManager.RequestAccessAsync aufrufen, um Hintergrundzugriff anzufordern.

TimeTrigger funktionieren nicht, wenn sich das Gerät im Energiesparmodus befindet. Wenn der Benutzer möchte, dass die App Hintergrundaktivitäten ausführen kann, wenn sich das Gerät im Energiesparmodus befindet, kann er eine Ausnahme für diese App im Bereich Im Hintergrundeinstellungen ausführen lassen .

Hinweis

Diese Klasse ist nicht agil, was bedeutet, dass Sie das Threadingmodell und das Marshallverhalten berücksichtigen müssen. Weitere Informationen finden Sie unter Threading and Marshaling (C++/CX) und Using Windows-Runtime objects in a multithreaded environment (.NET).

Konstruktoren

TimeTrigger(UInt32, Boolean)

Initialisiert einen neuen instance eines Zeitereignistriggers.

Eigenschaften

FreshnessTime	Ruft das Intervall eines Zeitereignistriggers ab.
OneShot	Ruft ab, ob der Zeitereignistrigger nur einmal oder jedes Mal verwendet wird, wenn das FreshnessTime-Intervall verstrichen ist.