Timer 類別
定義
重要
部分資訊涉及發行前產品，在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊，不做任何明確或隱含的瑕疵擔保。
一個讓執行緒能排程未來在背景執行緒執行任務的設施。
[Android.Runtime.Register("java/util/Timer", DoNotGenerateAcw=true)]
public class Timer : Java.Lang.Object[<Android.Runtime.Register("java/util/Timer", DoNotGenerateAcw=true)>]
type Timer = class
inherit Object- 繼承
- 屬性
備註
一個讓執行緒能排程未來在背景執行緒執行任務的設施。 任務可以排程一次性執行，或定期重複執行。
每個 Timer 物件對應的是一個背景執行緒，用來依序執行計時器的所有任務。 計時任務應該很快完成。 如果計時器任務完成時間過長，會「佔用」計時器的執行執行緒。 這反過來會延遲後續任務的執行，當問題任務最終完成時，任務可能會「聚集」並快速連續執行。
當最後一次對物件 Timer 的即時參考消失 ，且 所有未完成的任務執行後，計時器的任務執行執行緒會優雅地終止（並進入垃圾回收）。 然而，這過程可能花費任意漫長的時間。 預設情況下，任務執行執行緒不會以 守護程序執行緒形式執行，因此能防止應用程式終止。 若呼叫者想快速終止計時器的任務執行執行緒，呼叫者應呼叫計時器的方法 cancel 。
例如 stop ，如果計時器的任務執行緒因方法被呼叫而意外終止，任何進一步嘗試排程計時器任務的結果，都將像 IllegalStateException是被調用了計時器的方法 cancel 一樣。
此類別是執行緒安全的：多個執行緒可以共享單一 Timer 物件，無需外部同步。
此類別 不 提供即時保證：它會使用該 Object.wait(long) 方法排程任務。
Java 5.0 引入了這個java.util.concurrent套件，其中的一個並發工具是 ，java.util.concurrent.ScheduledThreadPoolExecutor ScheduledThreadPoolExecutor這是一個用於以特定速率或延遲重複執行任務的執行緒池。 它實際上是組合的更靈活替代品 Timer/TimerTask ，因為它允許多個服務執行緒，接受不同的時間單位，且不需要子 TimerTask 類別化（只要實作 Runnable即可）。 用一個執行緒配置 ScheduledThreadPoolExecutor 會等 Timer同於 。
實作說明：此課程可擴展至大量同時排程的任務（數千個應該不會有問題）。 內部則使用二元堆積來表示任務佇列，因此排程任務的成本為 O（log n），其中 n 是同時排程任務的數量。
實作說明：所有建構子都會啟動計時執行緒。
在 1.3 版本中加入。
本頁部分內容為基於 Open Source Project 所創建與分享的作品，並依授權條款所描述的使用進行修改。
建構函式
| 名稱 | Description |
|---|---|
| Timer() |
會產生一個新的計時器。 |
| Timer(Boolean) |
建立一個新的計時器，其關聯的執行緒可指定為 Thread#setDaemon 作為守護進程執行。 |
| Timer(IntPtr, JniHandleOwnership) |
建立 JNI 物件的 Managed 表示法時使用的建構函式;由運行時間呼叫。 |
| Timer(String, Boolean) |
建立一個新的計時器，其關聯執行緒名稱依指定，並可指定為 Thread#setDaemon 作為守護進程執行。 |
| Timer(String) |
建立一個新的計時器，其關聯執行緒名稱與指定相同。 |
屬性
| 名稱 | Description |
|---|---|
| Class |
回傳此 |
| Handle |
底層 Android 實例的帳號。 (繼承來源 Object) |
| JniIdentityHashCode |
取得由互通執行時指派給此 Java 對等端的身份雜湊碼。 (繼承來源 Object) |
| JniManagedPeerState |
一個讓執行緒能排程未來在背景執行緒執行任務的設施。 (繼承來源 JavaObject) |
| JniPeerMembers |
一個讓執行緒能排程未來在背景執行緒執行任務的設施。 |
| PeerReference |
取得這個 Java 節點的 JNI 物件參考。 (繼承來源 Object) |
| ThresholdClass |
此 API 支援 Mono for Android 基礎架構，並非直接從你的程式碼中使用。 |
| ThresholdType |
此 API 支援 Mono for Android 基礎架構，並非直接從你的程式碼中使用。 |
方法
| 名稱 | Description |
|---|---|
| Cancel() |
終止此計時器，丟棄所有已排程的任務。 |
| Clone() |
建立並回傳此物件的副本。 (繼承來源 Object) |
| Construct(JniObjectReference, JniObjectReferenceOptions) |
一個讓執行緒能排程未來在背景執行緒執行任務的設施。 (繼承來源 JavaObject) |
| Dispose() |
釋放該 Java 節點所持有的資源。 (繼承來源 Object) |
| Dispose(Boolean) |
釋放該 Java 節點所持有的資源。 (繼承來源 Object) |
| DisposeUnlessReferenced() |
一個讓執行緒能排程未來在背景執行緒執行任務的設施。 (繼承來源 JavaObject) |
| Equals(Object) |
一個讓執行緒能排程未來在背景執行緒執行任務的設施。 (繼承來源 JavaObject) |
| Equals(Object) |
表示是否有其他物體「等同」於此物。 (繼承來源 Object) |
| GetHashCode() |
回傳物件的雜湊碼值。 (繼承來源 Object) |
| JavaFinalize() |
已淘汰.
當垃圾回收判定該物件不再有相關參考時，由垃圾回收器呼叫。 (繼承來源 Object) |
| Notify() |
喚醒一個正在該物件監視器上等待的執行緒。 (繼承來源 Object) |
| NotifyAll() |
喚醒所有等待該物件監視器的執行緒。 (繼承來源 Object) |
| Purge() |
從計時器任務佇列中移除所有已取消的任務。 |
| Schedule(TimerTask, Date, Int64) |
排程指定任務，於指定時間開始重複執行固定 延遲。 |
| Schedule(TimerTask, Date) |
排程指定任務於指定時間執行。 |
| Schedule(TimerTask, Int64, Int64) |
排程指定任務重複 執行固定延遲，從指定延遲後開始。 |
| Schedule(TimerTask, Int64) |
在指定延遲後排程執行指定任務。 |
| ScheduleAtFixedRate(TimerTask, Date, Int64) |
排程指定任務，於指定時間開始重複固定 速率執行。 |
| ScheduleAtFixedRate(TimerTask, Int64, Int64) |
排程指定任務重複固定 速率執行，從指定延遲開始。 |
| SetHandle(IntPtr, JniHandleOwnership) |
設定 Handle 屬性。 (繼承來源 Object) |
| SetPeerReference(JniObjectReference, JniObjectReferenceOptions) |
一個讓執行緒能排程未來在背景執行緒執行任務的設施。 (繼承來源 JavaObject) |
| ToArray<T>() |
從這個 Java 陣列包裝器建立一個受管理陣列。 (繼承來源 Object) |
| ToString() |
回傳物件的字串表示。 (繼承來源 Object) |
| UnregisterFromRuntime() |
將此 Java 節點從互通執行時中取消註冊。 (繼承來源 Object) |
| Wait() |
導致目前執行緒等待被喚醒，通常是透過 <em>通知</><em 或 em>中斷</em> 來喚醒。 (繼承來源 Object) |
| Wait(Int64, Int32) |
會讓目前執行緒等待喚醒，通常是透過 <em>通知</><em 或 em>中斷</em>，或是經過一定的真實時間。 (繼承來源 Object) |
| Wait(Int64) |
會讓目前執行緒等待喚醒，通常是透過 <em>通知</><em 或 em>中斷</em>，或是經過一定的真實時間。 (繼承來源 Object) |
明確介面實作
| 名稱 | Description |
|---|---|
| IJavaPeerable.Disposed() |
一個讓執行緒能排程未來在背景執行緒執行任務的設施。 (繼承來源 JavaObject) |
| IJavaPeerable.Finalized() |
一個讓執行緒能排程未來在背景執行緒執行任務的設施。 (繼承來源 JavaObject) |
| IJavaPeerable.JniObjectReferenceControlBlock |
一個讓執行緒能排程未來在背景執行緒執行任務的設施。 (繼承來源 JavaObject) |
| IJavaPeerable.SetJniIdentityHashCode(Int32) |
一個讓執行緒能排程未來在背景執行緒執行任務的設施。 (繼承來源 JavaObject) |
| IJavaPeerable.SetJniManagedPeerState(JniManagedPeerStates) |
一個讓執行緒能排程未來在背景執行緒執行任務的設施。 (繼承來源 JavaObject) |
| IJavaPeerable.SetPeerReference(JniObjectReference) |
一個讓執行緒能排程未來在背景執行緒執行任務的設施。 (繼承來源 JavaObject) |
擴充方法
| 名稱 | Description |
|---|---|
| GetJniTypeName(IJavaPeerable) |
取得實例 |
| JavaAs<TResult>(IJavaPeerable) |
試著強制 |
| JavaCast<TResult>(IJavaObject) |
執行 Android 執行時檢查型別轉換。 |
| JavaCast<TResult>(IJavaObject) |
一個讓執行緒能排程未來在背景執行緒執行任務的設施。 |
| TryJavaCast<TResult>(IJavaPeerable, TResult) |
試著強制 |