Context.RegisterReceiver Méthode

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

Paramètres

Retours

La première intention sticky a trouvé qu’elle correspond au filtre, ou null s’il n’y en a pas.

Remarques

Inscrivez-vous pour recevoir des diffusions d’intentions, à exécuter dans le contexte du planificateur . Pour plus d’informations, consultez registerReceiver(BroadcastReceiver,IntentFilter,int) et registerReceiver(BroadcastReceiver,IntentFilter,String,Handler). Pour plus d’informations sur les diffusions d’intention, consultez BroadcastReceiver. À partir de Build.VERSION_CODES. UPSIDE_DOWN_CAKE , le système peut placer des diffusions inscrites dans le contexte dans une file d’attente pendant que l’application est à l’état mis en cache. Lorsque l’application quitte l’état mis en cache, tel que le retour au premier plan, le système remet toutes les diffusions en file d’attente. Plusieurs instances de certaines diffusions peuvent être fusionnées dans une seule diffusion. À partir de Build.VERSION_CODES. ICE_CREAM_SANDWICH , les récepteurs inscrits avec cette méthode respectent correctement l’intent.setPackage(String) spécifié pour une intention en cours de diffusion. Avant cela, il serait ignoré et remis à tous les récepteurs inscrits correspondants. Soyez prudent si vous utilisez cette option pour la sécurité. Récepteur de paramètres BroadcastReceiver : BroadcastReceiver pour gérer la diffusion.

Java documentation pour android.content.Context.registerReceiver(android.content.BroadcastReceiver, android.content.IntentFilter, java.lang.String, android.os.Handler, int).

Les parties de cette page sont des modifications basées sur le travail créé et partagé par Android Open Source et utilisées en fonction des termes décrits dans la Creative Commons 2.5 Attribution License.

[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

Paramètres

Retours

La première intention sticky trouvée qui correspond au <filtre>/var<var>, ou null s’il n’y en a pas.

Attributs

RegisterAttribute

Remarques

Inscrivez-vous pour recevoir des diffusions d’intentions, à exécuter dans le contexte du <planificateur>/<var>. Si vous souhaitez plus d’informations, consultez #registerReceiver(BroadcastReceiver, IntentFilter). Cela vous permet d’appliquer des autorisations sur les personnes autorisées à diffuser des intentions à votre récepteur ou à exécuter le récepteur dans un thread différent de celui du thread d’application principal.

Pour BroadcastReceiver plus d’informations sur les diffusions d’intentions.

À partir de android.os.Build.VERSION_CODES#UPSIDE_DOWN_CAKElà, le système peut placer des diffusions inscrites dans un contexte dans une file d’attente pendant que l’application est à l’état mis en cache. Lorsque l’application quitte l’état mis en cache, tel que le retour au premier plan, le système remet toutes les diffusions en file d’attente. Plusieurs instances de certaines diffusions peuvent être fusionnées dans une seule diffusion.

À compter de android.os.Build.VERSION_CODES#ICE_CREAM_SANDWICH, les récepteurs inscrits avec cette méthode respectent correctement les Intent#setPackage(String) spécifications d’une intention diffusée. Avant cela, il serait ignoré et remis à tous les récepteurs inscrits correspondants. Soyez prudent si vous utilisez cette option pour la sécurité.

Pour les applications ciblant android.os.Build.VERSION_CODES#UPSIDE_DOWN_CAKE, soit #RECEIVER_EXPORTED#RECEIVER_NOT_EXPORTED soit doit être spécifiée si le récepteur n’est pas inscrit pour les diffusions système ou si un SecurityException objet sera levée. Consultez #registerReceiver(BroadcastReceiver, IntentFilter, String, Handler, int) l’inscription d’un récepteur avec des indicateurs.

Java documentation pour android.content.Context.registerReceiver(android.content.BroadcastReceiver, android.content.IntentFilter, java.lang.String, android.os.Handler).

Les parties de cette page sont des modifications basées sur le travail créé et partagé par Android Open Source et utilisées en fonction des termes décrits dans la Creative Commons 2.5 Attribution License.

Voir aussi

• <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

Paramètres

Retours

La première intention sticky trouvée qui correspond au <filtre>/var<var>, ou null s’il n’y en a pas.

Attributs

RegisterAttribute ObsoleteAttribute

Remarques

Inscrivez-vous pour recevoir des diffusions d’intentions, à exécuter dans le contexte du <planificateur>/<var>. Pour plus d'informations, consultez #registerReceiver(BroadcastReceiver, IntentFilter, int) et #registerReceiver(BroadcastReceiver, IntentFilter, String, Handler).

Pour BroadcastReceiver plus d’informations sur les diffusions d’intentions.

À partir de android.os.Build.VERSION_CODES#UPSIDE_DOWN_CAKElà, le système peut placer des diffusions inscrites dans un contexte dans une file d’attente pendant que l’application est à l’état mis en cache. Lorsque l’application quitte l’état mis en cache, tel que le retour au premier plan, le système remet toutes les diffusions en file d’attente. Plusieurs instances de certaines diffusions peuvent être fusionnées dans une seule diffusion.

À compter de android.os.Build.VERSION_CODES#ICE_CREAM_SANDWICH, les récepteurs inscrits avec cette méthode respectent correctement les Intent#setPackage(String) spécifications d’une intention diffusée. Avant cela, il serait ignoré et remis à tous les récepteurs inscrits correspondants. Soyez prudent si vous utilisez cette option pour la sécurité.

Java documentation pour android.content.Context.registerReceiver(android.content.BroadcastReceiver, android.content.IntentFilter, java.lang.String, android.os.Handler, int).

Les parties de cette page sont des modifications basées sur le travail créé et partagé par Android Open Source et utilisées en fonction des termes décrits dans la Creative Commons 2.5 Attribution License.

[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

Paramètres

Retours

La première intention sticky trouvée qui correspond au <filtre>/var<var>, ou null s’il n’y en a pas.

Attributs

RegisterAttribute ObsoleteAttribute

Remarques

Inscrivez-vous pour recevoir des diffusions d’intentions, le récepteur étant éventuellement exposé aux applications instantanées. Si vous souhaitez plus d’informations, consultez #registerReceiver(BroadcastReceiver, IntentFilter). Par défaut, les applications instantanées ne peuvent pas interagir avec des récepteurs dans d’autres applications, ce qui vous permet d’exposer un récepteur avec lequel Les applications instantanées peuvent interagir.

Pour BroadcastReceiver plus d’informations sur les diffusions d’intentions.

À partir de android.os.Build.VERSION_CODES#UPSIDE_DOWN_CAKElà, le système peut placer des diffusions inscrites dans un contexte dans une file d’attente pendant que l’application est à l’état mis en cache. Lorsque l’application quitte l’état mis en cache, tel que le retour au premier plan, le système remet toutes les diffusions en file d’attente. Plusieurs instances de certaines diffusions peuvent être fusionnées dans une seule diffusion.

À compter de android.os.Build.VERSION_CODES#ICE_CREAM_SANDWICH, les récepteurs inscrits avec cette méthode respectent correctement les Intent#setPackage(String) spécifications d’une intention diffusée. Avant cela, il serait ignoré et remis à tous les récepteurs inscrits correspondants. Soyez prudent si vous utilisez cette option pour la sécurité.

Java documentation pour android.content.Context.registerReceiver(android.content.BroadcastReceiver, android.content.IntentFilter, int).

Les parties de cette page sont des modifications basées sur le travail créé et partagé par Android Open Source et utilisées en fonction des termes décrits dans la Creative Commons 2.5 Attribution License.

[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

Paramètres

Retours

La première intention sticky trouvée qui correspond au <filtre>/var<var>, ou null s’il n’y en a pas.

Attributs

RegisterAttribute

Remarques

Inscrivez un BroadcastReceiver à exécuter dans le thread d’activité principal. Le <récepteur>/var< var est appelé avec n’importe quelle intention de diffusion qui correspond >au filtre</var>< var, dans le thread d’application>principal.

Le système peut diffuser des intentions qui sont « collantes », ces derniers restent autour une fois la diffusion terminée, pour être envoyés à toutes les inscriptions ultérieures. Si votre IntentFilter correspond à l’une de ces intentions collantes, cette intention est retournée par cette fonction forte et/forte< envoyée à votre ><récepteur>/var var< comme si elle venait d’être diffusée.><>

Il peut y avoir plusieurs intentions sticky qui correspondent à var filter/var<, auquel cas chacun d’entre eux sera envoyé à >var<receiver>/var<.><> Dans ce cas, un seul de ces éléments peut être retourné directement par la fonction ; laquelle est retournée arbitrairement par le système.

Si vous connaissez l’intention à laquelle vous vous inscrivez est sticky, vous pouvez fournir la valeur Null pour votre <>récepteur</var var>. Dans ce cas, aucun récepteur n’est inscrit : la fonction retourne simplement l’intention sticky qui correspond au <>filtre< var/var>. Dans le cas de plusieurs correspondances, les mêmes règles que celles décrites ci-dessus s’appliquent.

Pour BroadcastReceiver plus d’informations sur les diffusions d’intentions.

À partir de android.os.Build.VERSION_CODES#UPSIDE_DOWN_CAKElà, le système peut placer des diffusions inscrites dans un contexte dans une file d’attente pendant que l’application est à l’état mis en cache. Lorsque l’application quitte l’état mis en cache, tel que le retour au premier plan, le système remet toutes les diffusions en file d’attente. Plusieurs instances de certaines diffusions peuvent être fusionnées dans une seule diffusion.

À compter de android.os.Build.VERSION_CODES#ICE_CREAM_SANDWICH, les récepteurs inscrits avec cette méthode respectent correctement les Intent#setPackage(String) spécifications d’une intention diffusée. Avant cela, il serait ignoré et remis à tous les récepteurs inscrits correspondants. Soyez prudent si vous utilisez cette option pour la sécurité.

Pour les applications ciblant android.os.Build.VERSION_CODES#UPSIDE_DOWN_CAKE, soit #RECEIVER_EXPORTED#RECEIVER_NOT_EXPORTED soit doit être spécifiée si le récepteur n’est pas inscrit pour les diffusions système ou si un SecurityException objet sera levée. Consultez #registerReceiver(BroadcastReceiver, IntentFilter, int) l’inscription d’un récepteur avec des indicateurs.

Remarque : cette méthode <em>ne peut pas être appelée à partir d’un BroadcastReceiver composant ;</em> , à partir d’un BroadcastReceiver déclaré dans le manifeste d’une application. Toutefois, il est acceptable d’appeler cette méthode à partir d’un autre BroadcastReceiver qui a lui-même été inscrit au moment #registerReceiverde l’exécution avec , depuis la durée de vie d’un tel BroadcastReceiver inscrit est lié à l’objet qui l’a inscrit.

Java documentation pour android.content.Context.registerReceiver(android.content.BroadcastReceiver, android.content.IntentFilter).

Les parties de cette page sont des modifications basées sur le travail créé et partagé par Android Open Source et utilisées en fonction des termes décrits dans la Creative Commons 2.5 Attribution License.

Voir aussi

• <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

Paramètres

Retours

La première intention sticky a trouvé qu’elle correspond au filtre, ou null s’il n’y en a pas.

Remarques

Inscrivez-vous pour recevoir des diffusions d’intentions, le récepteur étant éventuellement exposé aux applications instantanées. Pour plus d’informations, consultez registerReceiver(BroadcastReceiver,IntentFilter). Par défaut, les applications instantanées ne peuvent pas interagir avec des récepteurs dans d’autres applications, ce qui vous permet d’exposer un récepteur avec lequel Les applications instantanées peuvent interagir. Pour plus d’informations sur les diffusions d’intention, consultez BroadcastReceiver. À partir de Build.VERSION_CODES. UPSIDE_DOWN_CAKE , le système peut placer des diffusions inscrites dans le contexte dans une file d’attente pendant que l’application est à l’état mis en cache. Lorsque l’application quitte l’état mis en cache, tel que le retour au premier plan, le système remet toutes les diffusions en file d’attente. Plusieurs instances de certaines diffusions peuvent être fusionnées dans une seule diffusion. À partir de Build.VERSION_CODES. ICE_CREAM_SANDWICH , les récepteurs inscrits avec cette méthode respectent correctement l’intent.setPackage(String) spécifié pour une intention en cours de diffusion. Avant cela, il serait ignoré et remis à tous les récepteurs inscrits correspondants. Soyez prudent si vous utilisez cette option pour la sécurité. Récepteur de paramètres BroadcastReceiver : BroadcastReceiver pour gérer la diffusion. Cette valeur peut être null.

Java documentation pour android.content.Context.registerReceiver(android.content.BroadcastReceiver, android.content.IntentFilter, int).

Les parties de cette page sont des modifications basées sur le travail créé et partagé par Android Open Source et utilisées en fonction des termes décrits dans la Creative Commons 2.5 Attribution License.