ConnectivityManager.RegisterNetworkCallback 方法
定义
重要
一些信息与预发行产品相关,相应产品在发行之前可能会进行重大修改。 对于此处提供的信息,Microsoft 不作任何明示或暗示的担保。
重载
| 名称 | 说明 |
|---|---|
| RegisterNetworkCallback(NetworkRequest, ConnectivityManager+NetworkCallback, Handler) |
注册指定的网络回调。 |
| RegisterNetworkCallback(NetworkRequest, PendingIntent) |
注册一个 PendingIntent,以在满足给定 |
| RegisterNetworkCallback(NetworkRequest, ConnectivityManager+NetworkCallback) |
注册以接收有关满足给定 NetworkRequest网络的所有网络的通知。 |
RegisterNetworkCallback(NetworkRequest, ConnectivityManager+NetworkCallback, 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")]
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
参数
- request
- NetworkRequest
描述此请求的 NetworkRequest。 此值不能为 null。
- networkCallback
- ConnectivityManager.NetworkCallback
系统将调用的 NetworkCallback 作为合适的网络更改状态。 此值不能为 null。
- handler
- Handler
用于指定将调用回调的线程的处理程序。 此值不能为 null。
- 特性
注解
本页的某些部分是根据 创建和共享的工作进行的修改,并根据 许可证中所述的条款使用。
适用于
RegisterNetworkCallback(NetworkRequest, PendingIntent)
注册一个 PendingIntent,以在满足给定 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
参数
- request
- NetworkRequest
NetworkRequest 描述此请求。
- operation
- PendingIntent
当网络可用时要执行的操作(对应于 NetworkCallback#onAvailable 调用。 通常来自 PendingIntent#getBroadcast。 不能为 null。
- 特性
注解
注册一个 PendingIntent,以在满足给定 NetworkRequest的网络可用时发送。
此函数的行为方式与采用 NetworkCallback 的版本相同,但不使用 NetworkCallbackPendingIntent NetworkCallback。 这意味着,当找到合适的网络时,请求可能会超出调用应用程序,并得到回叫。
该操作是一个意向广播,该广播将转到在 AndroidManifest.xml 文件中注册的Context#registerReceiver广播接收器或通过<接收方标记注册的广播接收器>
操作意向提供两个附加项,一个 Network 类型化的额外调用 #EXTRA_NETWORK ,另一个 NetworkRequest 类型化的额外调用 #EXTRA_NETWORK_REQUEST 包含原始请求参数。
如果已注册此意向的请求(与定义的 Intent#filterEquals两个意向相等),则会将其删除并替换为此意向,从而有效地释放了上 NetworkRequest一个意向。
可以通过调用 #unregisterNetworkCallback(android.app.PendingIntent)来正常释放请求。
为避免由于应用泄露回调而导致的性能问题,系统将每个应用(由 UID 标识)的未完成请求数限制为 100 个,与此方法的所有变体共享, #requestNetwork 以及 ConnectivityDiagnosticsManager#registerConnectivityDiagnosticsCallback。 使用此方法请求网络将计入此限制。 如果超出此限制,将引发异常。 若要避免遇到此问题并节省资源,请确保使用 #unregisterNetworkCallback(PendingIntent) 或 #releaseNetworkRequest(PendingIntent)取消注册回调。
本页的某些部分是根据 创建和共享的工作进行的修改,并根据 许可证中所述的条款使用。
适用于
RegisterNetworkCallback(NetworkRequest, ConnectivityManager+NetworkCallback)
注册以接收有关满足给定 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
参数
- request
- NetworkRequest
NetworkRequest 描述此请求。
- networkCallback
- ConnectivityManager.NetworkCallback
系统将 ConnectivityManager.NetworkCallback 作为适当的网络更改状态调用。
- 特性
注解
本页的某些部分是根据 创建和共享的工作进行的修改,并根据 许可证中所述的条款使用。