AlarmManager 類別

定義

命名空間:

Android.App

組件:

Mono.Android.dll

這個類別提供系統警示服務的存取權。

[Android.Runtime.Register("android/app/AlarmManager", DoNotGenerateAcw=true)]
public class AlarmManager : Java.Lang.Object

[<Android.Runtime.Register("android/app/AlarmManager", DoNotGenerateAcw=true)>]
type AlarmManager = class
    inherit Object

繼承

Object

Object

AlarmManager

屬性

RegisterAttribute

備註

這個類別提供系統警示服務的存取權。 這些可讓您將應用程式排程在未來某個時間點執行。 當警示關閉時， Intent 系統已為其註冊的 會由系統廣播，如果目標應用程式尚未執行，就會自動啟動目標應用程式。 當裝置進入睡眠狀態 (時，會保留已註冊的警示，而且如果裝置在該時間) 關閉，可以選擇性地喚醒裝置，但如果裝置已關閉並重新啟動，則會予以清除。

只要警示接收者的 onReceive () 方法正在執行，警示管理員就會保留 CPU 喚醒鎖定。 這可確保在完成廣播處理之前，手機不會睡眠。 一旦 onReceive () 傳回，警示管理員就會釋放此喚醒鎖定。 這表示當 onReceive () 方法完成時，手機會立即睡眠。 如果您的警示接收者呼叫 android.content.Context#startService Context.startService() ，則手機在啟動要求的服務之前，可能會進入睡眠狀態。 若要避免這種情況，您的 BroadcastReceiver 和服務必須實作個別的喚醒鎖定原則，以確保手機會繼續執行，直到服務變成可用為止。

<b > 注意：警示管理員適用于您想要在特定時間執行應用程式程式碼的情況，即使您的應用程式目前未執行也一樣。 針對正常計時作業， (刻度、逾時等) 使用 android.os.Handler 會更容易且更有效率。 </B>

<p class=「caution」 >< strong > Note： < /strong > Start with API 19 (android.os.Build.VERSION_CODES#KITKAT) alarm delivery is inexact： the OS will shift alarms to minimize wakeups and battery use. 有新的 API 可支援需要嚴格傳遞保證的應用程式;請參閱 #setWindow(int, long, long, PendingIntent) 和 #setExact(int, long, PendingIntent) 。 targetSdkVersion早于 API 19 的應用程式會繼續看到先前的行為，其中所有警示會在要求時完全傳遞。

的 android.app.AlarmManager JAVA 檔。

此頁面的部分是根據所建立和共用的工作進行修改，並根據 2.5 屬性授權中所述的詞彙來使用。

建構函式

AlarmManager(IntPtr, JniHandleOwnership)

建立 JNI 物件的 Managed 標記法時使用的建構函式;由執行時間呼叫。

欄位

ActionNextAlarmClockChanged	廣播動作：在 傳 #getNextAlarmClock() 回的值變更之後傳送。
ActionScheduleExactAlarmPermissionStateChanged	廣播動作：應用程式獲授與 android.Manifest.permission#SCHEDULE_EXACT_ALARM 許可權。
IntervalDay	可辨識不精確的週期間隔#setInexactRepeating(int, long, long, PendingIntent) 在 API 19 之前的 Android 上執行時。
IntervalFifteenMinutes	可辨識不精確的週期間隔#setInexactRepeating(int, long, long, PendingIntent) 在 API 19 之前的 Android 上執行時。
IntervalHalfDay	可辨識不精確的週期間隔#setInexactRepeating(int, long, long, PendingIntent) 在 API 19 之前的 Android 上執行時。
IntervalHalfHour	可辨識不精確的週期間隔#setInexactRepeating(int, long, long, PendingIntent) 在 API 19 之前的 Android 上執行時。
IntervalHour	可辨識不精確的週期間隔#setInexactRepeating(int, long, long, PendingIntent) 在 API 19 之前的 Android 上執行時。

屬性

Class	傳回這個 Object 的執行時間類別。 (繼承來源 Object)
Handle	基礎 Android 實例的控制碼。 (繼承來源 Object)
JniIdentityHashCode	這個類別提供系統警示服務的存取權。 (繼承來源 Object)
JniPeerMembers	這個類別提供系統警示服務的存取權。
NextAlarmClock	取得目前排程之下一個鬧鐘的相關資訊。
PeerReference	這個類別提供系統警示服務的存取權。 (繼承來源 Object)
ThresholdClass	此 API 支援適用于 Android 的 Mono 基礎結構，並不適合直接從您的程式碼使用。
ThresholdType	此 API 支援適用于 Android 的 Mono 基礎結構，並不適合直接從您的程式碼使用。

方法

Cancel(AlarmManager+IOnAlarmListener)	移除排程要傳遞至指定 OnAlarmListener 的任何警示。
Cancel(PendingIntent)	移除具有相符 Intent 的任何警示。
CancelAll()	如果有任何警示，請移除先前由呼叫端設定的所有警示。
CanScheduleExactAlarms()	呼叫以檢查呼叫端是否可以排程確切的警示。
Clone()	建立並傳回這個 物件的複本。 (繼承來源 Object)
Dispose()	這個類別提供系統警示服務的存取權。 (繼承來源 Object)
Dispose(Boolean)	這個類別提供系統警示服務的存取權。 (繼承來源 Object)
Equals(Object)	指出其他物件是否「等於」這個物件。 (繼承來源 Object)
FromContext(Context)	這個類別提供系統警示服務的存取權。
GetHashCode()	傳回此物件的雜湊碼值。 (繼承來源 Object)
JavaFinalize()	當垃圾收集判斷物件不再參考物件時，垃圾收集行程會在物件上呼叫。 (繼承來源 Object)
Notify()	喚醒正在等候此物件監視器的單一線程。 (繼承來源 Object)
NotifyAll()	喚醒正在等候此物件監視器的所有線程。 (繼承來源 Object)
Set(AlarmType, Int64, PendingIntent)	排程警示。
Set(AlarmType, Int64, String, AlarmManager+IOnAlarmListener, Handler)	這個類別提供系統警示服務的存取權。
SetAlarmClock(AlarmManager+AlarmClockInfo, PendingIntent)	排程代表鬧鐘的警示，用來在關閉時通知使用者。
SetAndAllowWhileIdle(AlarmType, Int64, PendingIntent)	就像 一樣 #set(int, long, PendingIntent) ，即使系統處於低電量閒置 (，仍允許執行此警示。
SetExact(AlarmType, Int64, PendingIntent)	排程在指定時間精確傳遞的警示。
SetExact(AlarmType, Int64, String, AlarmManager+IOnAlarmListener, Handler)	排程在指定時間精確傳遞的警示。
SetExactAndAllowWhileIdle(AlarmType, Int64, PendingIntent)	就像 一樣 #setExact(int, long, PendingIntent) ，即使系統處於低電源閒置模式，仍允許執行此警示。
SetHandle(IntPtr, JniHandleOwnership)	設定 Handle 屬性。 (繼承來源 Object)
SetInexactRepeating(AlarmType, Int64, Int64, PendingIntent)	排程具有不精確的觸發時間需求的重複警示;例如，每小時重複一次的警示，但不一定是每小時頂端。
SetRepeating(AlarmType, Int64, Int64, PendingIntent)	排程重複的警示。
SetTime(Int64)	設定系統時鐘時間。
SetTimeZone(String)	設定系統的永續性預設時區。
SetWindow(AlarmType, Int64, Int64, PendingIntent)	排程在指定時段內傳遞的警示。
SetWindow(AlarmType, Int64, Int64, String, AlarmManager+IOnAlarmListener, Handler)	排程在指定時段內傳遞的警示。
SetWindow(AlarmType, Int64, Int64, String, IExecutor, AlarmManager+IOnAlarmListener)	這個類別提供系統警示服務的存取權。
ToArray<T>()	這個類別提供系統警示服務的存取權。 (繼承來源 Object)
ToString()	傳回物件的字串表示。 (繼承來源 Object)
UnregisterFromRuntime()	這個類別提供系統警示服務的存取權。 (繼承來源 Object)
Wait()	讓目前的執行緒等到喚醒為止，通常是 em < notified/em > 或 < em > interrupted < /em > 。 >< (繼承來源 Object)
Wait(Int64)	讓目前的執行緒等到喚醒為止，通常是 em < notified/em > 或 < em > interrupted < /em > ，或直到經過一定數量的即時為止。 <> (繼承來源 Object)
Wait(Int64, Int32)	讓目前的執行緒等到喚醒為止，通常是 em < notified/em > 或 < em > interrupted < /em > ，或直到經過一定數量的即時為止。 <> (繼承來源 Object)

明確介面實作

IJavaPeerable.Disposed()	這個類別提供系統警示服務的存取權。 (繼承來源 Object)
IJavaPeerable.DisposeUnlessReferenced()	這個類別提供系統警示服務的存取權。 (繼承來源 Object)
IJavaPeerable.Finalized()	這個類別提供系統警示服務的存取權。 (繼承來源 Object)
IJavaPeerable.JniManagedPeerState	這個類別提供系統警示服務的存取權。 (繼承來源 Object)
IJavaPeerable.SetJniIdentityHashCode(Int32)	這個類別提供系統警示服務的存取權。 (繼承來源 Object)
IJavaPeerable.SetJniManagedPeerState(JniManagedPeerStates)	這個類別提供系統警示服務的存取權。 (繼承來源 Object)
IJavaPeerable.SetPeerReference(JniObjectReference)	這個類別提供系統警示服務的存取權。 (繼承來源 Object)

擴充方法

JavaCast<TResult>(IJavaObject)	執行 Android 執行時間檢查的類型轉換。
JavaCast<TResult>(IJavaObject)	這個類別提供系統警示服務的存取權。
GetJniTypeName(IJavaPeerable)	這個類別提供系統警示服務的存取權。