ConnectivityManager.RequestNetwork 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
RequestNetwork(NetworkRequest, ConnectivityManager+NetworkCallback, Handler, Int32)
RequestNetwork(NetworkRequest, ConnectivityManager+NetworkCallback, Int32)
RequestNetwork(NetworkRequest, PendingIntent)	Demandez à un réseau de satisfaire un ensemble de `NetworkCapabilities`.
RequestNetwork(NetworkRequest, ConnectivityManager+NetworkCallback)	Demandez à un réseau de satisfaire un ensemble de NetworkCapabilities.
RequestNetwork(NetworkRequest, ConnectivityManager+NetworkCallback, Handler)

RequestNetwork(NetworkRequest, ConnectivityManager+NetworkCallback, Handler, Int32)

[Android.Runtime.Register("requestNetwork", "(Landroid/net/NetworkRequest;Landroid/net/ConnectivityManager$NetworkCallback;Landroid/os/Handler;I)V", "GetRequestNetwork_Landroid_net_NetworkRequest_Landroid_net_ConnectivityManager_NetworkCallback_Landroid_os_Handler_IHandler", ApiSince=26)]
public virtual void RequestNetwork(Android.Net.NetworkRequest request, Android.Net.ConnectivityManager.NetworkCallback networkCallback, Android.OS.Handler handler, int timeoutMs);

[<Android.Runtime.Register("requestNetwork", "(Landroid/net/NetworkRequest;Landroid/net/ConnectivityManager$NetworkCallback;Landroid/os/Handler;I)V", "GetRequestNetwork_Landroid_net_NetworkRequest_Landroid_net_ConnectivityManager_NetworkCallback_Landroid_os_Handler_IHandler", ApiSince=26)>]
abstract member RequestNetwork : Android.Net.NetworkRequest * Android.Net.ConnectivityManager.NetworkCallback * Android.OS.Handler * int -> unit
override this.RequestNetwork : Android.Net.NetworkRequest * Android.Net.ConnectivityManager.NetworkCallback * Android.OS.Handler * int -> unit

Paramètres

request: NetworkRequest

networkCallback: ConnectivityManager.NetworkCallback

handler: Handler

timeoutMs: Int32

Attributs: RegisterAttribute

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.requestNetwork(android.net.NetworkRequest, android.net.ConnectivityManager.NetworkCallback, android.os.Handler, int).

S’applique à

RequestNetwork(NetworkRequest, ConnectivityManager+NetworkCallback, Int32)

[Android.Runtime.Register("requestNetwork", "(Landroid/net/NetworkRequest;Landroid/net/ConnectivityManager$NetworkCallback;I)V", "GetRequestNetwork_Landroid_net_NetworkRequest_Landroid_net_ConnectivityManager_NetworkCallback_IHandler", ApiSince=26)]
public virtual void RequestNetwork(Android.Net.NetworkRequest request, Android.Net.ConnectivityManager.NetworkCallback networkCallback, int timeoutMs);

[<Android.Runtime.Register("requestNetwork", "(Landroid/net/NetworkRequest;Landroid/net/ConnectivityManager$NetworkCallback;I)V", "GetRequestNetwork_Landroid_net_NetworkRequest_Landroid_net_ConnectivityManager_NetworkCallback_IHandler", ApiSince=26)>]
abstract member RequestNetwork : Android.Net.NetworkRequest * Android.Net.ConnectivityManager.NetworkCallback * int -> unit
override this.RequestNetwork : Android.Net.NetworkRequest * Android.Net.ConnectivityManager.NetworkCallback * int -> unit

Paramètres

request: NetworkRequest

networkCallback: ConnectivityManager.NetworkCallback

timeoutMs: Int32

Attributs: RegisterAttribute

Remarques

Java documentation pour android.net.ConnectivityManager.requestNetwork(android.net.NetworkRequest, android.net.ConnectivityManager.NetworkCallback, int).

S’applique à

RequestNetwork(NetworkRequest, PendingIntent)

Demandez à un réseau de satisfaire un ensemble de NetworkCapabilities.

[Android.Runtime.Register("requestNetwork", "(Landroid/net/NetworkRequest;Landroid/app/PendingIntent;)V", "GetRequestNetwork_Landroid_net_NetworkRequest_Landroid_app_PendingIntent_Handler", ApiSince=22)]
public virtual void RequestNetwork(Android.Net.NetworkRequest request, Android.App.PendingIntent operation);

[<Android.Runtime.Register("requestNetwork", "(Landroid/net/NetworkRequest;Landroid/app/PendingIntent;)V", "GetRequestNetwork_Landroid_net_NetworkRequest_Landroid_app_PendingIntent_Handler", ApiSince=22)>]
abstract member RequestNetwork : Android.Net.NetworkRequest * Android.App.PendingIntent -> unit
override this.RequestNetwork : 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

Remarques

Demandez à un réseau de satisfaire un ensemble de NetworkCapabilities.

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. Il est important de créer une demande basée sur une NetworkCallback nouvelle demande avant d’effectuer le traitement de l’intention de réserver le réseau ou elle sera publiée peu de temps après le traitement de l’intention.

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 #releaseNetworkRequest(android.app.PendingIntent).

Il n’est actuellement pas pris en charge pour demander un réseau avec l’un ou NetworkCapabilities#NET_CAPABILITY_VALIDATEDNetworkCapabilities#NET_CAPABILITY_CAPTIVE_PORTAL l’autre NetworkCapabilities des états représentant qu’un réseau particulier ne peut jamais atteindre, et si un réseau atteint ces états est inconnu avant d’élever le réseau afin que le framework ne sache pas comment répondre à une demande avec ces fonctionnalités.

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 #registerNetworkCallback 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).

Cette méthode nécessite que l’appelant conserve l’autorisation android.Manifest.permission#CHANGE_NETWORK_STATE ou la possibilité de modifier les paramètres système comme déterminé par android.provider.Settings.System#canWrite.

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

S’applique à

RequestNetwork(NetworkRequest, ConnectivityManager+NetworkCallback)

Demandez à un réseau de satisfaire un ensemble de NetworkCapabilities.

[Android.Runtime.Register("requestNetwork", "(Landroid/net/NetworkRequest;Landroid/net/ConnectivityManager$NetworkCallback;)V", "GetRequestNetwork_Landroid_net_NetworkRequest_Landroid_net_ConnectivityManager_NetworkCallback_Handler")]
public virtual void RequestNetwork(Android.Net.NetworkRequest request, Android.Net.ConnectivityManager.NetworkCallback networkCallback);

[<Android.Runtime.Register("requestNetwork", "(Landroid/net/NetworkRequest;Landroid/net/ConnectivityManager$NetworkCallback;)V", "GetRequestNetwork_Landroid_net_NetworkRequest_Landroid_net_ConnectivityManager_NetworkCallback_Handler")>]
abstract member RequestNetwork : Android.Net.NetworkRequest * Android.Net.ConnectivityManager.NetworkCallback -> unit
override this.RequestNetwork : Android.Net.NetworkRequest * Android.Net.ConnectivityManager.NetworkCallback -> unit

Paramètres

request: NetworkRequest

NetworkRequest décrivant cette demande.

networkCallback: ConnectivityManager.NetworkCallback

À ConnectivityManager.NetworkCallback utiliser pour cette demande. Notez que le rappel ne doit pas être partagé : ils spécifient de manière unique cette demande.

Attributs: RegisterAttribute

Exceptions

IllegalArgumentException

si request spécifie un mutable NetworkCapabilities.

Remarques

S’applique à

RequestNetwork(NetworkRequest, ConnectivityManager+NetworkCallback, Handler)

[Android.Runtime.Register("requestNetwork", "(Landroid/net/NetworkRequest;Landroid/net/ConnectivityManager$NetworkCallback;Landroid/os/Handler;)V", "GetRequestNetwork_Landroid_net_NetworkRequest_Landroid_net_ConnectivityManager_NetworkCallback_Landroid_os_Handler_Handler", ApiSince=26)]
public virtual void RequestNetwork(Android.Net.NetworkRequest request, Android.Net.ConnectivityManager.NetworkCallback networkCallback, Android.OS.Handler handler);

[<Android.Runtime.Register("requestNetwork", "(Landroid/net/NetworkRequest;Landroid/net/ConnectivityManager$NetworkCallback;Landroid/os/Handler;)V", "GetRequestNetwork_Landroid_net_NetworkRequest_Landroid_net_ConnectivityManager_NetworkCallback_Landroid_os_Handler_Handler", ApiSince=26)>]
abstract member RequestNetwork : Android.Net.NetworkRequest * Android.Net.ConnectivityManager.NetworkCallback * Android.OS.Handler -> unit
override this.RequestNetwork : Android.Net.NetworkRequest * Android.Net.ConnectivityManager.NetworkCallback * Android.OS.Handler -> unit

Paramètres

request: NetworkRequest

networkCallback: ConnectivityManager.NetworkCallback

handler: Handler

Attributs: RegisterAttribute

Remarques

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

S’applique à