ContextWrapper.RegisterReceiver メソッド

定義

名前空間:: Android.Content

アセンブリ:: Mono.Android.dll

重要

一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。

オーバーロード

名前	説明
RegisterReceiver(BroadcastReceiver, IntentFilter, String, Handler, ActivityFlags)	古い. スケジューラのコンテキストで実行する意図ブロードキャストを受信するように登録します。詳細については、registerReceiver(BroadcastReceiver,IntentFilter,int) と registerReceiver(BroadcastReceiver,IntentFilter,String,Handler) を参照してください。インテントブロードキャストの詳細については、BroadcastReceiver を参照してください。 Build.VERSION_CODES時点。UPSIDE_DOWN_CAKE、アプリがキャッシュされた状態にある間、システムはコンテキスト登録ブロードキャストをキューに配置できます。フォアグラウンドに戻るなど、アプリがキャッシュされた状態を離れると、システムはキューに登録されたブロードキャストを配信します。特定のブロードキャストの複数のインスタンスが 1 つのブロードキャストにマージされる場合があります。 Build.VERSION_CODES時点。ICE_CREAM_SANDWICH、このメソッドに登録されている受信者は、ブロードキャストされるインテントに指定された Intent.setPackage(String) を正しく尊重します。それ以前は、無視され、一致するすべての登録済みレシーバーに配信されます。セキュリティのためにこれを使用する場合は注意してください。パラメーターレシーバー BroadcastReceiver: この値は null である可能性があります。
RegisterReceiver(BroadcastReceiver, IntentFilter, String, Handler)	インテントブロードキャストを受信するように登録し、 <var>scheduler</var> のコンテキストで実行します。
RegisterReceiver(BroadcastReceiver, IntentFilter)	メインアクティビティスレッドで実行する BroadcastReceiver を登録します。
RegisterReceiver(BroadcastReceiver, IntentFilter, ActivityFlags)	古い. 必要に応じて、受信者がインスタントアプリに公開されている意図ブロードキャストを受信するように登録します。詳細については、registerReceiver(BroadcastReceiver,IntentFilter) を参照してください。既定では、インスタントアプリは他のアプリケーションの受信者と対話できません。これにより、インスタントアプリが操作できるレシーバーを公開できます。インテントブロードキャストの詳細については、BroadcastReceiver を参照してください。 Build.VERSION_CODES時点。UPSIDE_DOWN_CAKE、アプリがキャッシュされた状態にある間、システムはコンテキスト登録ブロードキャストをキューに配置できます。フォアグラウンドに戻るなど、アプリがキャッシュされた状態を離れると、システムはキューに登録されたブロードキャストを配信します。特定のブロードキャストの複数のインスタンスが 1 つのブロードキャストにマージされる場合があります。 Build.VERSION_CODES時点。ICE_CREAM_SANDWICH、このメソッドに登録されている受信者は、ブロードキャストされるインテントに指定された Intent.setPackage(String) を正しく尊重します。それ以前は、無視され、一致するすべての登録済みレシーバーに配信されます。セキュリティのためにこれを使用する場合は注意してください。パラメーターレシーバー BroadcastReceiver: この値は null である可能性があります。

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

注意事項

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

スケジューラのコンテキストで実行する意図ブロードキャストを受信するように登録します。詳細については、registerReceiver(BroadcastReceiver,IntentFilter,int) と registerReceiver(BroadcastReceiver,IntentFilter,String,Handler) を参照してください。インテントブロードキャストの詳細については、BroadcastReceiver を参照してください。 Build.VERSION_CODES時点。UPSIDE_DOWN_CAKE、アプリがキャッシュされた状態にある間、システムはコンテキスト登録ブロードキャストをキューに配置できます。フォアグラウンドに戻るなど、アプリがキャッシュされた状態を離れると、システムはキューに登録されたブロードキャストを配信します。特定のブロードキャストの複数のインスタンスが 1 つのブロードキャストにマージされる場合があります。 Build.VERSION_CODES時点。ICE_CREAM_SANDWICH、このメソッドに登録されている受信者は、ブロードキャストされるインテントに指定された Intent.setPackage(String) を正しく尊重します。それ以前は、無視され、一致するすべての登録済みレシーバーに配信されます。セキュリティのためにこれを使用する場合は注意してください。パラメーターレシーバー BroadcastReceiver: この値は null である可能性があります。

[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 override 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.")>]
override this.RegisterReceiver : Android.Content.BroadcastReceiver * Android.Content.IntentFilter * string * Android.OS.Handler * Android.Content.ActivityFlags -> Android.Content.Intent

パラメーター

receiver: BroadcastReceiver

登録するブロードキャストレシーバー。

filter: IntentFilter

受信するブロードキャストを選択する意図フィルター。

broadcastPermission: String

この受信者にインテントを送信するために、配信者が保持する必要があるアクセス許可の名前。 null の場合、アクセス許可は必要ありません。

scheduler: Handler

受信側コールバックが実行されるハンドラー。

flags: ActivityFlags

この操作を制御するフラグ。

返品

Intent

フィルターに一致する最初のスティッキー意図が見つかりました。存在しない場合は null。

属性: RegisterAttribute ObsoleteAttribute

注釈

このページの一部は、によって作成および共有され、に記載されている条件に従って使用される作業に基づく変更です。

Javaドキュメント。

適用対象

RegisterReceiver(BroadcastReceiver, IntentFilter, String, Handler)

インテントブロードキャストを受信するように登録し、 <var>scheduler</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 override 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")>]
override this.RegisterReceiver : Android.Content.BroadcastReceiver * Android.Content.IntentFilter * string * Android.OS.Handler -> Android.Content.Intent

パラメーター

receiver: BroadcastReceiver

ブロードキャストを処理する BroadcastReceiver。

filter: IntentFilter

受信するインテントブロードキャストを選択します。

broadcastPermission: String

この受信者にインテントを送信するために、配信者が保持する必要があるアクセス許可の名前。 null の場合、アクセス許可は必要ありません。

scheduler: Handler

インテントを受け取るスレッドを識別するハンドラー。 null の場合、プロセスのメインスレッドが使用されます。

返品

Intent

フィルターに一致する最初のスティッキー意図が見つかりました。存在しない場合は null。

属性: RegisterAttribute

注釈

このページの一部は、によって作成および共有され、に記載されている条件に従って使用される作業に基づく変更です。

Javaドキュメント。

適用対象

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 override 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")>]
override this.RegisterReceiver : Android.Content.BroadcastReceiver * Android.Content.IntentFilter -> Android.Content.Intent

パラメーター

receiver: BroadcastReceiver

ブロードキャストを処理する BroadcastReceiver。

filter: IntentFilter

受信するインテントブロードキャストを選択します。

返品

Intent

メインアクティビティスレッドで実行する BroadcastReceiver を登録します。受信側は、メインアプリケーションスレッド内のフィルターに一致するすべてのブロードキャストインテントで呼び出されます。システムは、"スティッキー" である意図をブロードキャストできます。これらは、ブロードキャストが完了した後も維持され、後の登録に送信されます。 IntentFilter がこれらのスティッキーな意図のいずれかに一致する場合、その意図はこの関数によって返され、ブロードキャストされたかのように受信側に送信されます。フィルターに一致するスティッキーな意図が複数存在する可能性があります。その場合、これらのそれぞれが受信者に送信されます。この場合、関数から直接返すことができるのは、これらのうちの 1 つだけです。返されるこれらのうちどれがシステムによって任意に決定されます。登録する意図がスティッキーであることがわかっている場合は、受信側に null を指定できます。この場合、受信者は登録されません。この関数は、フィルターに一致するスティッキーインテントを返します。複数の一致の場合は、上記と同じルールが適用されます。インテントブロードキャストの詳細については、BroadcastReceiver を参照してください。 Build.VERSION_CODES時点。UPSIDE_DOWN_CAKE、アプリがキャッシュされた状態にある間、システムはコンテキスト登録ブロードキャストをキューに配置できます。フォアグラウンドに戻るなど、アプリがキャッシュされた状態を離れると、システムはキューに登録されたブロードキャストを配信します。特定のブロードキャストの複数のインスタンスが 1 つのブロードキャストにマージされる場合があります。 Build.VERSION_CODES時点。ICE_CREAM_SANDWICH、このメソッドに登録されている受信者は、ブロードキャストされるインテントに指定された Intent.setPackage(String) を正しく尊重します。それ以前は、無視され、一致するすべての登録済みレシーバーに配信されます。セキュリティのためにこれを使用する場合は注意してください。 Build.VERSION_CODESを対象とするアプリの場合。UPSIDE_DOWN_CAKE、受信側がシステムブロードキャストに登録されていない場合、または SecurityException がスローされる場合は、RECEIVER_EXPORTEDまたはRECEIVER_NOT_EXPORTEDを指定する必要があります。フラグを持つレシーバーを登録するには、registerReceiver(BroadcastReceiver,IntentFilter,int) を参照してください。注: このメソッドは BroadcastReceiver コンポーネントから呼び出すことはできません。つまり、アプリケーションのマニフェストで宣言されている BroadcastReceiver から。ただし、登録された BroadcastReceiver の有効期間は登録されたオブジェクトに関連付けられているため、実行時に registerReceiver(BroadcastReceiver, IntentFilter) に登録されている別の BroadcastReceiver からこのメソッドを呼び出しても問題ありません。パラメーターレシーバー BroadcastReceiver: この値は null である可能性があります。 filter IntentFilter : 受信するインテントブロードキャストを選択します。意図を返します。フィルターに一致する最初のスティッキーな意図が見つかりました。存在しない場合は null。

属性: RegisterAttribute

注釈

このページの一部は、によって作成および共有され、に記載されている条件に従って使用される作業に基づく変更です。

Javaドキュメント。

適用対象

RegisterReceiver(BroadcastReceiver, IntentFilter, ActivityFlags)

注意事項

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

必要に応じて、受信者がインスタントアプリに公開されている意図ブロードキャストを受信するように登録します。詳細については、registerReceiver(BroadcastReceiver,IntentFilter) を参照してください。既定では、インスタントアプリは他のアプリケーションの受信者と対話できません。これにより、インスタントアプリが操作できるレシーバーを公開できます。インテントブロードキャストの詳細については、BroadcastReceiver を参照してください。 Build.VERSION_CODES時点。UPSIDE_DOWN_CAKE、アプリがキャッシュされた状態にある間、システムはコンテキスト登録ブロードキャストをキューに配置できます。フォアグラウンドに戻るなど、アプリがキャッシュされた状態を離れると、システムはキューに登録されたブロードキャストを配信します。特定のブロードキャストの複数のインスタンスが 1 つのブロードキャストにマージされる場合があります。 Build.VERSION_CODES時点。ICE_CREAM_SANDWICH、このメソッドに登録されている受信者は、ブロードキャストされるインテントに指定された Intent.setPackage(String) を正しく尊重します。それ以前は、無視され、一致するすべての登録済みレシーバーに配信されます。セキュリティのためにこれを使用する場合は注意してください。パラメーターレシーバー BroadcastReceiver: この値は null である可能性があります。

[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 override 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.")>]
override this.RegisterReceiver : Android.Content.BroadcastReceiver * Android.Content.IntentFilter * Android.Content.ActivityFlags -> Android.Content.Intent