ContextWrapper.RegisterReceiver Méthode
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
Surcharges
| Nom | Description |
|---|---|
| RegisterReceiver(BroadcastReceiver, IntentFilter, String, Handler, ActivityFlags) |
Obsolète.
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 : cette valeur peut être null. |
| RegisterReceiver(BroadcastReceiver, IntentFilter, String, Handler) |
Inscrivez-vous pour recevoir des diffusions d’intentions, à exécuter dans le contexte du <planificateur>/<var>. |
| RegisterReceiver(BroadcastReceiver, IntentFilter) |
Inscrivez un BroadcastReceiver à exécuter dans le thread d’activité principal. |
| RegisterReceiver(BroadcastReceiver, IntentFilter, ActivityFlags) |
Obsolète.
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 : cette valeur peut être null. |
RegisterReceiver(BroadcastReceiver, IntentFilter, String, Handler, ActivityFlags)
Attention
This method has an incorrect enumeration type. Use the overload that takes ReceiverFlags instead.
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 : cette valeur peut être 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.IntentParamètres
- receiver
- BroadcastReceiver
Récepteur de diffusion à inscrire.
- filter
- IntentFilter
Filtre d’intention qui sélectionne les diffusions à recevoir.
- broadcastPermission
- String
Nom d’une autorisation qu’un radiodiffuseur doit conserver pour envoyer une intention à ce récepteur. Si la valeur est Null, aucune autorisation n’est requise.
- scheduler
- Handler
Gestionnaire sur lequel les rappels de récepteurs s’exécutent.
- flags
- ActivityFlags
Indicateurs qui contrôlent cette opération.
Retours
La première intention sticky a trouvé qu’elle correspond au filtre, ou null s’il n’y en a pas.
- Attributs
Remarques
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.
S’applique à
RegisterReceiver(BroadcastReceiver, IntentFilter, String, Handler)
Inscrivez-vous pour recevoir des diffusions d’intentions, à exécuter dans le contexte du <planificateur>/<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.IntentParamètres
- receiver
- BroadcastReceiver
BroadcastReceiver pour gérer la diffusion.
- filter
- IntentFilter
Sélectionne les diffusions d’intention à recevoir.
- broadcastPermission
- String
Nom d’une autorisation qu’un radiodiffuseur doit conserver pour envoyer une intention à ce récepteur. Si la valeur est Null, aucune autorisation n’est requise.
- scheduler
- Handler
Gestionnaire identifiant le thread qui recevra l’intention. Si la valeur est Null, le thread principal du processus sera utilisé.
Retours
La première intention sticky a trouvé qu’elle correspond au filtre, ou null s’il n’y en a pas.
- Attributs
Remarques
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.
S’applique à
RegisterReceiver(BroadcastReceiver, IntentFilter)
Inscrivez un BroadcastReceiver à exécuter dans le thread d’activité principal.
[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.IntentParamètres
- receiver
- BroadcastReceiver
BroadcastReceiver pour gérer la diffusion.
- filter
- IntentFilter
Sélectionne les diffusions d’intention à recevoir.
Retours
Inscrivez un BroadcastReceiver à exécuter dans le thread d’activité principal. Le récepteur est appelé avec n’importe quelle intention de diffusion qui correspond au filtre , 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 et envoyée à votre récepteur comme si elle venait d’être diffusée. Il peut y avoir plusieurs intentions collantes qui correspondent au filtre , auquel cas chacun d’eux sera envoyé au destinataire . 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 pour laquelle vous vous inscrivez est collant, vous pouvez fournir la valeur Null pour votre récepteur. Dans ce cas, aucun récepteur n’est inscrit . La fonction retourne simplement l’intention collante qui correspond au filtre . Dans le cas de plusieurs correspondances, les mêmes règles que celles décrites ci-dessus s’appliquent. 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é. Pour les applications ciblant Build.VERSION_CODES. UPSIDE_DOWN_CAKE , RECEIVER_EXPORTED ou RECEIVER_NOT_EXPORTED doit être spécifié si le récepteur n’est pas inscrit pour les diffusions système ou si une instance SecurityException est levée. Consultez registerReceiver(BroadcastReceiver,IntentFilter,int) pour inscrire un récepteur avec des indicateurs. Remarque : cette méthode ne peut pas être appelée à partir d’un composant BroadcastReceiver ; autrement dit, à 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 de l’exécution auprès de registerReceiver(BroadcastReceiver, IntentFilter), depuis la durée de vie d’un tel BroadcastReceiver inscrit est lié à l’objet qui l’a inscrit. Récepteur de paramètres BroadcastReceiver : cette valeur peut être null. filter IntentFilter : sélectionne les diffusions d’intention à recevoir. Renvoie l’intention La première intention sticky trouvée qui correspond au filtre, ou null s’il n’y en a aucun.
- Attributs
Remarques
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.
S’applique à
RegisterReceiver(BroadcastReceiver, IntentFilter, ActivityFlags)
Attention
This method has an incorrect enumeration type. Use the overload that takes ReceiverFlags instead.
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 : cette valeur peut être 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.IntentParamètres
- receiver
- BroadcastReceiver
Récepteur de diffusion à inscrire.
- filter
- IntentFilter
Filtre d’intention qui sélectionne les diffusions à recevoir.
- flags
- ActivityFlags
Indicateurs qui contrôlent cette opération.
Retours
La première intention sticky a trouvé qu’elle correspond au filtre, ou null s’il n’y en a pas.
- Attributs
Remarques
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.