ThreadPoolTimer 클래스

정의

네임스페이스:

Windows.System.Threading

CreateTimer 또는 CreatePeriodicTimer로 만든 타이머를 나타냅니다.

참고

ThreadPool API는 데스크톱 및 UWP 앱에 대해 지원됩니다.

public ref class ThreadPoolTimer sealed

/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
class ThreadPoolTimer final

[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
public sealed class ThreadPoolTimer

Public NotInheritable Class ThreadPoolTimer

상속

Object Platform::Object IInspectable ThreadPoolTimer

특성

ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Windows 요구 사항

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

예제

다음 코드에서는 TimerElapsedHandler 대리자 메서드를 전달하여 주기적인 타이머를 만드는 방법을 보여 있습니다.

int period = 1000;

ThreadPoolTimer PeriodicTimer =
    ThreadPoolTimer.CreatePeriodicTimer(ExampleTimerElapsedHandler,
                                        TimeSpan.FromMilliseconds(period));

타이머를 사용하여 앱을 완료하면 앱이 취소되어야 합니다. 다음 코드는 이전 예제에서 만든 주기적 타이머를 취소합니다.

if (PeriodicTimer != null)
{
    PeriodicTimer.Cancel();
}

설명

CreatePeriodicTimer 또는 CreateTimer 메서드를 사용하여 이 개체를 만들 수 있습니다.

참고

TimeSpan 값이 0이거나 값이 1밀리초 미만이면 주기적 타이머가 단일 샷 타이머로 작동합니다.

속성

Delay	CreateTimer를 사용하여 만든 단일 사용 타이머의 시간 제한 값을 가져옵니다.
Period	CreatePeriodicTimer로 만든 주기적 타이머의 시간 제한 값을 가져옵니다.

메서드

Cancel()	타이머를 취소합니다.
CreatePeriodicTimer(TimerElapsedHandler, TimeSpan)	주기적 타이머를 만듭니다.
CreatePeriodicTimer(TimerElapsedHandler, TimeSpan, TimerDestroyedHandler)	주기적 타이머를 만들고 주기적 타이머가 완료된 후 호출할 메서드를 지정합니다. 타이머가 다시 활성화되지 않고 만료되고 처리기에 대한 최종 호출이 완료되면 주기적 타이머가 완료됩니다.
CreateTimer(TimerElapsedHandler, TimeSpan)	일회용 타이머를 만듭니다.
CreateTimer(TimerElapsedHandler, TimeSpan, TimerDestroyedHandler)	일회용 타이머를 만들고 타이머가 완료된 후 호출할 메서드를 지정합니다. 타이머가 만료되고 처리기에 대한 최종 호출이 완료되면 타이머가 완료됩니다.