ConnectivityManager.RegisterNetworkCallback Método

Definição

Namespace:: Android.Net

Assembly:: Mono.Android.dll

Importante

Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.

Sobrecargas

Nome	Description
RegisterNetworkCallback(NetworkRequest, ConnectivityManager+NetworkCallback, Handler)	Registra o retorno de chamada de rede especificado.
RegisterNetworkCallback(NetworkRequest, PendingIntent)	Registra um PendingIntent a ser enviado quando uma rede está disponível, o que satisfaz o determinado `NetworkRequest`.
RegisterNetworkCallback(NetworkRequest, ConnectivityManager+NetworkCallback)	Registra-se para receber notificações sobre todas as redes que atendem ao determinado NetworkRequest.

RegisterNetworkCallback(NetworkRequest, ConnectivityManager+NetworkCallback, Handler)

Registra o retorno de chamada de rede especificado.

[Android.Runtime.Register("registerNetworkCallback", "(Landroid/net/NetworkRequest;Landroid/net/ConnectivityManager$NetworkCallback;Landroid/os/Handler;)V", "GetRegisterNetworkCallback_Landroid_net_NetworkRequest_Landroid_net_ConnectivityManager_NetworkCallback_Landroid_os_Handler_Handler", ApiSince=26)]
[Android.Runtime.RequiresPermission("android.permission.ACCESS_NETWORK_STATE")]
public virtual void RegisterNetworkCallback(Android.Net.NetworkRequest request, Android.Net.ConnectivityManager.NetworkCallback networkCallback, Android.OS.Handler handler);

[<Android.Runtime.Register("registerNetworkCallback", "(Landroid/net/NetworkRequest;Landroid/net/ConnectivityManager$NetworkCallback;Landroid/os/Handler;)V", "GetRegisterNetworkCallback_Landroid_net_NetworkRequest_Landroid_net_ConnectivityManager_NetworkCallback_Landroid_os_Handler_Handler", ApiSince=26)>]
[<Android.Runtime.RequiresPermission("android.permission.ACCESS_NETWORK_STATE")>]
abstract member RegisterNetworkCallback : Android.Net.NetworkRequest * Android.Net.ConnectivityManager.NetworkCallback * Android.OS.Handler -> unit
override this.RegisterNetworkCallback : Android.Net.NetworkRequest * Android.Net.ConnectivityManager.NetworkCallback * Android.OS.Handler -> unit

Parâmetros

request: NetworkRequest

networkCallback: ConnectivityManager.NetworkCallback

handler: Handler

Atributos: RegisterAttribute RequiresPermissionAttribute

Comentários

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.

Java documentação para android.net.ConnectivityManager.registerNetworkCallback(android.net.NetworkRequest, android.net.ConnectivityManager.NetworkCallback, android.os.Handler).

Aplica-se a

RegisterNetworkCallback(NetworkRequest, PendingIntent)

Registra um PendingIntent a ser enviado quando uma rede está disponível, o que satisfaz o determinado NetworkRequest.

[Android.Runtime.Register("registerNetworkCallback", "(Landroid/net/NetworkRequest;Landroid/app/PendingIntent;)V", "GetRegisterNetworkCallback_Landroid_net_NetworkRequest_Landroid_app_PendingIntent_Handler", ApiSince=23)]
[Android.Runtime.RequiresPermission("android.permission.ACCESS_NETWORK_STATE")]
public virtual void RegisterNetworkCallback(Android.Net.NetworkRequest request, Android.App.PendingIntent operation);

[<Android.Runtime.Register("registerNetworkCallback", "(Landroid/net/NetworkRequest;Landroid/app/PendingIntent;)V", "GetRegisterNetworkCallback_Landroid_net_NetworkRequest_Landroid_app_PendingIntent_Handler", ApiSince=23)>]
[<Android.Runtime.RequiresPermission("android.permission.ACCESS_NETWORK_STATE")>]
abstract member RegisterNetworkCallback : Android.Net.NetworkRequest * Android.App.PendingIntent -> unit
override this.RegisterNetworkCallback : Android.Net.NetworkRequest * Android.App.PendingIntent -> unit

Parâmetros

request: NetworkRequest

NetworkRequest descrevendo essa solicitação.

operation: PendingIntent

Ação a ser executada quando a rede estiver disponível (corresponde à NetworkCallback#onAvailable chamada. Normalmente vem de PendingIntent#getBroadcast. Não pode ser nulo.

Atributos: RegisterAttribute RequiresPermissionAttribute

Comentários

Registra um PendingIntent a ser enviado quando uma rede está disponível, o que satisfaz o determinado NetworkRequest.

Essa função se comporta de forma idêntica à versão que usa um NetworkCallback, mas em vez de NetworkCallback uma PendingIntent é usada. Isso significa que a solicitação pode sobreviver ao aplicativo de chamada e ser chamada novamente quando uma rede adequada for encontrada.

A operação é uma transmissão de intenção que vai para um receptor de transmissão que você registrou com ou por meio do < receptor> marca em um arquivo de AndroidManifest.xml

A operação Intent é entregue com dois extras, um Network extra digitado chamado #EXTRA_NETWORK e um NetworkRequest extra digitado chamado #EXTRA_NETWORK_REQUEST contendo os parâmetros de solicitações originais.

Se já houver uma solicitação para essa Intenção registrada (com a igualdade de duas Intenções definidas por Intent#filterEquals), ela será removida e substituída por esta, liberando efetivamente a anterior NetworkRequest.

A solicitação pode ser liberada normalmente chamando #unregisterNetworkCallback(android.app.PendingIntent).

Para evitar problemas de desempenho devido a aplicativos que vazam retornos de chamada, o sistema limitará o número de solicitações pendentes a 100 por aplicativo (identificado por sua UID), compartilhado com todas as variantes desse método, #requestNetwork bem como ConnectivityDiagnosticsManager#registerConnectivityDiagnosticsCallback. A solicitação de uma rede com esse método contará para esse limite. Se esse limite for excedido, uma exceção será gerada. Para evitar atingir esse problema e conservar recursos, certifique-se de cancelar o registro dos retornos de chamada com #unregisterNetworkCallback(PendingIntent) ou #releaseNetworkRequest(PendingIntent).

Java documentação para android.net.ConnectivityManager.registerNetworkCallback(android.net.NetworkRequest, android.app.PendingIntent).

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.

Aplica-se a

RegisterNetworkCallback(NetworkRequest, ConnectivityManager+NetworkCallback)

Registra-se para receber notificações sobre todas as redes que atendem ao determinado NetworkRequest.

[Android.Runtime.Register("registerNetworkCallback", "(Landroid/net/NetworkRequest;Landroid/net/ConnectivityManager$NetworkCallback;)V", "GetRegisterNetworkCallback_Landroid_net_NetworkRequest_Landroid_net_ConnectivityManager_NetworkCallback_Handler")]
[Android.Runtime.RequiresPermission("android.permission.ACCESS_NETWORK_STATE")]
public virtual void RegisterNetworkCallback(Android.Net.NetworkRequest request, Android.Net.ConnectivityManager.NetworkCallback networkCallback);

[<Android.Runtime.Register("registerNetworkCallback", "(Landroid/net/NetworkRequest;Landroid/net/ConnectivityManager$NetworkCallback;)V", "GetRegisterNetworkCallback_Landroid_net_NetworkRequest_Landroid_net_ConnectivityManager_NetworkCallback_Handler")>]
[<Android.Runtime.RequiresPermission("android.permission.ACCESS_NETWORK_STATE")>]
abstract member RegisterNetworkCallback : Android.Net.NetworkRequest * Android.Net.ConnectivityManager.NetworkCallback -> unit
override this.RegisterNetworkCallback : Android.Net.NetworkRequest * Android.Net.ConnectivityManager.NetworkCallback -> unit

Parâmetros

request: NetworkRequest

NetworkRequest descrevendo essa solicitação.

networkCallback: ConnectivityManager.NetworkCallback

O ConnectivityManager.NetworkCallback que o sistema chamará como estado de alteração de redes adequado.

Atributos: RegisterAttribute RequiresPermissionAttribute

Comentários

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.

Aplica-se a