Context.RegisterReceiver 方法

定義

命名空間:: Android.Content

組件:: Mono.Android.dll

重要

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

多載

名稱	Description
RegisterReceiver(BroadcastReceiver, IntentFilter, String, Handler, ReceiverFlags)	註冊以接收意圖廣播，以便在排程器情境下執行。更多資訊請參見 registerReceiver（BroadcastReceiver，IntentFilter，整數）與 registerReceiver（BroadcastReceiver，IntentFilter，String，Handler）。欲了解更多意圖廣播資訊，請參閱 BroadcastReceiver。截至Build.VERSION_CODES年。UPSIDE_DOWN_CAKE ，系統可在應用程式處於快取狀態時，將上下文註冊的廣播放入佇列。當應用程式離開快取狀態，例如回到前景時，系統會傳送所有排隊的廣播。某些廣播的多個實例可能會合併成一個廣播。截至Build.VERSION_CODES年。ICE_CREAM_SANDWICH，使用此方法註冊的接收器會正確遵守廣播意圖所指定的 Intent.setPackage（字串）。在此之前，這份郵件會被忽略，並送達所有匹配的註冊收件人。使用這些資料時要小心。參數接收器 BroadcastReceiver：負責處理廣播的 BroadcastReceiver。
RegisterReceiver(BroadcastReceiver, IntentFilter, String, Handler)	註冊以接收意圖廣播，並在 var<排程器>/var< 的情境>下執行。
RegisterReceiver(BroadcastReceiver, IntentFilter, String, Handler, ActivityFlags)	已淘汰. 註冊以接收意圖廣播，並在 var<排程器>/var< 的情境>下執行。
RegisterReceiver(BroadcastReceiver, IntentFilter, ActivityFlags)	已淘汰. 註冊以接收意圖廣播，接收端可選擇性地暴露給即時應用程式。
RegisterReceiver(BroadcastReceiver, IntentFilter)	註冊一個廣播接收器（BroadcastReceiver）以便在主活動執行緒中執行。
RegisterReceiver(BroadcastReceiver, IntentFilter, ReceiverFlags)	註冊以接收意圖廣播，接收端可選擇性地暴露給即時應用程式。更多資訊請參閱 registerReceiver（BroadcastReceiver， IntentFilter）。預設情況下，即時應用程式無法與其他應用程式中的接收器互動，這讓你可以公開一個接收器，讓即時應用程式能互動。欲了解更多意圖廣播資訊，請參閱 BroadcastReceiver。截至Build.VERSION_CODES年。UPSIDE_DOWN_CAKE ，系統可在應用程式處於快取狀態時，將上下文註冊的廣播放入佇列。當應用程式離開快取狀態，例如回到前景時，系統會傳送所有排隊的廣播。某些廣播的多個實例可能會合併成一個廣播。截至Build.VERSION_CODES年。ICE_CREAM_SANDWICH，使用此方法註冊的接收器會正確遵守廣播意圖所指定的 Intent.setPackage（字串）。在此之前，這份郵件會被忽略，並送達所有匹配的註冊收件人。使用這些資料時要小心。參數接收器 BroadcastReceiver：負責處理廣播的 BroadcastReceiver。此值可能是零值。

RegisterReceiver(BroadcastReceiver, IntentFilter, String, Handler, ReceiverFlags)

註冊以接收意圖廣播，以便在排程器情境下執行。更多資訊請參見 registerReceiver（BroadcastReceiver，IntentFilter，整數）與 registerReceiver（BroadcastReceiver，IntentFilter，String，Handler）。欲了解更多意圖廣播資訊，請參閱 BroadcastReceiver。截至Build.VERSION_CODES年。UPSIDE_DOWN_CAKE ，系統可在應用程式處於快取狀態時，將上下文註冊的廣播放入佇列。當應用程式離開快取狀態，例如回到前景時，系統會傳送所有排隊的廣播。某些廣播的多個實例可能會合併成一個廣播。截至Build.VERSION_CODES年。ICE_CREAM_SANDWICH，使用此方法註冊的接收器會正確遵守廣播意圖所指定的 Intent.setPackage（字串）。在此之前，這份郵件會被忽略，並送達所有匹配的註冊收件人。使用這些資料時要小心。參數接收器 BroadcastReceiver：負責處理廣播的 BroadcastReceiver。

public Android.Content.Intent? RegisterReceiver(Android.Content.BroadcastReceiver? receiver, Android.Content.IntentFilter? filter, string? broadcastPermission, Android.OS.Handler? scheduler, Android.Content.ReceiverFlags flags);

member this.RegisterReceiver : Android.Content.BroadcastReceiver * Android.Content.IntentFilter * string * Android.OS.Handler * Android.Content.ReceiverFlags -> Android.Content.Intent

參數

receiver: BroadcastReceiver

廣播接收器要註冊。

filter: IntentFilter

意圖過濾器，負責選擇接收廣播。

broadcastPermission: String

廣播業者必須持有的權限名稱，才能向此接收者發送意圖。若為無效，則無需授權。

scheduler: Handler

接球員回撥的處理者。

flags: ReceiverFlags

控制這次行動的旗幟。

傳回

Intent

第一個固定意圖找到的與濾波器相符，若沒有則為 null。

備註

Java 文件 android.content.Context.registerReceiver(android.content.BroadcastReceiver, android.content.IntentFilter, java.lang.String, android.os.Handler, int)。

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

適用於

RegisterReceiver(BroadcastReceiver, IntentFilter, String, Handler)

註冊以接收意圖廣播，並在 var<排程器>/var< 的情境>下執行。

[Android.Runtime.Register("registerReceiver", "(Landroid/content/BroadcastReceiver;Landroid/content/IntentFilter;Ljava/lang/String;Landroid/os/Handler;)Landroid/content/Intent;", "GetRegisterReceiver_Landroid_content_BroadcastReceiver_Landroid_content_IntentFilter_Ljava_lang_String_Landroid_os_Handler_Handler")]
public abstract Android.Content.Intent? RegisterReceiver(Android.Content.BroadcastReceiver? receiver, Android.Content.IntentFilter? filter, string? broadcastPermission, Android.OS.Handler? scheduler);

[<Android.Runtime.Register("registerReceiver", "(Landroid/content/BroadcastReceiver;Landroid/content/IntentFilter;Ljava/lang/String;Landroid/os/Handler;)Landroid/content/Intent;", "GetRegisterReceiver_Landroid_content_BroadcastReceiver_Landroid_content_IntentFilter_Ljava_lang_String_Landroid_os_Handler_Handler")>]
abstract member RegisterReceiver : Android.Content.BroadcastReceiver * Android.Content.IntentFilter * string * Android.OS.Handler -> Android.Content.Intent

參數

receiver: BroadcastReceiver

BroadcastReceiver 負責處理廣播。

filter: IntentFilter

選擇接收的意圖廣播。

broadcastPermission: String

字串命名一個廣播者必須持有的權限，才能向你發送意圖。若為無效，則無需授權。

scheduler: Handler

處理器識別將接收意圖的執行緒。若為空執行緒，則會使用程序的主執行緒。

傳回

Intent

第一個固定意圖找到符合 <var>filter</var 的 var>，若沒有則為 null。

屬性: RegisterAttribute

備註

註冊以接收意圖廣播，並在 var<排程器>/var< 的情境>下執行。如需相關資訊，請參閱 #registerReceiver(BroadcastReceiver, IntentFilter) 。這讓你能強制執行誰可以向接收端廣播意圖，或讓接收器在與主應用程式執行緒不同的執行緒中執行。

更多關於意圖廣播的資訊請參見 BroadcastReceiver 。

截至目前 android.os.Build.VERSION_CODES#UPSIDE_DOWN_CAKE，系統可以在應用程式處於快取狀態時，將上下文註冊的廣播放入隊列。當應用程式離開快取狀態，例如回到前景時，系統會傳送所有排隊的廣播。某些廣播的多個實例可能會合併成一個廣播。

自 android.os.Build.VERSION_CODES#ICE_CREAM_SANDWICH，註冊使用此方法的接收器將正確遵守 Intent#setPackage(String) 所廣播意圖的規定。在此之前，這份郵件會被忽略，並送達所有匹配的註冊收件人。使用這些資料時要小心。

對於鎖定 android.os.Build.VERSION_CODES#UPSIDE_DOWN_CAKE的#RECEIVER_EXPORTED應用程式，若接收器未註冊系統#RECEIVER_NOT_EXPORTED，必須指定或，否則會拋出。SecurityException 請參閱 #registerReceiver(BroadcastReceiver, IntentFilter, String, Handler, int) 註冊帶有旗標的接收器。

Java 文件 android.content.Context.registerReceiver(android.content.BroadcastReceiver, android.content.IntentFilter, java.lang.String, android.os.Handler)。

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

另請參閱

<xref:Android.Content.Context.RegisterReceiver(Android.Content.BroadcastReceiver%2c+Android.Content.IntentFilter)>
SendBroadcast(Intent)
UnregisterReceiver(BroadcastReceiver)

適用於

RegisterReceiver(BroadcastReceiver, IntentFilter, String, Handler, ActivityFlags)

警告

This method has an incorrect enumeration type. Use the overload that takes ReceiverFlags instead.

註冊以接收意圖廣播，並在 var<排程器>/var< 的情境>下執行。

[Android.Runtime.Register("registerReceiver", "(Landroid/content/BroadcastReceiver;Landroid/content/IntentFilter;Ljava/lang/String;Landroid/os/Handler;I)Landroid/content/Intent;", "GetRegisterReceiver_Landroid_content_BroadcastReceiver_Landroid_content_IntentFilter_Ljava_lang_String_Landroid_os_Handler_IHandler", ApiSince=26)]
[System.Obsolete("This method has an incorrect enumeration type. Use the overload that takes ReceiverFlags instead.")]
public abstract Android.Content.Intent? RegisterReceiver(Android.Content.BroadcastReceiver? receiver, Android.Content.IntentFilter? filter, string? broadcastPermission, Android.OS.Handler? scheduler, Android.Content.ActivityFlags flags);

[<Android.Runtime.Register("registerReceiver", "(Landroid/content/BroadcastReceiver;Landroid/content/IntentFilter;Ljava/lang/String;Landroid/os/Handler;I)Landroid/content/Intent;", "GetRegisterReceiver_Landroid_content_BroadcastReceiver_Landroid_content_IntentFilter_Ljava_lang_String_Landroid_os_Handler_IHandler", ApiSince=26)>]
[<System.Obsolete("This method has an incorrect enumeration type. Use the overload that takes ReceiverFlags instead.")>]
abstract member RegisterReceiver : Android.Content.BroadcastReceiver * Android.Content.IntentFilter * string * Android.OS.Handler * Android.Content.ActivityFlags -> Android.Content.Intent

參數

receiver: BroadcastReceiver

BroadcastReceiver 負責處理廣播。

filter: IntentFilter

選擇接收的意圖廣播。

broadcastPermission: String

字串命名一個廣播者必須持有的權限，才能向你發送意圖。若為無效，則無需授權。

scheduler: Handler

處理器識別將接收意圖的執行緒。若為空執行緒，則會使用程序的主執行緒。

flags: ActivityFlags

接球員的額外選項。對於針對 android.os.Build.VERSION_CODES#UPSIDE_DOWN_CAKE#RECEIVER_EXPORTED 或的應用程式，如果接收器沒有註冊系統廣播，必須指定或 #RECEIVER_NOT_EXPORTEDSecurityException ，否則會被拋出。若 #RECEIVER_EXPORTED 指定為，接收者可額外指定 #RECEIVER_VISIBLE_TO_INSTANT_APPS。完整系統廣播動作清單，請參閱 Android SDK 中的 BROADCAST_ACTIONS.TXT 檔案。若同時 #RECEIVER_EXPORTED 指定和 #RECEIVER_NOT_EXPORTED ，則會拋出 a IllegalArgumentException 。

傳回

Intent

第一個固定意圖找到符合 <var>filter</var 的 var>，若沒有則為 null。

屬性: RegisterAttribute ObsoleteAttribute

備註

註冊以接收意圖廣播，並在 var<排程器>/var< 的情境>下執行。如需詳細資訊，請參閱 #registerReceiver(BroadcastReceiver, IntentFilter, int) 和 #registerReceiver(BroadcastReceiver, IntentFilter, String, Handler)。

更多關於意圖廣播的資訊請參見 BroadcastReceiver 。

Java 文件 android.content.Context.registerReceiver(android.content.BroadcastReceiver, android.content.IntentFilter, java.lang.String, android.os.Handler, int)。

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

適用於

RegisterReceiver(BroadcastReceiver, IntentFilter, ActivityFlags)

警告

This method has an incorrect enumeration type. Use the overload that takes ReceiverFlags instead.

註冊以接收意圖廣播，接收端可選擇性地暴露給即時應用程式。

[Android.Runtime.Register("registerReceiver", "(Landroid/content/BroadcastReceiver;Landroid/content/IntentFilter;I)Landroid/content/Intent;", "GetRegisterReceiver_Landroid_content_BroadcastReceiver_Landroid_content_IntentFilter_IHandler", ApiSince=26)]
[System.Obsolete("This method has an incorrect enumeration type. Use the overload that takes ReceiverFlags instead.")]
public abstract Android.Content.Intent? RegisterReceiver(Android.Content.BroadcastReceiver? receiver, Android.Content.IntentFilter? filter, Android.Content.ActivityFlags flags);

[<Android.Runtime.Register("registerReceiver", "(Landroid/content/BroadcastReceiver;Landroid/content/IntentFilter;I)Landroid/content/Intent;", "GetRegisterReceiver_Landroid_content_BroadcastReceiver_Landroid_content_IntentFilter_IHandler", ApiSince=26)>]
[<System.Obsolete("This method has an incorrect enumeration type. Use the overload that takes ReceiverFlags instead.")>]
abstract member RegisterReceiver : Android.Content.BroadcastReceiver * Android.Content.IntentFilter * Android.Content.ActivityFlags -> Android.Content.Intent

參數

receiver: BroadcastReceiver

BroadcastReceiver 負責處理廣播。

filter: IntentFilter

選擇接收的意圖廣播。

flags: ActivityFlags

傳回

Intent

第一個固定意圖找到符合 <var>filter</var 的 var>，若沒有則為 null。

屬性: RegisterAttribute ObsoleteAttribute

備註

註冊以接收意圖廣播，接收端可選擇性地暴露給即時應用程式。如需相關資訊，請參閱 #registerReceiver(BroadcastReceiver, IntentFilter) 。預設情況下，即時應用程式無法與其他應用程式中的接收器互動，這讓你可以公開一個接收器，讓即時應用程式能互動。

更多關於意圖廣播的資訊請參見 BroadcastReceiver 。

Java 文件 android.content.Context.registerReceiver(android.content.BroadcastReceiver, android.content.IntentFilter, int)。

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

適用於

RegisterReceiver(BroadcastReceiver, IntentFilter)

註冊一個廣播接收器（BroadcastReceiver）以便在主活動執行緒中執行。

[Android.Runtime.Register("registerReceiver", "(Landroid/content/BroadcastReceiver;Landroid/content/IntentFilter;)Landroid/content/Intent;", "GetRegisterReceiver_Landroid_content_BroadcastReceiver_Landroid_content_IntentFilter_Handler")]
public abstract Android.Content.Intent? RegisterReceiver(Android.Content.BroadcastReceiver? receiver, Android.Content.IntentFilter? filter);

[<Android.Runtime.Register("registerReceiver", "(Landroid/content/BroadcastReceiver;Landroid/content/IntentFilter;)Landroid/content/Intent;", "GetRegisterReceiver_Landroid_content_BroadcastReceiver_Landroid_content_IntentFilter_Handler")>]
abstract member RegisterReceiver : Android.Content.BroadcastReceiver * Android.Content.IntentFilter -> Android.Content.Intent

參數

receiver: BroadcastReceiver

BroadcastReceiver 負責處理廣播。

filter: IntentFilter

選擇接收的意圖廣播。

傳回

Intent

第一個固定意圖找到符合 <var>filter</var 的 var>，若沒有則為 null。

屬性: RegisterAttribute

備註

註冊一個廣播接收器（BroadcastReceiver）以便在主活動執行緒中執行。 <var>接收器</var> 會在主應用程式執行緒中，以任何符合 <var>filter</var> 的廣播意圖被呼叫。

系統可能會廣播「黏著」的意圖——這些意圖會在廣播結束後保留，並送往後續的註冊者。如果你的 IntentFilter 與這些黏性 Intent 匹配，該 Intent 會透過這個函式 <strong>< 和/strong> 傳送給你的 <var>接收器</var>，就像剛廣播一樣。

可能有多個與 var filter</var 相符>的黏性 Intents，這時每個都會被送到 <var>receiver</var>。<> 在這種情況下，函數只能直接回傳其中一種;系統會隨意決定哪些回傳。

如果你知道你註冊的 Intent 是固定的，你可以為你的 <VAR>接收器</變體>提供 null。此時沒有註冊接收器——函式僅回傳與 var<filter>/var< 相符>的黏性意圖。多場比賽的情況，適用上述相同的規則。

更多關於意圖廣播的資訊請參見 BroadcastReceiver 。

注意：此方法 <em>無法從元件呼叫 BroadcastReceiver ;</em> ，也就是來自應用程式清單中宣告的廣播接收器。然而，從另一個本身在執行時已註冊的 #registerReceiverBroadcastReceiver 呼叫此方法是可以的，因為該註冊 BroadcastReceiver 的存續期與註冊它的物件綁定。

Java 文件 android.content.Context.registerReceiver(android.content.BroadcastReceiver, android.content.IntentFilter)。

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

另請參閱

<xref:Android.Content.Context.RegisterReceiver(Android.Content.BroadcastReceiver%2c+Android.Content.IntentFilter%2c+Android.Content.IntentFilter%2c+Android.Content.IntentFilter)>
SendBroadcast(Intent)
UnregisterReceiver(BroadcastReceiver)

適用於

RegisterReceiver(BroadcastReceiver, IntentFilter, ReceiverFlags)

註冊以接收意圖廣播，接收端可選擇性地暴露給即時應用程式。更多資訊請參閱 registerReceiver（BroadcastReceiver， IntentFilter）。預設情況下，即時應用程式無法與其他應用程式中的接收器互動，這讓你可以公開一個接收器，讓即時應用程式能互動。欲了解更多意圖廣播資訊，請參閱 BroadcastReceiver。截至Build.VERSION_CODES年。UPSIDE_DOWN_CAKE ，系統可在應用程式處於快取狀態時，將上下文註冊的廣播放入佇列。當應用程式離開快取狀態，例如回到前景時，系統會傳送所有排隊的廣播。某些廣播的多個實例可能會合併成一個廣播。截至Build.VERSION_CODES年。ICE_CREAM_SANDWICH，使用此方法註冊的接收器會正確遵守廣播意圖所指定的 Intent.setPackage（字串）。在此之前，這份郵件會被忽略，並送達所有匹配的註冊收件人。使用這些資料時要小心。參數接收器 BroadcastReceiver：負責處理廣播的 BroadcastReceiver。此值可能是零值。

public Android.Content.Intent? RegisterReceiver(Android.Content.BroadcastReceiver? receiver, Android.Content.IntentFilter? filter, Android.Content.ReceiverFlags flags);

member this.RegisterReceiver : Android.Content.BroadcastReceiver * Android.Content.IntentFilter * Android.Content.ReceiverFlags -> Android.Content.Intent

參數

receiver: BroadcastReceiver

廣播接收器要註冊。

filter: IntentFilter

意圖過濾器，負責選擇接收廣播。

flags: ReceiverFlags

控制這次行動的旗幟。

傳回

Intent

第一個固定意圖找到的與濾波器相符，若沒有則為 null。

備註

Java 文件 android.content.Context.registerReceiver(android.content.BroadcastReceiver, android.content.IntentFilter, int)。

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

適用於