TimeProvider.CreateTimer(TimerCallback, Object, TimeSpan, TimeSpan) Metod

Definition

Skapar en ny ITimer instans med värden TimeSpan för att mäta tidsintervall.

public:
 virtual System::Threading::ITimer ^ CreateTimer(System::Threading::TimerCallback ^ callback, System::Object ^ state, TimeSpan dueTime, TimeSpan period);
public virtual System.Threading.ITimer CreateTimer(System.Threading.TimerCallback callback, object? state, TimeSpan dueTime, TimeSpan period);
abstract member CreateTimer : System.Threading.TimerCallback * obj * TimeSpan * TimeSpan -> System.Threading.ITimer
override this.CreateTimer : System.Threading.TimerCallback * obj * TimeSpan * TimeSpan -> System.Threading.ITimer
Public Overridable Function CreateTimer (callback As TimerCallback, state As Object, dueTime As TimeSpan, period As TimeSpan) As ITimer

Parametrar

callback
TimerCallback

Ett ombud som representerar en metod som ska köras när timern utlöses. Metoden som anges för återanrop ska vara reentrant, eftersom den kan anropas samtidigt i två trådar om timern utlöses igen före eller medan ett tidigare återanrop fortfarande hanteras.

state
Object

Ett objekt som ska skickas till callback. Detta kan vara null.

dueTime
TimeSpan

Hur lång tid det går att fördröja innan callback anropas. Ange InfiniteTimeSpan för att förhindra att timern startar. Ange Zero att timern ska startas omedelbart.

period
TimeSpan

Tidsintervallet mellan anrop av callback. Ange InfiniteTimeSpan för att inaktivera periodisk signalering.

Returer

Den nyligen skapade ITimer instansen.

Undantag

callback är null.

Antalet millisekunder i värdet dueTime för eller period är negativt och inte lika med Infinite, eller är större än MaxValue.

Kommentarer

Ombudet som anges av motringningsparametern anropas en gång efter dueTime förflutit och därefter varje gång period tidsintervallet förflutit.

Om dueTime är noll anropas återanropet omedelbart. Om dueTime är -1 millisekunder anropas callback inte; timern är inaktiverad, men kan återaktiveras genom att anropa Change(TimeSpan, TimeSpan) metoden.

Om period är 0 eller -1 millisekunder och dueTime är positiv callback anropas en gång. Timerns periodiska beteende är inaktiverat, men kan återaktiveras med hjälp av Change(TimeSpan, TimeSpan) metoden.

Returinstansen ITimer rotas implicit medan timern fortfarande är schemalagd.

CreateTimer(TimerCallback, Object, TimeSpan, TimeSpan) ExecutionContext samlar in och lagrar det med ITimer för användning vid anrop callback varje gång det anropas. Avbildningen kan ignoreras med SuppressFlow().

Gäller för