ThreadPoolTimer Класс
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Представляет таймер, созданный с помощью 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
- Наследование
- Атрибуты
Требования к 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) |
Создает одноразовый таймер и задает метод для вызова после завершения таймера. Таймер завершается после истечения срока действия таймера и завершения последнего вызова обработчика . |