Прочитать на английском

Поделиться через


Timer Конструкторы

Определение

Инициализирует новый экземпляр класса Timer.

Перегрузки

Timer(TimerCallback)

Инициализирует новый экземпляр класса Timer с бесконечным периодом и бесконечным временем действия, используя созданный объект Timer в качестве объекта состояния.

Timer(TimerCallback, Object, Int32, Int32)

Инициализирует новый экземпляр класса Timer, используя указанное 32-разрядное знаковое целое число для задания временного интервала.

Timer(TimerCallback, Object, Int64, Int64)

Инициализирует новый экземпляр класса Timer, используя указанное 64-разрядное знаковое целое число для измерения временных интервалов.

Timer(TimerCallback, Object, TimeSpan, TimeSpan)

Инициализирует новый экземпляр класса Timer, используя значения объекта TimeSpan для измерения временных интервалов.

Timer(TimerCallback, Object, UInt32, UInt32)

Инициализирует новый экземпляр класса Timer, используя указанное 32-разрядное незнаковое целое число для измерения временных интервалов.

Timer(TimerCallback)

Исходный код:
Timer.cs
Исходный код:
Timer.cs
Исходный код:
Timer.cs

Инициализирует новый экземпляр класса Timer с бесконечным периодом и бесконечным временем действия, используя созданный объект Timer в качестве объекта состояния.

C#
public Timer (System.Threading.TimerCallback callback);

Параметры

callback
TimerCallback

Делегат TimerCallback, представляющий выполняемый метод.

Примеры

В следующем примере кода создается новый таймер, использующий сам таймер в качестве объекта состояния. Метод Change используется для запуска таймера. При обратном вызове таймера объект состояния используется для отключения таймера.

C#
using System;
using System.Threading;

public class Example
{
    public static void Main()
    {
        // Create an instance of the Example class, and start two
        // timers.
        Example ex = new Example();
        ex.StartTimer(2000);
        ex.StartTimer(1000);

        Console.WriteLine("Press Enter to end the program.");
        Console.ReadLine();
    }

    public void StartTimer(int dueTime)
    {
        Timer t = new Timer(new TimerCallback(TimerProc));
        t.Change(dueTime, 0);
    }

    private void TimerProc(object state)
    {
        // The state object is the Timer object.
        Timer t = (Timer) state;
        t.Dispose();
        Console.WriteLine("The timer callback executes.");
    }
}

Комментарии

Вызовите этот конструктор, если требуется использовать сам объект в Timer качестве объекта состояния. После создания таймера используйте Change метод , чтобы задать интервал и время выполнения.

Этот конструктор задает бесконечное время выполнения перед первым обратным вызовом и бесконечный интервал между обратными вызовами, чтобы предотвратить выполнение первого обратного вызова до Timer назначения объекта состоянию.

Метод, указанный для , callback должен быть повторным, так как он вызывается в ThreadPool потоках. Метод может выполняться одновременно в двух потоках пула потоков, если интервал таймера меньше времени, необходимого для выполнения метода, или если используются все потоки пула потоков и метод помещается в очередь несколько раз.

Применяется к

.NET 9 и другие версии
Продукт Версии
.NET Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 2.0, 2.1

Timer(TimerCallback, Object, Int32, Int32)

Исходный код:
Timer.cs
Исходный код:
Timer.cs
Исходный код:
Timer.cs

Инициализирует новый экземпляр класса Timer, используя указанное 32-разрядное знаковое целое число для задания временного интервала.

C#
public Timer (System.Threading.TimerCallback callback, object state, int dueTime, int period);
C#
public Timer (System.Threading.TimerCallback callback, object? state, int dueTime, int period);

Параметры

callback
TimerCallback

Делегат TimerCallback, представляющий выполняемый метод.

state
Object

Объект, содержащий информацию, используемую методом ответного вызова или значение null.

dueTime
Int32

Количество времени до начала использования параметра callback, в миллисекундах. Следует задать поле Infinite для того, чтобы не допустить запуск таймера. Задайте значение ноль (0) для немедленного запуска таймера.

period
Int32

Временной интервал между вызовами параметра callback, в миллисекундах. Следует задать поле Infinite для отключения периодической сигнализации.

Исключения

Значение параметра dueTime или period отрицательно, и не равно Infinite.

Параметр callback имеет значение null.

Примеры

В следующем примере кода показано, как создать TimerCallback делегат и инициализировать Timer новый экземпляр класса .

C#
using System;
using System.Threading;

class TimerExample
{
    static void Main()
    {
        // Create an AutoResetEvent to signal the timeout threshold in the
        // timer callback has been reached.
        var autoEvent = new AutoResetEvent(false);
        
        var statusChecker = new StatusChecker(10);

        // Create a timer that invokes CheckStatus after one second, 
        // and every 1/4 second thereafter.
        Console.WriteLine("{0:h:mm:ss.fff} Creating timer.\n", 
                          DateTime.Now);
        var stateTimer = new Timer(statusChecker.CheckStatus, 
                                   autoEvent, 1000, 250);

        // When autoEvent signals, change the period to every half second.
        autoEvent.WaitOne();
        stateTimer.Change(0, 500);
        Console.WriteLine("\nChanging period to .5 seconds.\n");

        // When autoEvent signals the second time, dispose of the timer.
        autoEvent.WaitOne();
        stateTimer.Dispose();
        Console.WriteLine("\nDestroying timer.");
    }
}

class StatusChecker
{
    private int invokeCount;
    private int  maxCount;

    public StatusChecker(int count)
    {
        invokeCount  = 0;
        maxCount = count;
    }

    // This method is called by the timer delegate.
    public void CheckStatus(Object stateInfo)
    {
        AutoResetEvent autoEvent = (AutoResetEvent)stateInfo;
        Console.WriteLine("{0} Checking status {1,2}.", 
            DateTime.Now.ToString("h:mm:ss.fff"), 
            (++invokeCount).ToString());

        if(invokeCount == maxCount)
        {
            // Reset the counter and signal the waiting thread.
            invokeCount = 0;
            autoEvent.Set();
        }
    }
}
// The example displays output like the following:
//       11:59:54.202 Creating timer.
//       
//       11:59:55.217 Checking status  1.
//       11:59:55.466 Checking status  2.
//       11:59:55.716 Checking status  3.
//       11:59:55.968 Checking status  4.
//       11:59:56.218 Checking status  5.
//       11:59:56.470 Checking status  6.
//       11:59:56.722 Checking status  7.
//       11:59:56.972 Checking status  8.
//       11:59:57.223 Checking status  9.
//       11:59:57.473 Checking status 10.
//       
//       Changing period to .5 seconds.
//       
//       11:59:57.474 Checking status  1.
//       11:59:57.976 Checking status  2.
//       11:59:58.476 Checking status  3.
//       11:59:58.977 Checking status  4.
//       11:59:59.477 Checking status  5.
//       11:59:59.977 Checking status  6.
//       12:00:00.478 Checking status  7.
//       12:00:00.980 Checking status  8.
//       12:00:01.481 Checking status  9.
//       12:00:01.981 Checking status 10.
//       
//       Destroying timer.

Комментарии

Делегат, указанный параметром callback , вызывается один раз после dueTime истечения времени, а затем каждый раз, когда period истекает интервал времени.

Если dueTime равно нулю (0), callback вызывается немедленно. Если dueTime имеет значение Timeout.Infinite, callback не вызывается; таймер отключен, но его можно включить повторно, вызвав Change метод .

Timer Так как класс имеет то же разрешение, что и системные часы, которое составляет примерно 15 миллисекунд в системах Windows 7 и Windows 8, делегат выполняется с интервалами, callback определенными разрешением системных часов, если period меньше разрешения системных часов. Если period значение равно нулю (0) или dueTimeTimeout.Infinite не Timeout.Infiniteравно , callback вызывается один раз; периодическое поведение таймера отключено, но его можно повторно включить с помощью Change метода .

Примечание

Системные часы, которые используются, являются теми же, что и GetTickCount, на которые не влияют изменения, внесенные в timeBeginPeriod и timeEndPeriod.

Метод, указанный для , callback должен быть повторным, так как он вызывается в ThreadPool потоках. Метод может выполняться одновременно в двух потоках пула потоков, если интервал таймера меньше времени, необходимого для выполнения метода, или если используются все потоки пула потоков и метод помещается в очередь несколько раз.

См. также раздел

Применяется к

.NET 9 и другие версии
Продукт Версии
.NET Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 1.2, 1.3, 1.4, 1.6, 2.0, 2.1
UWP 10.0

Timer(TimerCallback, Object, Int64, Int64)

Исходный код:
Timer.cs
Исходный код:
Timer.cs
Исходный код:
Timer.cs

Инициализирует новый экземпляр класса Timer, используя указанное 64-разрядное знаковое целое число для измерения временных интервалов.

C#
public Timer (System.Threading.TimerCallback callback, object? state, long dueTime, long period);
C#
public Timer (System.Threading.TimerCallback callback, object state, long dueTime, long period);

Параметры

callback
TimerCallback

Делегат TimerCallback, представляющий выполняемый метод.

state
Object

Объект, содержащий информацию, используемую методом ответного вызова или значение null.

dueTime
Int64

Количество времени до начала использования параметра callback, в миллисекундах. Следует задать поле Infinite для того, чтобы не допустить запуск таймера. Задайте значение ноль (0) для немедленного запуска таймера.

period
Int64

Временной интервал между вызовами параметра callback, в миллисекундах. Следует задать поле Infinite для отключения периодической сигнализации.

Исключения

Значение параметра dueTime или period отрицательно, и не равно Infinite.

Значение параметра dueTime или period больше 4294967294.

Комментарии

Делегат, указанный параметром callback , вызывается один раз после dueTime истечения времени, а затем каждый раз, когда period истекает интервал времени.

Если dueTime равно нулю (0), callback вызывается немедленно. Если dueTime имеет значение Timeout.Infinite, callback не вызывается; таймер отключен, но его можно включить повторно, вызвав Change метод .

Timer Так как класс имеет то же разрешение, что и системные часы, которое составляет примерно 15 миллисекунд в системах Windows 7 и Windows 8, делегат выполняется с интервалами, callback определенными разрешением системных часов, если period меньше разрешения системных часов. Если period значение равно нулю (0) или dueTimeTimeout.Infinite не Timeout.Infiniteравно , callback вызывается один раз; периодическое поведение таймера отключено, но его можно повторно включить с помощью Change метода .

Примечание

Системные часы, которые используются, являются теми же, что и GetTickCount, на которые не влияют изменения, внесенные в timeBeginPeriod и timeEndPeriod.

Метод, указанный для , callback должен быть повторным, так как он вызывается в ThreadPool потоках. Метод может выполняться одновременно в двух потоках пула потоков, если интервал таймера меньше времени, необходимого для выполнения метода, или если используются все потоки пула потоков и метод помещается в очередь несколько раз.

См. также раздел

Применяется к

.NET 9 и другие версии
Продукт Версии
.NET Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 2.0, 2.1

Timer(TimerCallback, Object, TimeSpan, TimeSpan)

Исходный код:
Timer.cs
Исходный код:
Timer.cs
Исходный код:
Timer.cs

Инициализирует новый экземпляр класса Timer, используя значения объекта TimeSpan для измерения временных интервалов.

C#
public Timer (System.Threading.TimerCallback callback, object state, TimeSpan dueTime, TimeSpan period);
C#
public Timer (System.Threading.TimerCallback callback, object? state, TimeSpan dueTime, TimeSpan period);

Параметры

callback
TimerCallback

Делегат, представляющий выполняемый метод.

state
Object

Объект, содержащий информацию, используемую методом ответного вызова или значение null.

dueTime
TimeSpan

Количество времени до начала использования параметра callback. Следует задать поле InfiniteTimeSpan для того, чтобы не допустить запуск таймера. Задайте значение Zero для немедленного запуска таймера.

period
TimeSpan

Временной интервал между вызовами параметра callback. Следует задать поле InfiniteTimeSpan для отключения периодической сигнализации.

Исключения

Число миллисекунд в значении dueTime или period является отрицательным и не равно Infinite, или больше Int32.MaxValue.

Параметр callback имеет значение null.

Примеры

В следующем примере кода показано, как создать TimerCallback делегат и инициализировать Timer новый экземпляр класса .

C#
using System;
using System.Threading;

class TimerExample
{
    static void Main()
    {
        AutoResetEvent autoEvent     = new AutoResetEvent(false);
        StatusChecker  statusChecker = new StatusChecker(10);

        // Create the delegate that invokes methods for the timer.
        TimerCallback timerDelegate = 
            new TimerCallback(statusChecker.CheckStatus);

        TimeSpan delayTime = new TimeSpan(0, 0, 1);
        TimeSpan intervalTime = new TimeSpan(0, 0, 0, 0, 250);

        // Create a timer that signals the delegate to invoke 
        // CheckStatus after one second, and every 1/4 second 
        // thereafter.
        Console.WriteLine("{0} Creating timer.\n", 
            DateTime.Now.ToString("h:mm:ss.fff"));
        Timer stateTimer = new Timer(
            timerDelegate, autoEvent, delayTime, intervalTime);

        // When autoEvent signals, change the period to every 
        // 1/2 second.
        autoEvent.WaitOne(5000, false);
        stateTimer.Change(new TimeSpan(0), 
            intervalTime + intervalTime);
        Console.WriteLine("\nChanging period.\n");

        // When autoEvent signals the second time, dispose of 
        // the timer.
        autoEvent.WaitOne(5000, false);
        stateTimer.Dispose();
        Console.WriteLine("\nDestroying timer.");
    }
}

class StatusChecker
{
    int invokeCount, maxCount;

    public StatusChecker(int count)
    {
        invokeCount  = 0;
        maxCount = count;
    }

    // This method is called by the timer delegate.
    public void CheckStatus(Object stateInfo)
    {
        AutoResetEvent autoEvent = (AutoResetEvent)stateInfo;
        Console.WriteLine("{0} Checking status {1,2}.", 
            DateTime.Now.ToString("h:mm:ss.fff"), 
            (++invokeCount).ToString());

        if(invokeCount == maxCount)
        {
            // Reset the counter and signal Main.
            invokeCount  = 0;
            autoEvent.Set();
        }
    }
}

Комментарии

Делегат, указанный параметром callback , вызывается один раз после dueTime истечения времени, а затем каждый раз, когда period истекает интервал времени.

Если dueTime равно нулю (0), callback вызывается немедленно. Если dueTime значение равно отрицательному значению 1 (–1) миллисекундаChange, callback метод не вызывается; таймер отключен, но его можно включить повторно, вызвав метод .

Timer Так как класс имеет то же разрешение, что и системные часы, которое составляет примерно 15 миллисекунд в системах Windows 7 и Windows 8, делегат выполняется с интервалами, callback определенными разрешением системных часов, если period меньше разрешения системных часов. Если period равно нулю (0) или отрицательному значению (-1) миллисекунд и dueTime является положительным, callback вызывается один раз; периодическое поведение таймера отключено, но его можно включить повторно с помощью Change метода .

Примечание

Системные часы, которые используются, являются теми же, что и GetTickCount, на которые не влияют изменения, внесенные в timeBeginPeriod и timeEndPeriod.

Метод, указанный для , callback должен быть повторным, так как он вызывается в ThreadPool потоках. Метод может выполняться одновременно в двух потоках пула потоков, если интервал таймера меньше времени, необходимого для выполнения метода, или если используются все потоки пула потоков и метод помещается в очередь несколько раз.

См. также раздел

Применяется к

.NET 9 и другие версии
Продукт Версии
.NET Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 1.2, 1.3, 1.4, 1.6, 2.0, 2.1
UWP 10.0

Timer(TimerCallback, Object, UInt32, UInt32)

Исходный код:
Timer.cs
Исходный код:
Timer.cs
Исходный код:
Timer.cs

Важно!

Этот API несовместим с CLS.

Инициализирует новый экземпляр класса Timer, используя указанное 32-разрядное незнаковое целое число для измерения временных интервалов.

C#
[System.CLSCompliant(false)]
public Timer (System.Threading.TimerCallback callback, object? state, uint dueTime, uint period);
C#
[System.CLSCompliant(false)]
public Timer (System.Threading.TimerCallback callback, object state, uint dueTime, uint period);

Параметры

callback
TimerCallback

Делегат, представляющий выполняемый метод.

state
Object

Объект, содержащий информацию, используемую методом ответного вызова или значение null.

dueTime
UInt32

Количество времени до начала использования параметра callback, в миллисекундах. Следует задать поле Infinite для того, чтобы не допустить запуск таймера. Задайте значение ноль (0) для немедленного запуска таймера.

period
UInt32

Временной интервал между вызовами параметра callback, в миллисекундах. Следует задать поле Infinite для отключения периодической сигнализации.

Атрибуты

Исключения

Значение параметра dueTime или period отрицательно, и не равно Infinite.

Параметр callback имеет значение null.

Комментарии

Делегат, указанный параметром callback , вызывается один раз после dueTime истечения времени, а затем каждый раз, когда period истекает интервал времени.

Если dueTime равно нулю (0), callback вызывается немедленно. Если dueTime имеет значение Timeout.Infinite, callback не вызывается; таймер отключен, но его можно включить повторно, вызвав Change метод .

Timer Так как класс имеет то же разрешение, что и системные часы, которое составляет примерно 15 миллисекунд в системах Windows 7 и Windows 8, делегат выполняется с интервалами, callback определенными разрешением системных часов, если period меньше разрешения системных часов. Если period значение равно нулю (0) или dueTimeTimeout.Infinite не Timeout.Infiniteравно , callback вызывается один раз; периодическое поведение таймера отключается, но его можно включить повторно с помощью Change метода .

Примечание

Системные часы, которые используются, — это те же часы, которые используются Командлетом GetTickCount, на которые не влияют изменения, внесенные с помощью timeBeginPeriod и timeEndPeriod.

Метод, указанный для , callback должен быть повторным, так как он вызывается в ThreadPool потоках. Метод может выполняться одновременно в двух потоках пула потоков, если интервал таймера меньше времени, необходимого для выполнения метода, или если используются все потоки пула потоков и метод помещается в очередь несколько раз.

См. также раздел

Применяется к

.NET 9 и другие версии
Продукт Версии
.NET Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 2.0, 2.1