Notification.Builder 類別

定義

命名空間:: Android.App

組件:: Mono.Android.dll

重要

部分資訊涉及發行前產品，在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊，不做任何明確或隱含的瑕疵擔保。

通知物件的建構類別。

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

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

繼承: Object

JavaObject

Object
Notification.Builder

屬性: RegisterAttribute

備註

通知物件的建構類別。提供方便的方式來設定通知的各個欄位，並利用平台的通知版面範本產生內容檢視。如果你的應用程式支援最舊的 Android API 等級 4，你可以改用 Android 支援函式庫中的 NotificationCompat.Builder。範例：

Android 參考資料。android.app.Notification.Builder

本頁部分內容為基於 Open Source Project 所創建與分享的作品，並依授權條款所描述的使用進行修改。

建構函式

名稱	Description
Notification.Builder(Context, String)	以預設條件建造一個新的建造者：
Notification.Builder(Context)	此構造器已被棄用。
Notification.Builder(IntPtr, JniHandleOwnership)	初始化現有 Java 原生介面物件的受管理表示。

屬性

名稱	Description
Class	回傳此 `Object`的執行時類別。 (繼承來源 Object)
Extras	取得本通知建構器目前使用的元資料組合包。
Handle	底層 Android 實例的帳號。 (繼承來源 Object)
JniIdentityHashCode	取得由互通執行時指派給此 Java 對等端的身份雜湊碼。 (繼承來源 Object)
JniManagedPeerState	通知物件的建構類別。 (繼承來源 JavaObject)
JniPeerMembers	提供 Android.App.Notification.Builder 的 JNI 綁定基礎架構。
Notification	已淘汰. 此方法在 API 等級 16 被淘汰。
PeerReference	取得這個 Java 節點的 JNI 物件參考。 (繼承來源 Object)
Style	回傳由 setStyle（Style）設定的樣式。
ThresholdClass	提供 Android.App.Notification.Builder 的 JNI 綁定基礎架構。
ThresholdType	提供 Android.App.Notification.Builder 的 JNI 綁定基礎架構。

方法

名稱	Description
AddAction(Int32, ICharSequence, PendingIntent)	已淘汰. 此方法在 API 等級 23 中被棄用。
AddAction(Int32, String, PendingIntent)	已淘汰. 此方法在 API 等級 23 中被棄用。
AddAction(Notification+Action)	在此通知中新增一個動作。
AddExtras(Bundle)	將更多元資料合併到此通知中。
AddPerson(Person)	請新增與此通知相關的人員。
AddPerson(String)	此方法在 API 等級 28 中被棄用。
Build()	合併所有已設定的選項，並回傳一個新的通知物件。
Clone()	建立並回傳此物件的副本。 (繼承來源 Object)
Construct(JniObjectReference, JniObjectReferenceOptions)	通知物件的建構類別。 (繼承來源 JavaObject)
CreateBigContentView()	此方法在 API 等級 35 中被棄用。
CreateContentView()	此方法在 API 等級 35 中被棄用。
CreateHeadsUpContentView()	此方法在 API 等級 35 中被棄用。
Dispose()	釋放該 Java 節點所持有的資源。 (繼承來源 Object)
Dispose(Boolean)	釋放該 Java 節點所持有的資源。 (繼承來源 Object)
DisposeUnlessReferenced()	通知物件的建構類別。 (繼承來源 JavaObject)
Equals(Object)	通知物件的建構類別。 (繼承來源 JavaObject)
Equals(Object)	表示是否有其他物體「等同」於此物。 (繼承來源 Object)
Extend(Notification+IExtender)	對這個通知建構器套用擴展器。
GetHashCode()	回傳物件的雜湊碼值。 (繼承來源 Object)
JavaFinalize()	已淘汰. 當垃圾回收判定該物件不再有相關參考時，由垃圾回收器呼叫。 (繼承來源 Object)
Notify()	喚醒一個正在該物件監視器上等待的執行緒。 (繼承來源 Object)
NotifyAll()	喚醒所有等待該物件監視器的執行緒。 (繼承來源 Object)
RecoverBuilder(Context, Notification)	從現有通知建立建構者，以便進行進一步修改。
SetActions(Notification+Action[])	更改本通知所附的完整行動清單。
SetAgentInteractionFlags(NotificationAgentTaskInteractionFlags)	通知物件的建構類別。
SetAllowSystemGeneratedContextualActions(Boolean)	判斷平台是否能為通知產生情境動作。
SetAutoCancel(Boolean)	讓使用者觸碰時自動關閉這個通知。
SetBadgeIconType(NotificationBadgeIconType)	設定該通知要顯示哪個圖示作為徽章。
SetBubbleMetadata(Notification+BubbleMetadata)	設定 BubbleMetadata 用來在現有前景活動上方的浮動視窗顯示應用程式內容。
SetCategory(String)	設定通知類別。
SetChannelId(String)	指定通知應該透過哪個管道傳送。
SetChronometerCountDown(Boolean)	讓計時器倒數，而不是往上倒數。
SetColor(Int32)	設定 Notification.color。
SetColorized(Boolean)	設定此通知是否應該被著色。
SetContent(RemoteViews)	已淘汰. 提供一個自訂的 RemoteViews，取代平台範本。
SetContentInfo(ICharSequence)	已淘汰. 此方法在 API 等級 24 被棄用。
SetContentInfo(String)	已淘汰. 此方法在 API 等級 24 被棄用。
SetContentIntent(PendingIntent)	請提供一個待定意圖，當通知被點擊時發送。
SetContentText(ICharSequence)	在平台通知範本中設定第二行文字。
SetContentText(String)	在平台通知範本中設定第二行文字。
SetContentTitle(ICharSequence)	在平台通知範本中設定第一行文字。
SetContentTitle(String)	在平台通知範本中設定第一行文字。
SetCustomBigContentView(RemoteViews)	在擴展表單中提供自訂的 RemoteViews，取代平台範本。
SetCustomContentView(RemoteViews)	提供自訂的 RemoteViews 來取代平台範本。
SetCustomHeadsUpContentView(RemoteViews)	提供自訂的 RemoteViews，取代在 heads up 對話框中的平台範本。
SetDefaults(NotificationDefaults)	此方法在 API 等級 26 中被淘汰。
SetDeleteIntent(PendingIntent)	提供一個待定意圖（PendingIntent），當通知被使用者明確清除時發送。
SetExtras(Bundle)	為此通知設定元資料。
SetFlag(Int32, Boolean)	設定通知旗標的值
SetForegroundServiceBehavior(Int32)	指定與前景服務相關的通知所需的可見性政策。
SetFullScreenIntent(PendingIntent, Boolean)	意圖啟動，而不是在狀態欄發布通知。
SetGroup(String)	將此通知設為共用同一金鑰的通知群組。
SetGroupAlertBehavior(NotificationGroupAlertBehavior)	設定此通知的群組警報行為。
SetGroupSummary(Boolean)	將此通知設為一組通知的群組摘要。
SetHandle(IntPtr, JniHandleOwnership)	設定 Handle 屬性。 (繼承來源 Object)
SetHasSummarizedContent(Boolean)	通知物件的建構類別。
SetLargeIcon(Bitmap)	在通知內容檢視中新增一個大型圖示。
SetLargeIcon(Icon)	在通知內容檢視中新增一個大型圖示。
SetLights(Int32, Int32, Int32)	此方法在 API 等級 26 中被淘汰。
SetLocalOnly(Boolean)	設定此通知是否不應橋接到其他裝置。
SetLocusId(LocusId)	設定與此通知相關的 LocusId。
SetNumber(Int32)	設定此通知所代表的項目數量。
SetOngoing(Boolean)	設定此通知是否為「持續中」通知。
SetOnlyAlertOnce(Boolean)	如果你只想播放聲音、震動和快訊，且通知尚未顯示，請設定此旗標。
SetPeerReference(JniObjectReference, JniObjectReferenceOptions)	通知物件的建構類別。 (繼承來源 JavaObject)
SetPriority(Int32)	此方法在 API 等級 26 中被淘汰。
SetProgress(Int32, Int32, Boolean)	設定這個通知所代表的進度。
SetPublicVersion(Notification)	提供一個替代通知，其內容應在不安全的上下文中顯示（例如
SetRemoteInputHistory(ICharSequence[])	設定遠端輸入歷史。
SetRemoteInputHistory(String[])	設定遠端輸入歷史。
SetRequestPromotedOngoing(Boolean)	通知物件的建構類別。
SetSettingsText(ICharSequence)	提供文字，會以連結形式顯示到你的應用程式設定。
SetSettingsText(String)	提供文字，會以連結形式顯示到你的應用程式設定。
SetShortCriticalText(String)	設定一個非常短的字串，總結通知中最重要的資訊。
SetShortcutId(String)	從 Android 11 起，使用此方法連結到已發佈的長期分享捷徑的訊息通知（使用 MessagingStyle）可能會出現在該陰影的專用對話區塊，並可能顯示對話專屬的設定選項。
SetShowWhen(Boolean)	控制內容檢視中是否顯示以 setWhen 為時間戳記的設定。
SetSmallIcon(Icon)	設定小圖示，該圖示將代表狀態列中的通知。
SetSmallIcon(Int32, Int32)	setSmallIcon（int）的變體，當圖示是 LevelListDrawable 時，會額外設定一個層級參數。
SetSmallIcon(Int32)	設定小圖示資源，該資源將用來代表狀態列中的通知。
SetSortKey(String)	設定一個排序鍵，讓這個通知和同一個套件的其他通知一起排序。
SetSound(Uri, AudioAttributes)	此方法在 API 等級 26 中被淘汰。
SetSound(Uri, Stream)	已淘汰. 此方法在 API 等級 21 中被棄用。
SetSound(Uri)	此方法在 API 等級 26 中被淘汰。
SetStyle(Notification+Style)	新增一個豐富的通知風格，在建置時套用。
SetSubText(ICharSequence)	這會提供一些額外資訊，會在通知中顯示。
SetSubText(String)	這會提供一些額外資訊，會在通知中顯示。
SetTicker(ICharSequence, RemoteViews)	已淘汰. setTicker（CharSequence）的已過時版本。
SetTicker(ICharSequence)	設定傳送給無障礙服務的「跑馬燈」文字。
SetTicker(String, RemoteViews)	已淘汰. setTicker（CharSequence）的已過時版本。
SetTicker(String)	設定傳送給無障礙服務的「跑馬燈」文字。
SetTimeoutAfter(Int64)	指定以毫秒為單位的持續時間，若尚未取消此通知，則應在此時間內取消。
SetUsesChronometer(Boolean)	將 Notification.when 欄位顯示為碼錶。
SetVibrate(Int64[])	此方法在 API 等級 26 中被淘汰。
SetVisibility(NotificationVisibility)	指定 Notification.visibility 的值。
SetWhen(Int64)	加上與通知相關的時間戳記（通常是事件發生的時間）。
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)	取得實例 `self`類型的 JNI 名稱。
JavaAs<TResult>(IJavaPeerable)	試著強制`self`輸入 `TResult`，檢查強制在 Java 端是否有效。
JavaCast<TResult>(IJavaObject)	執行 Android 執行時檢查型別轉換。
JavaCast<TResult>(IJavaObject)	通知物件的建構類別。
TryJavaCast<TResult>(IJavaPeerable, TResult)	試著強制`self`輸入 `TResult`，檢查強制在 Java 端是否有效。

適用於