ThreadPoolTimer Класс

Определение

Пространство имен:

Windows.System.Threading

Представляет таймер, созданный с помощью CreateTimer или CreatePeriodicTimer.

Примечание

API ThreadPool поддерживается как для классических приложений, так и для приложений 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 , равное нулю (или любое значение менее 1 миллисекунды), приведет к тому, что периодический таймер будет работать как однократный таймер.

Свойства

Delay	Возвращает значение времени ожидания одноразового таймера, созданного с помощью CreateTimer.
Period	Возвращает значение времени ожидания периодического таймера, созданного с помощью CreatePeriodicTimer.

Методы

Cancel()	Отменяет таймер.
CreatePeriodicTimer(TimerElapsedHandler, TimeSpan)	Создает периодический таймер.
CreatePeriodicTimer(TimerElapsedHandler, TimeSpan, TimerDestroyedHandler)	Создает периодический таймер и задает метод для вызова после завершения периодического таймера. Периодический таймер завершается, когда срок действия таймера истек без повторной активации, а последний вызов обработчика завершен.
CreateTimer(TimerElapsedHandler, TimeSpan)	Создает одноразовый таймер.
CreateTimer(TimerElapsedHandler, TimeSpan, TimerDestroyedHandler)	Создает одноразовый таймер и задает метод для вызова после завершения таймера. Таймер завершается после истечения срока действия таймера и завершения последнего вызова обработчика .