Timer Класс

[System.Runtime.InteropServices.ComVisible(true)]
public sealed class Timer : IDisposable

public sealed class Timer : MarshalByRefObject, IAsyncDisposable, IDisposable

public sealed class Timer : MarshalByRefObject, System.Threading.ITimer

public sealed class Timer : MarshalByRefObject, IDisposable

[System.Runtime.InteropServices.ComVisible(true)]
public sealed class Timer : MarshalByRefObject, IDisposable

Наследование

Object

Timer

Наследование

Object

MarshalByRefObject

Timer

Атрибуты

ComVisibleAttribute

Реализации

IDisposable IAsyncDisposable ITimer

В следующем примере определяется класс StatusChecker, включающий метод CheckStatus, подпись которого совпадает с TimerCallback делегатом. Аргумент state метода CheckStatus — это объект AutoResetEvent, используемый для синхронизации потока приложения и потока пула потоков, выполняющего делегат обратного вызова. Класс StatusChecker также включает две переменные состояния:

invokeCount Указывает количество вызовов метода обратного вызова.

maxCount Определяет максимальное количество вызовов метода обратного вызова.

Поток приложения создает таймер, который ожидает одну секунду, а затем выполняет метод обратного вызова CheckStatus каждые 250 миллисекунд. Затем поток приложения блокируется до тех пор, пока объект AutoResetEvent не будет сигнален. Когда метод обратного вызова CheckStatus выполняется maxCount раз, он вызывает метод AutoResetEvent.Set, чтобы задать состояние объекта AutoResetEvent сигнализировать. При первом выполнении этого потока приложения вызывается метод Change(Int32, Int32), чтобы метод обратного вызова выполнялся каждые половину секунды. Он снова блокируется до тех пор, пока объект AutoResetEvent не будет сигнален. Когда это произойдет, таймер уничтожается путем вызова метода Dispose, а приложение завершает работу.

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.

Используйте делегат TimerCallback, чтобы указать метод, который требуется выполнить Timer. Подпись делегата TimerCallback:

void TimerCallback(Object state)

Делегат таймера указывается при создании таймера и не может быть изменен. Метод не выполняется в потоке, который создал таймер; он выполняется в потоке ThreadPool, предоставленном системой.

При создании таймера можно указать время ожидания до первого выполнения метода (время ожидания), а также время ожидания между последующими выполнениями (период). Класс Timer имеет то же разрешение, что и системные часы. Это означает, что если период меньше разрешения системных часов, то делегат TimerCallback будет выполняться через интервалы, определенные разрешением системных часов, что составляет около 15 миллисекунд в системах Windows 7 и Windows 8. Вы можете изменить время и период или отключить таймер с помощью метода Change.

Если таймер больше не нужен, используйте метод Dispose для освобождения ресурсов, удерживаемых таймером. Обратите внимание, что обратные вызовы могут возникать после вызова перегрузки метода Dispose(), так как обратные вызовы таймера для выполнения потоками пула потоков. Для ожидания завершения всех обратных вызовов можно использовать перегрузку метода Dispose(WaitHandle).

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

Этот тип является потокобезопасной.

• TimerCallback
• таймеров
• пул управляемых потоков