GrainBaseExtensions.RegisterGrainTimer 方法
定義
重要
部分資訊涉及發行前產品，在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊，不做任何明確或隱含的瑕疵擔保。
多載
RegisterGrainTimer(IGrainBase, Func<CancellationToken,Task>, GrainTimerCreationOptions)
建立粒紋定時器。
public static Orleans.Runtime.IGrainTimer RegisterGrainTimer (this Orleans.IGrainBase grain, Func<System.Threading.CancellationToken,System.Threading.Tasks.Task> callback, Orleans.Runtime.GrainTimerCreationOptions options);static member RegisterGrainTimer : Orleans.IGrainBase * Func<System.Threading.CancellationToken, System.Threading.Tasks.Task> * Orleans.Runtime.GrainTimerCreationOptions -> Orleans.Runtime.IGrainTimer<Extension()>
Public Function RegisterGrainTimer (grain As IGrainBase, callback As Func(Of CancellationToken, Task), options As GrainTimerCreationOptions) As IGrainTimer參數
- grain
- IGrainBase
粒紋實例。
- callback
- Func<CancellationToken,Task>
定時器回呼，每當定時器到期時，就會叫用它。
- options
- GrainTimerCreationOptions
建立定時器的選項。
傳回
表示定時器的 IGrainTimer 實例。
備註
粒紋定時器預設不會讓粒紋保持作用中。 將 KeepAlive 設定為 true 會導致每個定時器刻度延長粒紋啟用的存留期。 如果定時器刻度不常發生，由於閑置，仍可停用粒紋。 停用粒紋時，會捨棄所有作用中的定時器。
在解析從回呼傳回的 Task 之前，將不會排程下一個定時器刻度。 也就是說，定時器回呼永遠不會與本身同時執行。 如果 Interleave 設定為 true，則會允許定時器回呼與其他粒紋方法呼叫和其他定時器交錯。 如果 Interleave 設定為 false，定時器回呼會遵守粒紋的重新進入設定，就像一般粒紋方法呼叫一樣。
呼叫 IGrainTimer的 Dispose() 方法，隨時可以停止定時器。 處置定時器可防止排程任何進一步的定時器刻度。
定時器到期時間和期間可以藉由呼叫其 Change(TimeSpan, TimeSpan) 方法來更新。 每次更新定時器時，都會根據更新的到期時間排程下一個定時器刻度。 後續的刻度會在更新的期間經過之後排程。 請注意，此行為與 Change(TimeSpan, TimeSpan) 方法相同。
系統會記錄從回呼擲回的例外狀況，但不會防止下一個定時器刻度排入佇列。
適用於
RegisterGrainTimer(IGrainBase, Func<Task>, GrainTimerCreationOptions)
public static Orleans.Runtime.IGrainTimer RegisterGrainTimer (this Orleans.IGrainBase grain, Func<System.Threading.Tasks.Task> callback, Orleans.Runtime.GrainTimerCreationOptions options);static member RegisterGrainTimer : Orleans.IGrainBase * Func<System.Threading.Tasks.Task> * Orleans.Runtime.GrainTimerCreationOptions -> Orleans.Runtime.IGrainTimer<Extension()>
Public Function RegisterGrainTimer (grain As IGrainBase, callback As Func(Of Task), options As GrainTimerCreationOptions) As IGrainTimer參數
- grain
- IGrainBase
- options
- GrainTimerCreationOptions
傳回
適用於
RegisterGrainTimer(IGrainBase, Func<CancellationToken,Task>, TimeSpan, TimeSpan)
建立粒紋定時器。
public static Orleans.Runtime.IGrainTimer RegisterGrainTimer (this Orleans.IGrainBase grain, Func<System.Threading.CancellationToken,System.Threading.Tasks.Task> callback, TimeSpan dueTime, TimeSpan period);static member RegisterGrainTimer : Orleans.IGrainBase * Func<System.Threading.CancellationToken, System.Threading.Tasks.Task> * TimeSpan * TimeSpan -> Orleans.Runtime.IGrainTimer<Extension()>
Public Function RegisterGrainTimer (grain As IGrainBase, callback As Func(Of CancellationToken, Task), dueTime As TimeSpan, period As TimeSpan) As IGrainTimer參數
- grain
- IGrainBase
粒紋實例。
- callback
- Func<CancellationToken,Task>
定時器回呼，每當定時器到期時，就會叫用它。
- dueTime
- TimeSpan
TimeSpan，表示在建構 IGrainTimer 時叫用回呼方法之前所要延遲的時間量。 指定 InfiniteTimeSpan 以防止定時器啟動。 指定 Zero 立即啟動定時器。
- period
- TimeSpan
建構 IGrainTimer 時所指定的回呼方法調用之間的時間間隔。 指定 InfiniteTimeSpan 以停用定期訊號。
傳回
表示定時器的 IGrainTimer 實例。
適用於
RegisterGrainTimer(IGrainBase, Func<Task>, TimeSpan, TimeSpan)
建立粒紋定時器。
public static Orleans.Runtime.IGrainTimer RegisterGrainTimer (this Orleans.IGrainBase grain, Func<System.Threading.Tasks.Task> callback, TimeSpan dueTime, TimeSpan period);static member RegisterGrainTimer : Orleans.IGrainBase * Func<System.Threading.Tasks.Task> * TimeSpan * TimeSpan -> Orleans.Runtime.IGrainTimer<Extension()>
Public Function RegisterGrainTimer (grain As IGrainBase, callback As Func(Of Task), dueTime As TimeSpan, period As TimeSpan) As IGrainTimer參數
- grain
- IGrainBase
粒紋實例。
- dueTime
- TimeSpan
TimeSpan，表示在建構 IGrainTimer 時叫用回呼方法之前所要延遲的時間量。 指定 InfiniteTimeSpan 以防止定時器啟動。 指定 Zero 立即啟動定時器。
- period
- TimeSpan
建構 IGrainTimer 時所指定的回呼方法調用之間的時間間隔。 指定 InfiniteTimeSpan 以停用定期訊號。
傳回
表示定時器的 IGrainTimer 實例。
備註
粒紋定時器預設不會讓粒紋保持作用中。 將 KeepAlive 設定為 true 會導致每個定時器刻度延長粒紋啟用的存留期。 如果定時器刻度不常發生，由於閑置，仍可停用粒紋。 停用粒紋時，會捨棄所有作用中的定時器。
在解析從回呼傳回的 Task 之前，將不會排程下一個定時器刻度。 也就是說，定時器回呼永遠不會與本身同時執行。 如果 Interleave 設定為 true，則會允許定時器回呼與其他粒紋方法呼叫和其他定時器交錯。 如果 Interleave 設定為 false，定時器回呼會遵守粒紋的重新進入設定，就像一般粒紋方法呼叫一樣。
呼叫 IGrainTimer的 Dispose() 方法，隨時可以停止定時器。 處置定時器可防止排程任何進一步的定時器刻度。
定時器到期時間和期間可以藉由呼叫其 Change(TimeSpan, TimeSpan) 方法來更新。 每次更新定時器時，都會根據更新的到期時間排程下一個定時器刻度。 後續的刻度會在更新的期間經過之後排程。 請注意，此行為與 Change(TimeSpan, TimeSpan) 方法相同。
系統會記錄從回呼擲回的例外狀況，但不會防止下一個定時器刻度排入佇列。
適用於
RegisterGrainTimer<TState>(IGrainBase, Func<TState,CancellationToken,Task>, TState, GrainTimerCreationOptions)
建立粒紋定時器。
public static Orleans.Runtime.IGrainTimer RegisterGrainTimer<TState> (this Orleans.IGrainBase grain, Func<TState,System.Threading.CancellationToken,System.Threading.Tasks.Task> callback, TState state, Orleans.Runtime.GrainTimerCreationOptions options);static member RegisterGrainTimer : Orleans.IGrainBase * Func<'State, System.Threading.CancellationToken, System.Threading.Tasks.Task> * 'State * Orleans.Runtime.GrainTimerCreationOptions -> Orleans.Runtime.IGrainTimer<Extension()>
Public Function RegisterGrainTimer(Of TState) (grain As IGrainBase, callback As Func(Of TState, CancellationToken, Task), state As TState, options As GrainTimerCreationOptions) As IGrainTimer類型參數
- TState
state 參數的類型。
參數
- grain
- IGrainBase
- callback
- Func<TState,CancellationToken,Task>
定時器回呼，每當定時器到期時，就會叫用它。
- state
- TState
傳遞至回呼的狀態。
- options
- GrainTimerCreationOptions
建立定時器的選項。
傳回
表示定時器的 IGrainTimer 實例。
備註
粒紋定時器預設不會讓粒紋保持作用中。 將 KeepAlive 設定為 true 會導致每個定時器刻度延長粒紋啟用的存留期。 如果定時器刻度不常發生，由於閑置，仍可停用粒紋。 停用粒紋時，會捨棄所有作用中的定時器。
在解析從回呼傳回的 Task 之前，將不會排程下一個定時器刻度。 也就是說，定時器回呼永遠不會與本身同時執行。 如果 Interleave 設定為 true，則會允許定時器回呼與其他粒紋方法呼叫和其他定時器交錯。 如果 Interleave 設定為 false，定時器回呼會遵守粒紋的重新進入設定，就像一般粒紋方法呼叫一樣。
呼叫 IGrainTimer的 Dispose() 方法，隨時可以停止定時器。 處置定時器可防止排程任何進一步的定時器刻度。
定時器到期時間和期間可以藉由呼叫其 Change(TimeSpan, TimeSpan) 方法來更新。 每次更新定時器時，都會根據更新的到期時間排程下一個定時器刻度。 後續的刻度會在更新的期間經過之後排程。 請注意，此行為與 Change(TimeSpan, TimeSpan) 方法相同。
系統會記錄從回呼擲回的例外狀況，但不會防止下一個定時器刻度排入佇列。
適用於
RegisterGrainTimer<TState>(IGrainBase, Func<TState,Task>, TState, GrainTimerCreationOptions)
public static Orleans.Runtime.IGrainTimer RegisterGrainTimer<TState> (this Orleans.IGrainBase grain, Func<TState,System.Threading.Tasks.Task> callback, TState state, Orleans.Runtime.GrainTimerCreationOptions options);static member RegisterGrainTimer : Orleans.IGrainBase * Func<'State, System.Threading.Tasks.Task> * 'State * Orleans.Runtime.GrainTimerCreationOptions -> Orleans.Runtime.IGrainTimer<Extension()>
Public Function RegisterGrainTimer(Of TState) (grain As IGrainBase, callback As Func(Of TState, Task), state As TState, options As GrainTimerCreationOptions) As IGrainTimer類型參數
- TState
state 參數的類型。
參數
- grain
- IGrainBase
- state
- TState
傳遞至回呼的狀態。
- options
- GrainTimerCreationOptions
傳回
適用於
RegisterGrainTimer<TState>(IGrainBase, Func<TState,CancellationToken,Task>, TState, TimeSpan, TimeSpan)
建立粒紋定時器。
public static Orleans.Runtime.IGrainTimer RegisterGrainTimer<TState> (this Orleans.IGrainBase grain, Func<TState,System.Threading.CancellationToken,System.Threading.Tasks.Task> callback, TState state, TimeSpan dueTime, TimeSpan period);static member RegisterGrainTimer : Orleans.IGrainBase * Func<'State, System.Threading.CancellationToken, System.Threading.Tasks.Task> * 'State * TimeSpan * TimeSpan -> Orleans.Runtime.IGrainTimer<Extension()>
Public Function RegisterGrainTimer(Of TState) (grain As IGrainBase, callback As Func(Of TState, CancellationToken, Task), state As TState, dueTime As TimeSpan, period As TimeSpan) As IGrainTimer類型參數
- TState
state 參數的類型。
參數
- grain
- IGrainBase
粒紋實例。
- callback
- Func<TState,CancellationToken,Task>
定時器回呼，每當定時器到期時，就會叫用它。
- state
- TState
傳遞至回呼的狀態。
- dueTime
- TimeSpan
TimeSpan，表示在建構 IGrainTimer 時叫用回呼方法之前所要延遲的時間量。 指定 InfiniteTimeSpan 以防止定時器啟動。 指定 Zero 立即啟動定時器。
- period
- TimeSpan
建構 IGrainTimer 時所指定的回呼方法調用之間的時間間隔。 指定 InfiniteTimeSpan 以停用定期訊號。
傳回
表示定時器的 IGrainTimer 實例。
適用於
RegisterGrainTimer<TState>(IGrainBase, Func<TState,Task>, TState, TimeSpan, TimeSpan)
建立粒紋定時器。
public static Orleans.Runtime.IGrainTimer RegisterGrainTimer<TState> (this Orleans.IGrainBase grain, Func<TState,System.Threading.Tasks.Task> callback, TState state, TimeSpan dueTime, TimeSpan period);static member RegisterGrainTimer : Orleans.IGrainBase * Func<'State, System.Threading.Tasks.Task> * 'State * TimeSpan * TimeSpan -> Orleans.Runtime.IGrainTimer<Extension()>
Public Function RegisterGrainTimer(Of TState) (grain As IGrainBase, callback As Func(Of TState, Task), state As TState, dueTime As TimeSpan, period As TimeSpan) As IGrainTimer類型參數
- TState
state 參數的類型。
參數
- grain
- IGrainBase
粒紋實例。
- state
- TState
傳遞至回呼的狀態。
- dueTime
- TimeSpan
TimeSpan，表示在建構 IGrainTimer 時叫用回呼方法之前所要延遲的時間量。 指定 InfiniteTimeSpan 以防止定時器啟動。 指定 Zero 立即啟動定時器。
- period
- TimeSpan
建構 IGrainTimer 時所指定的回呼方法調用之間的時間間隔。 指定 InfiniteTimeSpan 以停用定期訊號。
傳回
表示定時器的 IGrainTimer 實例。