TimeTrigger Kelas

Definisi

Ruang nama:

Windows.ApplicationModel.Background

Mewakili peristiwa waktu yang memicu tugas latar belakang untuk dijalankan.

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

Warisan

Object Platform::Object IInspectable TimeTrigger

Atribut

ActivatableAttribute ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Penerapan

IBackgroundTrigger

Persyaratan Windows

Rangkaian perangkat	Windows 10 (diperkenalkan dalam 10.0.10240.0)
API contract	Windows.Foundation.UniversalApiContract (diperkenalkan dalam v1.0)

Contoh

Contoh berikut menunjukkan cara membuat dan mendaftarkan pemicu waktu.

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

Keterangan

Tugas latar belakang harus dideklarasikan dalam manifes sebelum pendaftaran berhasil. Anda tidak perlu menambahkan aplikasi ke layar kunci untuk menggunakan tugas latar belakang di Windows 10, tetapi Anda masih perlu memanggil BackgroundExecutionManager.RequestAccessAsync untuk meminta akses latar belakang.

TimeTriggers tidak berfungsi ketika perangkat berada dalam mode penghemat baterai. Jika pengguna ingin aplikasi dapat melakukan aktivitas latar belakang saat perangkat berada dalam mode penghemat baterai, mereka dapat membuat pengecualian untuk aplikasi tersebut di panel Pengaturan latar belakang biarkan aplikasi berjalan di latar belakang .

Catatan

Kelas ini tidak tangkas, yang berarti Anda perlu mempertimbangkan model utas dan perilaku marshalingnya. Untuk informasi selengkapnya, lihat Threading dan Marshaling (C++/CX) dan Menggunakan objek Windows Runtime di lingkungan multithreaded (.NET).

Konstruktor

TimeTrigger(UInt32, Boolean)

Menginisialisasi instans baru pemicu peristiwa waktu.

Properti

FreshnessTime	Mendapatkan interval pemicu peristiwa waktu.
OneShot	Mendapatkan apakah pemicu peristiwa waktu hanya akan digunakan sekali atau setiap kali interval FreshnessTime berlalu.