TimeTrigger 클래스

정의

네임스페이스:

Windows.ApplicationModel.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

상속

Object Platform::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를 호출하여 백그라운드 액세스를 요청해야 합니다.

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

참고

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

생성자

TimeTrigger(UInt32, Boolean)

시간 이벤트 트리거의 새 instance 초기화합니다.

속성

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