Article
11/18/2011

Timer Constructor (TimerCallback, Object, Int64, Int64)

Microsoft Silverlight will reach end of support after October 2021. Learn more.

Initializes a new instance of the Timer class, using 64-bit signed integers to measure time intervals.

Namespace: System.Threading
Assembly: mscorlib (in mscorlib.dll)

Syntax

'Declaration
<SecuritySafeCriticalAttribute> _
Public Sub New ( _
    callback As TimerCallback, _
    state As Object, _
    dueTime As Long, _
    period As Long _
)

[SecuritySafeCriticalAttribute]
public Timer(
    TimerCallback callback,
    Object state,
    long dueTime,
    long period
)

Parameters

callback
Type: System.Threading.TimerCallback
A delegate that represents a method to be executed.

state
Type: System.Object
An object that contains information to be used by the callback method, or nulla null reference (Nothing in Visual Basic).

dueTime
Type: System.Int64
The amount of time to delay before callback is invoked, in milliseconds. Specify Timeout.Infinite to prevent the timer from starting. Specify 0 (zero) to start the timer immediately.

period
Type: System.Int64
The time interval between invocations of callback, in milliseconds. Specify Timeout.Infinite to disable periodic signaling.

Exceptions

Exception	Condition
ArgumentOutOfRangeException	The dueTime or period parameter is negative and is not equal to Timeout.Infinite. -or- The dueTime or period parameter is greater than 4294967294 (UInt32.MaxValue - 1).
ArgumentNullException	The callback parameter is nulla null reference (Nothing in Visual Basic).

ArgumentOutOfRangeException

The dueTime or period parameter is negative and is not equal to Timeout.Infinite.

-or-

The dueTime or period parameter is greater than 4294967294 (UInt32.MaxValue - 1).

ArgumentNullException

The callback parameter is nulla null reference (Nothing in Visual Basic).

Remarks

The delegate specified by the callback parameter is invoked once after dueTime elapses, and thereafter each time the period time interval elapses.

Note:
Visual Basic users can omit the TimerCallback constructor, and simply use the AddressOf operator when specifying the callback method. Visual Basic automatically calls the correct delegate constructor.

If dueTime is 0 (zero), callback is invoked immediately. If dueTime is Timeout.Infinite, callback is not invoked; the timer is disabled but can be re-enabled by calling the Change method.

If period is 0 (zero) or Timeout.Infinite, and dueTime is not Timeout.Infinite, callback is invoked once; the periodic behavior of the timer is disabled but can be re-enabled using the Change method.

The method specified for callback should be reentrant, because it is called on ThreadPool threads. The method can be executed simultaneously on two thread pool threads if the timer interval is less than the time required to execute the method, or if all thread pool threads are in use and the method is queued multiple times.

Version Information

Silverlight

Supported in: 5, 4, 3

Silverlight for Windows Phone

Supported in: Windows Phone OS 7.1, Windows Phone OS 7.0

XNA Framework

Supported in: Xbox 360, Windows Phone OS 7.0

Platforms

For a list of the operating systems and browsers that are supported by Silverlight, see Supported Operating Systems and Browsers.

Partager via