ConnectivityManager.RegisterNetworkCallback Méthode

Définition

Espace de noms:: Android.Net

Assembly:: Mono.Android.dll

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
RegisterNetworkCallback(NetworkRequest, ConnectivityManager+NetworkCallback, Handler)	Inscrit le rappel réseau spécifié.
RegisterNetworkCallback(NetworkRequest, PendingIntent)	Inscrit un PendingIntent à envoyer lorsqu’un réseau est disponible, ce qui satisfait au nombre donné `NetworkRequest`.
RegisterNetworkCallback(NetworkRequest, ConnectivityManager+NetworkCallback)	S’inscrit pour recevoir des notifications sur tous les réseaux qui répondent aux besoins donnés NetworkRequest.

RegisterNetworkCallback(NetworkRequest, ConnectivityManager+NetworkCallback, Handler)

Inscrit le rappel réseau spécifié.

[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

Paramètres

request: NetworkRequest

networkCallback: ConnectivityManager.NetworkCallback

handler: Handler

Attributs: RegisterAttribute RequiresPermissionAttribute

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.

Java documentation pour android.net.ConnectivityManager.registerNetworkCallback(android.net.NetworkRequest, android.net.ConnectivityManager.NetworkCallback, android.os.Handler).

S’applique à

RegisterNetworkCallback(NetworkRequest, PendingIntent)

Inscrit un PendingIntent à envoyer lorsqu’un réseau est disponible, ce qui satisfait au nombre donné 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

Paramètres

request: NetworkRequest

NetworkRequest décrivant cette demande.

operation: PendingIntent

Action à effectuer lorsque le réseau est disponible (correspond à l’appel NetworkCallback#onAvailable . En général vient de PendingIntent#getBroadcast. Ne peut pas être null.

Attributs: RegisterAttribute RequiresPermissionAttribute

Remarques

Inscrit un PendingIntent à envoyer lorsqu’un réseau est disponible, ce qui satisfait au nombre donné NetworkRequest.

Cette fonction se comporte de façon identique à la version qui prend un NetworkCallback, mais au lieu d’une NetworkCallbackPendingIntent version utilisée. Cela signifie que la demande peut survivre à l’application appelante et être rappelée lorsqu’un réseau approprié est trouvé.

L’opération est une diffusion d’intention qui va à un récepteur de diffusion que vous avez inscrit avec ou via le < récepteur> balise dans un fichier AndroidManifest.xml

L’intention d’opération est fournie avec deux extras, un Network extra typé appelé #EXTRA_NETWORK et un NetworkRequest extra typé appelé #EXTRA_NETWORK_REQUEST contenant les paramètres de requêtes d’origine.

S’il existe déjà une demande pour cette intention inscrite (avec l’égalité de deux intentions définies par Intent#filterEquals), elle sera supprimée et remplacée par celle-ci, en libérant efficacement la précédente NetworkRequest.

La demande peut être libérée normalement en appelant #unregisterNetworkCallback(android.app.PendingIntent).

Pour éviter les problèmes de performances en raison des fuites de rappels d’applications, le système limite le nombre de demandes en attente à 100 par application (identifiée par leur UID), partagé avec toutes les variantes de cette méthode, de #requestNetwork même que ConnectivityDiagnosticsManager#registerConnectivityDiagnosticsCallback. La demande d’un réseau avec cette méthode compte vers cette limite. Si cette limite est dépassée, une exception est levée. Pour éviter de résoudre ce problème et de conserver les ressources, veillez à annuler l’inscription des rappels avec #unregisterNetworkCallback(PendingIntent) ou #releaseNetworkRequest(PendingIntent).

Java documentation pour android.net.ConnectivityManager.registerNetworkCallback(android.net.NetworkRequest, android.app.PendingIntent).

S’applique à

RegisterNetworkCallback(NetworkRequest, ConnectivityManager+NetworkCallback)

S’inscrit pour recevoir des notifications sur tous les réseaux qui répondent aux besoins donnés 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

Paramètres

request: NetworkRequest

NetworkRequest décrivant cette demande.

networkCallback: ConnectivityManager.NetworkCallback

Que ConnectivityManager.NetworkCallback le système appellera en tant que réseaux appropriés changent d’état.

Attributs: RegisterAttribute RequiresPermissionAttribute

Remarques

S’applique à