Context.RegisterReceiver Método

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

Parâmetros

Retornos

A primeira intenção pegajosa encontrada que corresponde ao filtro ou nulo se não houver nenhuma.

Comentários

Registre-se para receber transmissões de intenção, para ser executado no contexto do agendador. Consulte registerReceiver(BroadcastReceiver,IntentFilter,int) e registerReceiver(BroadcastReceiver, IntentFilter, String,Handler) para obter mais informações. Consulte BroadcastReceiver para obter mais informações sobre transmissões de intenção. A partir de Build.VERSION_CODES. UPSIDE_DOWN_CAKE, o sistema pode colocar transmissões registradas em contexto em uma fila enquanto o aplicativo está no estado armazenado em cache. Quando o aplicativo deixa o estado armazenado em cache, como retornar ao primeiro plano, o sistema entrega todas as transmissões na fila. Várias instâncias de determinadas transmissões podem ser mescladas em uma transmissão. A partir de Build.VERSION_CODES. ICE_CREAM_SANDWICH, os receptores registrados com esse método respeitarão corretamente o Intent.setPackage(String) especificado para uma intenção que está sendo transmitida. Antes disso, ele seria ignorado e entregue a todos os receptores registrados correspondentes. Tenha cuidado ao usar isso para segurança. Receptor de parâmetros BroadcastReceiver: o BroadcastReceiver para lidar com a transmissão.

Java documentação para android.content.Context.registerReceiver(android.content.BroadcastReceiver, android.content.IntentFilter, java.lang.String, android.os.Handler, int).

Partes desta página são modificações baseadas no trabalho criado e compartilhado pelo Project Open Source do Open Source e usadas de acordo com os termos descritos na Creative Commons 2.5.

[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

Parâmetros

Retornos

A primeira intenção pegajosa encontrada que corresponde ao <filtro> var</var> ou nulo se não houver nenhuma.

Atributos

RegisterAttribute

Comentários

Registre-se para receber transmissões de intenção, a serem executadas no contexto do <agendador>< var/var>. Consulte #registerReceiver(BroadcastReceiver, IntentFilter) para obter mais informações. Isso permite que você imponha permissões sobre quem pode transmitir intenções para o receptor ou fazer com que o receptor seja executado em um thread diferente do thread principal do aplicativo.

Consulte BroadcastReceiver mais informações sobre transmissões de intenção.

A partir daí android.os.Build.VERSION_CODES#UPSIDE_DOWN_CAKE, o sistema pode colocar transmissões registradas em contexto em uma fila enquanto o aplicativo está no estado armazenado em cache. Quando o aplicativo deixa o estado armazenado em cache, como retornar ao primeiro plano, o sistema entrega todas as transmissões na fila. Várias instâncias de determinadas transmissões podem ser mescladas em uma transmissão.

A partir de então android.os.Build.VERSION_CODES#ICE_CREAM_SANDWICH, os receptores registrados com esse método respeitarão corretamente o Intent#setPackage(String) especificado para uma intenção que está sendo transmitida. Antes disso, ele seria ignorado e entregue a todos os receptores registrados correspondentes. Tenha cuidado ao usar isso para segurança.

Para aplicativos android.os.Build.VERSION_CODES#UPSIDE_DOWN_CAKEdirecionados #RECEIVER_EXPORTED , ou #RECEIVER_NOT_EXPORTED devem ser especificados se o receptor não estiver sendo registrado para transmissões do sistema ou se um SecurityException será lançado. Consulte #registerReceiver(BroadcastReceiver, IntentFilter, String, Handler, int) para registrar um receptor com sinalizadores.

Java documentação para android.content.Context.registerReceiver(android.content.BroadcastReceiver, android.content.IntentFilter, java.lang.String, android.os.Handler).

Partes desta página são modificações baseadas no trabalho criado e compartilhado pelo Project Open Source do Open Source e usadas de acordo com os termos descritos na Creative Commons 2.5.

Confira também

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

Parâmetros

Retornos

A primeira intenção pegajosa encontrada que corresponde ao <filtro> var</var> ou nulo se não houver nenhuma.

Atributos

RegisterAttribute ObsoleteAttribute

Comentários

Registre-se para receber transmissões de intenção, a serem executadas no contexto do <agendador>< var/var>. Consulte #registerReceiver(BroadcastReceiver, IntentFilter, int) e #registerReceiver(BroadcastReceiver, IntentFilter, String, Handler) para obter mais informações.

Consulte BroadcastReceiver mais informações sobre transmissões de intenção.

A partir daí android.os.Build.VERSION_CODES#UPSIDE_DOWN_CAKE, o sistema pode colocar transmissões registradas em contexto em uma fila enquanto o aplicativo está no estado armazenado em cache. Quando o aplicativo deixa o estado armazenado em cache, como retornar ao primeiro plano, o sistema entrega todas as transmissões na fila. Várias instâncias de determinadas transmissões podem ser mescladas em uma transmissão.

A partir de então android.os.Build.VERSION_CODES#ICE_CREAM_SANDWICH, os receptores registrados com esse método respeitarão corretamente o Intent#setPackage(String) especificado para uma intenção que está sendo transmitida. Antes disso, ele seria ignorado e entregue a todos os receptores registrados correspondentes. Tenha cuidado ao usar isso para segurança.

Java documentação para android.content.Context.registerReceiver(android.content.BroadcastReceiver, android.content.IntentFilter, java.lang.String, android.os.Handler, int).

Partes desta página são modificações baseadas no trabalho criado e compartilhado pelo Project Open Source do Open Source e usadas de acordo com os termos descritos na 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

Parâmetros

Retornos

A primeira intenção pegajosa encontrada que corresponde ao <filtro> var</var> ou nulo se não houver nenhuma.

Atributos

RegisterAttribute ObsoleteAttribute

Comentários

Registre-se para receber transmissões de intenção, com o receptor opcionalmente sendo exposto aos Aplicativos Instantâneos. Consulte #registerReceiver(BroadcastReceiver, IntentFilter) para obter mais informações. Por padrão, os Aplicativos Instantâneos não podem interagir com receptores em outros aplicativos, o que permite expor um receptor com o qual os Aplicativos Instantâneos podem interagir.

Consulte BroadcastReceiver mais informações sobre transmissões de intenção.

A partir daí android.os.Build.VERSION_CODES#UPSIDE_DOWN_CAKE, o sistema pode colocar transmissões registradas em contexto em uma fila enquanto o aplicativo está no estado armazenado em cache. Quando o aplicativo deixa o estado armazenado em cache, como retornar ao primeiro plano, o sistema entrega todas as transmissões na fila. Várias instâncias de determinadas transmissões podem ser mescladas em uma transmissão.

A partir de então android.os.Build.VERSION_CODES#ICE_CREAM_SANDWICH, os receptores registrados com esse método respeitarão corretamente o Intent#setPackage(String) especificado para uma intenção que está sendo transmitida. Antes disso, ele seria ignorado e entregue a todos os receptores registrados correspondentes. Tenha cuidado ao usar isso para segurança.

Java documentação para android.content.Context.registerReceiver(android.content.BroadcastReceiver, android.content.IntentFilter, int).

Partes desta página são modificações baseadas no trabalho criado e compartilhado pelo Project Open Source do Open Source e usadas de acordo com os termos descritos na 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

Parâmetros

Retornos

A primeira intenção pegajosa encontrada que corresponde ao <filtro> var</var> ou nulo se não houver nenhuma.

Atributos

RegisterAttribute

Comentários

Registre um BroadcastReceiver para ser executado no thread de atividade principal. O <var>receiver</var> será chamado com qualquer intenção de transmissão que corresponda <ao filtro> var</var>, no thread principal do aplicativo.

O sistema pode transmitir intenções que são "pegajosas" - estas permanecem ao redor depois que a transmissão tiver terminado, para serem enviadas para quaisquer registros posteriores. Se o IntentFilter corresponder a uma destas intenções autoadesivas, essa intenção será retornada por essa função <forte>e</forte> enviada ao receptor<> var</var> como se tivesse sido transmitida.

Pode haver várias intenções pegajosas que correspondem ao filtro var/var<, nesse caso, cada uma delas será enviada ao>< var receiver>/var<.><> Nesse caso, apenas um deles pode ser retornado diretamente pela função; que destes que são retornados é arbitrariamente decidido pelo sistema.

Se você souber que a intenção para a qual está se registrando é pegajosa, você pode fornecer nulo para o receptor <>do var</var>. Nesse caso, nenhum receptor é registrado – a função simplesmente retorna a intenção pegajosa que corresponde ao <filtro> var</var>. No caso de várias correspondências, as mesmas regras descritas acima se aplicam.

Consulte BroadcastReceiver mais informações sobre transmissões de intenção.

A partir daí android.os.Build.VERSION_CODES#UPSIDE_DOWN_CAKE, o sistema pode colocar transmissões registradas em contexto em uma fila enquanto o aplicativo está no estado armazenado em cache. Quando o aplicativo deixa o estado armazenado em cache, como retornar ao primeiro plano, o sistema entrega todas as transmissões na fila. Várias instâncias de determinadas transmissões podem ser mescladas em uma transmissão.

A partir de então android.os.Build.VERSION_CODES#ICE_CREAM_SANDWICH, os receptores registrados com esse método respeitarão corretamente o Intent#setPackage(String) especificado para uma intenção que está sendo transmitida. Antes disso, ele seria ignorado e entregue a todos os receptores registrados correspondentes. Tenha cuidado ao usar isso para segurança.

Para aplicativos android.os.Build.VERSION_CODES#UPSIDE_DOWN_CAKEdirecionados #RECEIVER_EXPORTED , ou #RECEIVER_NOT_EXPORTED devem ser especificados se o receptor não estiver sendo registrado para transmissões do sistema ou se um SecurityException será lançado. Consulte #registerReceiver(BroadcastReceiver, IntentFilter, int) para registrar um receptor com sinalizadores.

Observação: este método <em>não pode ser chamado de um BroadcastReceiver componente;</em> , ou seja, de um BroadcastReceiver que é declarado no manifesto de um aplicativo. No entanto, não há problema em chamar esse método de outro BroadcastReceiver que foi registrado em tempo de execução com #registerReceiver, uma vez que o tempo de vida de um BroadcastReceiver registrado está vinculado ao objeto que o registrou.

Java documentação para android.content.Context.registerReceiver(android.content.BroadcastReceiver, android.content.IntentFilter).

Partes desta página são modificações baseadas no trabalho criado e compartilhado pelo Project Open Source do Open Source e usadas de acordo com os termos descritos na Creative Commons 2.5.

Confira também

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

Parâmetros

Retornos

A primeira intenção pegajosa encontrada que corresponde ao filtro ou nulo se não houver nenhuma.

Comentários

Registre-se para receber transmissões de intenção, com o receptor opcionalmente sendo exposto aos Aplicativos Instantâneos. Consulte registerReceiver(BroadcastReceiver,IntentFilter) para obter mais informações. Por padrão, os Aplicativos Instantâneos não podem interagir com receptores em outros aplicativos, o que permite expor um receptor com o qual os Aplicativos Instantâneos podem interagir. Consulte BroadcastReceiver para obter mais informações sobre transmissões de intenção. A partir de Build.VERSION_CODES. UPSIDE_DOWN_CAKE, o sistema pode colocar transmissões registradas em contexto em uma fila enquanto o aplicativo está no estado armazenado em cache. Quando o aplicativo deixa o estado armazenado em cache, como retornar ao primeiro plano, o sistema entrega todas as transmissões na fila. Várias instâncias de determinadas transmissões podem ser mescladas em uma transmissão. A partir de Build.VERSION_CODES. ICE_CREAM_SANDWICH, os receptores registrados com esse método respeitarão corretamente o Intent.setPackage(String) especificado para uma intenção que está sendo transmitida. Antes disso, ele seria ignorado e entregue a todos os receptores registrados correspondentes. Tenha cuidado ao usar isso para segurança. Receptor de parâmetros BroadcastReceiver: o BroadcastReceiver para lidar com a transmissão. Esse valor pode ser nulo.

Java documentação para android.content.Context.registerReceiver(android.content.BroadcastReceiver, android.content.IntentFilter, int).

Partes desta página são modificações baseadas no trabalho criado e compartilhado pelo Project Open Source do Open Source e usadas de acordo com os termos descritos na Creative Commons 2.5.