TimeTrigger 클래스

정의

네임스페이스:

Windows.ApplicationModel.Background

실행할 백그라운드 작업을 트리거하는 시간 이벤트를 나타냅니다.

public ref class TimeTrigger sealed

/// [Windows.Foundation.Metadata.Activatable(Windows.ApplicationModel.Background.ITimeTriggerFactory, 65536, Windows.Foundation.UniversalApiContract)]
/// [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)]
class TimeTrigger final

/// [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.Activatable(typeof(Windows.ApplicationModel.Background.ITimeTriggerFactory), 65536, typeof(Windows.Foundation.UniversalApiContract))]
[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)]
public sealed class TimeTrigger

[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

상속

Object IInspectable TimeTrigger

특성

ActivatableAttribute ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

구현

IBackgroundTrigger

Windows 요구 사항

디바이스 패밀리	Windows 10 (10.0.10240.0에서 도입되었습니다.)
API contract	Windows.Foundation.UniversalApiContract (v1.0에서 도입되었습니다.)

예제

다음 예제에서는 시간 트리거를 만들고 등록하는 방법을 보여줍니다.

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

설명

등록에 성공하려면 먼저 매니페스트에서 백그라운드 작업을 선언해야 합니다. Windows 10에서 백그라운드 작업을 사용하기 위해 잠금 화면에 앱을 추가할 필요는 없지만 BackgroundExecutionManager.RequestAccessAsync를 호출하여 백그라운드 액세스를 요청해야 합니다.

디바이스가 배터리 절약 모드인 경우 TimeTrigger가 작동하지 않습니다. 사용자가 디바이스가 배터리 절약 모드에 있을 때 앱이 백그라운드 작업을 수행하도록 하려면 앱이 백그라운드 설정 패널에서 실행되도록 설정에서 해당 앱에 대해 예외를 만들 수 있습니다.

참고

이 클래스는 민첩하지 않으므로 스레딩 모델 및 마샬링 동작을 고려해야 합니다. 자세한 내용은 스레딩 및 마샬링(C++/CX) 및 다중 스레드 환경(.NET)에서 Windows 런타임 개체 사용(.NET)을 참조하세요.

생성자

TimeTrigger(UInt32, Boolean)

시간 이벤트 트리거의 새 인스턴스를 초기화합니다.

속성

FreshnessTime	시간 이벤트 트리거의 간격을 가져옵니다.
OneShot	시간 이벤트 트리거를 한 번만 사용할지 아니면 간격이 경과할 때마다 FreshnessTime 사용할지 여부를 가져옵니다.