Context.RegisterReceiver メソッド

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

パラメーター

返品

[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

パラメーター

返品

<var>filter</var>に一致する最初のスティッキーインテントが見つかりました。存在しない場合は null。

属性

RegisterAttribute

注釈

インテント ブロードキャストを受信するように登録し、 <var>scheduler</var> のコンテキストで実行します。 詳細については、「 #registerReceiver(BroadcastReceiver, IntentFilter) 」を参照してください。 これにより、受信者に意図をブロードキャストできるユーザー、またはメイン アプリケーション スレッドとは別のスレッドでレシーバーを実行できるユーザーにアクセス許可を適用できます。

インテント ブロードキャストの詳細については、 BroadcastReceiver を参照してください。

android.os.Build.VERSION_CODES#UPSIDE_DOWN_CAKEの時点で、アプリがキャッシュされた状態にある間、システムはコンテキスト登録ブロードキャストをキューに配置できます。 フォアグラウンドに戻るなど、アプリがキャッシュされた状態を離れると、システムはキューに登録されたブロードキャストを配信します。 特定のブロードキャストの複数のインスタンスが 1 つのブロードキャストにマージされる場合があります。

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) を参照してください。

android.content.Context.registerReceiver(android.content.BroadcastReceiver, android.content.IntentFilter, java.lang.String, android.os.Handler)の Java ドキュメント。

このページの一部は、Androidオープンソースプロジェクトによって作成および共有された作業に基づく変更でありCreative Commons 2.5属性ライセンスに記載されている条件に従って使用されます。

こちらもご覧ください

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

[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

パラメーター

返品

<var>filter</var>に一致する最初のスティッキーインテントが見つかりました。存在しない場合は null。

属性

RegisterAttribute ObsoleteAttribute

注釈

インテント ブロードキャストを受信するように登録し、 <var>scheduler</var> のコンテキストで実行します。 詳細については、「#registerReceiver(BroadcastReceiver, IntentFilter, int)」および「#registerReceiver(BroadcastReceiver, IntentFilter, String, Handler)」を参照してください。

インテント ブロードキャストの詳細については、 BroadcastReceiver を参照してください。

android.os.Build.VERSION_CODES#UPSIDE_DOWN_CAKEの時点で、アプリがキャッシュされた状態にある間、システムはコンテキスト登録ブロードキャストをキューに配置できます。 フォアグラウンドに戻るなど、アプリがキャッシュされた状態を離れると、システムはキューに登録されたブロードキャストを配信します。 特定のブロードキャストの複数のインスタンスが 1 つのブロードキャストにマージされる場合があります。

android.os.Build.VERSION_CODES#ICE_CREAM_SANDWICHの時点で、このメソッドに登録されている受信者は、ブロードキャストされるインテントに指定されたIntent#setPackage(String)を正しく尊重します。 それ以前は、無視され、一致するすべての登録済みレシーバーに配信されます。 セキュリティのためにこれを使用する場合は注意してください。

android.content.Context.registerReceiver(android.content.BroadcastReceiver, android.content.IntentFilter, java.lang.String, android.os.Handler, int)の Java ドキュメント。

このページの一部は、Androidオープンソースプロジェクトによって作成および共有された作業に基づく変更でありCreative Commons 2.5属性ライセンスに記載されている条件に従って使用されます。

[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

パラメーター

返品

<var>filter</var>に一致する最初のスティッキーインテントが見つかりました。存在しない場合は null。

属性

RegisterAttribute ObsoleteAttribute

注釈

必要に応じて、受信者がインスタント アプリに公開されている意図ブロードキャストを受信するように登録します。 詳細については、「 #registerReceiver(BroadcastReceiver, IntentFilter) 」を参照してください。 既定では、インスタント アプリは他のアプリケーションの受信者と対話できません。これにより、インスタント アプリが操作できるレシーバーを公開できます。

インテント ブロードキャストの詳細については、 BroadcastReceiver を参照してください。

android.os.Build.VERSION_CODES#UPSIDE_DOWN_CAKEの時点で、アプリがキャッシュされた状態にある間、システムはコンテキスト登録ブロードキャストをキューに配置できます。 フォアグラウンドに戻るなど、アプリがキャッシュされた状態を離れると、システムはキューに登録されたブロードキャストを配信します。 特定のブロードキャストの複数のインスタンスが 1 つのブロードキャストにマージされる場合があります。

android.os.Build.VERSION_CODES#ICE_CREAM_SANDWICHの時点で、このメソッドに登録されている受信者は、ブロードキャストされるインテントに指定されたIntent#setPackage(String)を正しく尊重します。 それ以前は、無視され、一致するすべての登録済みレシーバーに配信されます。 セキュリティのためにこれを使用する場合は注意してください。

android.content.Context.registerReceiver(android.content.BroadcastReceiver, android.content.IntentFilter, int)の Java ドキュメント。

このページの一部は、Androidオープンソースプロジェクトによって作成および共有された作業に基づく変更でありCreative Commons 2.5属性ライセンスに記載されている条件に従って使用されます。

[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

パラメーター

返品

<var>filter</var>に一致する最初のスティッキーインテントが見つかりました。存在しない場合は null。

属性

RegisterAttribute

注釈

メイン アクティビティ スレッドで実行する BroadcastReceiver を登録します。 <var>receiver</var>は、メイン アプリケーション スレッドの <var>filter</var> と一致するすべてのブロードキャストインテントで呼び出されます。

システムは、"スティッキー" である意図をブロードキャストできます。これらは、ブロードキャストが完了した後も維持され、後の登録に送信されます。 IntentFilter がこれらのスティッキーな意図のいずれかに一致する場合、その意図は、<var>receiver</var>に送信された<strong>and</strong> この関数によって返されます。

<var>filter</var>に一致するスティッキーインテントが複数存在する可能性があります。その場合、これらの各意図は<var>receiver</var>に送信されます。 この場合、関数から直接返すことができるのは、これらのうちの 1 つだけです。返されるこれらのうちどれがシステムによって任意に決定されます。

登録する意図が固定であることがわかっている場合は、 <var>receiver</var>に null を指定できます。 この場合、受信者は登録されません。この関数は、 <var>filter</var>に一致するスティッキーインテントを返します。 複数の一致の場合は、上記と同じルールが適用されます。

インテント ブロードキャストの詳細については、 BroadcastReceiver を参照してください。

android.os.Build.VERSION_CODES#UPSIDE_DOWN_CAKEの時点で、アプリがキャッシュされた状態にある間、システムはコンテキスト登録ブロードキャストをキューに配置できます。 フォアグラウンドに戻るなど、アプリがキャッシュされた状態を離れると、システムはキューに登録されたブロードキャストを配信します。 特定のブロードキャストの複数のインスタンスが 1 つのブロードキャストにマージされる場合があります。

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, int) を参照してください。

注: このメソッド<em>BroadcastReceiver コンポーネントから呼び出すことはできません;</em>つまり、アプリケーションのマニフェストで宣言されている BroadcastReceiver から。 ただし、登録された BroadcastReceiver の有効期間は登録されたオブジェクトに関連付けられているため、実行時に #registerReceiver で登録されている別の BroadcastReceiver からこのメソッドを呼び出しても問題ありません。

android.content.Context.registerReceiver(android.content.BroadcastReceiver, android.content.IntentFilter)の Java ドキュメント。

このページの一部は、Androidオープンソースプロジェクトによって作成および共有された作業に基づく変更でありCreative Commons 2.5属性ライセンスに記載されている条件に従って使用されます。

こちらもご覧ください

• <xref:Android.Content.Context.RegisterReceiver(Android.Content.BroadcastReceiver%2c+Android.Content.IntentFilter%2c+Android.Content.IntentFilter%2c+Android.Content.IntentFilter)>
• SendBroadcast(Intent)
• UnregisterReceiver(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

パラメーター

返品