语言

ConnectivityManager 类

定义

用于回答有关网络连接状态的查询的类。

[Android.Runtime.Register("android/net/ConnectivityManager", DoNotGenerateAcw=true)]
public class ConnectivityManager : Java.Lang.Object
[<Android.Runtime.Register("android/net/ConnectivityManager", DoNotGenerateAcw=true)>]
type ConnectivityManager = class
    inherit Object
继承
ConnectivityManager
特性

注解

用于回答有关网络连接状态的查询的类。 它还会在网络连接发生更改时通知应用程序。

此类的主要职责是:<ol><li>Monitor 网络连接(Wi-Fi、GPRS、UMTS 等)</li>li send broadcast intents when network connectivity changes</li><li>Attempt to “fail over over” to another network when connectivity is lost</li><>li Provide an API that that applications to query the粗粒度或精细状态 of the available networks</li><li>Provide an API that allows applications to request and select networks for their data traffic</li></ol><>

Java文档android.net.ConnectivityManager。

本页的某些部分是根据 创建和共享的工作进行的修改,并根据 许可证中所述的条款使用。

构造函数

名称 说明
ConnectivityManager(IntPtr, JniHandleOwnership)

创建 JNI 对象的托管表示形式时使用的构造函数;由运行时调用。

字段

名称 说明
ActionBackgroundDataSettingChanged
已过时.

广播操作:后台数据使用情况的设置已更改值。

ActionCaptivePortalSignIn

设备已连接到已呈现强制网络门户的网络,该门户正在阻止 Internet 连接。

ActionRestrictBackgroundChanged

后台按流量计费的网络活动限制发生了更改。

ConnectivityAction

网络连接发生了更改。

DefaultNetworkPreference
已过时.

如果要设置默认网络首选项,可以直接更改框架 config.xml中的 networkAttributes 数组。

ExtraCaptivePortal

意向中包含的CaptivePortal对象的查找键#ACTION_CAPTIVE_PORTAL_SIGN_IN。

ExtraCaptivePortalUrl

用于将 URL 传递给强制门户登录活动的密钥。

ExtraExtraInfo

字符串的查找键,该字符串提供有关网络状态的额外信息(可选)。

ExtraIsFailover

布尔值的查找键,指示连接事件是否适用于连接管理器在另一个网络上断开连接后故障转移到的网络。

ExtraNetwork

成功找到应用程序请求的网络后,意向中包含的对象的查找键 Network 。

ExtraNetworkInfo
已过时.

对象的查找键 NetworkInfo 。

ExtraNetworkRequest

成功找到应用程序请求的网络后,意向中包含的对象的查找键 NetworkRequest 。

ExtraNetworkType

触发 #CONNECTIVITY_ACTION 广播的网络类型。

ExtraNoConnectivity

布尔值的查找键,指示是否完全缺少连接,即没有可用的网络。

ExtraOtherNetworkInfo

对象的查找键 NetworkInfo 。

ExtraReason

字符串的查找键,指示尝试连接到网络失败的原因。

RestrictBackgroundStatusDisabled
已过时.

当应用程序在后台运行时,设备不会限制按流量计费的网络活动。

RestrictBackgroundStatusEnabled
已过时.

当应用程序在后台运行时,设备正在限制按流量计费的网络活动。

RestrictBackgroundStatusWhitelisted
已过时.

设备在后台运行应用程序时限制按流量计费的网络活动,但允许应用程序绕过它。

属性

名称 说明
ActiveNetwork

返回与 Network 当前活动的默认数据网络对应的对象。

ActiveNetworkInfo

返回有关当前活动的默认数据网络的详细信息。

BackgroundDataSetting
已过时.

返回后台数据使用情况设置的值。

BoundNetworkForProcess

返回Network当前通过#bindProcessToNetworknull或未Network显式绑定的此进程。

Class

返回此 Object的运行时类。

(继承自 Object)
DefaultProxy

获取当前的默认 HTTP 代理设置。

Handle

基础 Android 实例的句柄。

(继承自 Object)
IsActiveNetworkMetered

返回当前活动数据网络是否按流量计费。

IsDefaultNetworkActive

返回数据网络当前是否处于活动状态。

JniIdentityHashCode

获取互操作运行时分配给此Java对等的标识哈希代码。

(继承自 Object)
JniManagedPeerState

获取运行时上次分配的状态标志。

(继承自 JavaObject)
JniPeerMembers

此 API 支持 Mono for Android 基础结构,不打算直接从代码使用。

NetworkPreference
已过时.

检索当前的首选网络类型。 - 或 - 指定首选网络类型。

PeerReference

获取此Java对等方的 JNI 对象引用。

(继承自 Object)
ProcessDefaultNetwork
已过时.

返回Network当前通过#bindProcessToNetworknull或未Network显式绑定的此进程。

RestrictBackgroundStatus

确定调用应用程序在后台运行时是否受到按流量计费的网络限制。

ThresholdClass

此 API 支持 Mono for Android 基础结构,不打算直接从代码使用。

ThresholdType

此 API 支持 Mono for Android 基础结构,不打算直接从代码使用。

方法

名称 说明
AddDefaultNetworkActiveListener(ConnectivityManager+IOnNetworkActiveListener)

在系统的默认数据网络处于活动状态时开始侦听报告,这意味着执行网络流量是一个很好的时机。

BindProcessToNetwork(Network)

将当前进程 network绑定到 。

Clone()

创建并返回此对象的副本。

(继承自 Object)
Construct(JniObjectReference, JniObjectReferenceOptions)

将此对等方的构造委托给运行时的值管理器。

(继承自 JavaObject)
CreateSocketKeepalive(Network, IpSecManager+UdpEncapsulationSocket, InetAddress, InetAddress, IExecutor, SocketKeepalive+Callback)

创建套接字保留。

Dispose()

释放此Java对等方持有的资源。

(继承自 Object)
Dispose(Boolean)

释放此Java对等方持有的资源。

(继承自 Object)
DisposeUnlessReferenced()

要求值管理器释放此对等方,除非其映射保留此相同的托管实例。

(继承自 JavaObject)
Equals(Object)

测试另一个托管对等方是否引用同一Java对象。

(继承自 JavaObject)
Equals(Object)

指示其他对象是否“等于”此对象。

(继承自 Object)
FromContext(Context)

从上下文中获取连接系统服务。

GetAllNetworkInfo()
已过时.

返回有关设备支持的所有网络类型的连接状态信息。

GetAllNetworks()

返回框架当前跟踪的所有 Network 数组。

GetConnectionOwnerUid(Int32, InetSocketAddress, InetSocketAddress)

返回 uid 网络连接的所有者。

GetHashCode()

返回对象的哈希代码值。

(继承自 Object)
GetLinkProperties(Network)

LinkProperties获取给定Network的 。

GetMultipathPreference(Network)

向调用应用程序提供一个提示,说明当多网络不是系统默认网络时,是否要使用多网络 API(例如Network#openConnectionNetwork#bindSocket,等)进行多路径数据传输。

GetNetworkCapabilities(Network)

获取 NetworkCapabilities 给定 Network的或 null。

GetNetworkInfo(ConnectivityType)
已过时.

返回有关特定网络类型的连接状态信息。

GetNetworkInfo(Network)

返回有关特定网络的连接状态信息。

GetNetworkWatchlistConfigHash()

网络监视列表是与潜在有害应用关联的域和 IP 地址的列表。

IsNetworkTypeValid(ConnectivityType)
已过时.

测试给定整数是否表示有效的网络类型。

JavaFinalize()
已过时.

当垃圾回收确定不再引用该对象时,由对象上的垃圾回收器调用。

(继承自 Object)
Notify()

唤醒正在等待此对象的监视器的单个线程。

(继承自 Object)
NotifyAll()

唤醒正在等待此对象的监视器的所有线程。

(继承自 Object)
RegisterBestMatchingNetworkCallback(NetworkRequest, ConnectivityManager+NetworkCallback, Handler)

注册指定的最佳匹配网络回调。

RegisterDefaultNetworkCallback(ConnectivityManager+NetworkCallback, Handler)

注册指定的默认网络回调。

RegisterDefaultNetworkCallback(ConnectivityManager+NetworkCallback)

注册指定的默认网络回调。

RegisterNetworkCallback(NetworkRequest, ConnectivityManager+NetworkCallback, Handler)

注册指定的网络回调。

RegisterNetworkCallback(NetworkRequest, ConnectivityManager+NetworkCallback)

注册以接收有关满足给定 NetworkRequest网络的所有网络的通知。

RegisterNetworkCallback(NetworkRequest, PendingIntent)

注册一个 PendingIntent,以在满足给定 NetworkRequest的网络可用时发送。

ReleaseNetworkRequest(PendingIntent)

删除通过 #requestNetwork(NetworkRequest, android.app.PendingIntent)

RemoveDefaultNetworkActiveListener(ConnectivityManager+IOnNetworkActiveListener)

删除以前向 M:Android.Net.ConnectivityManager.AddDefaultNetworkActiveListener(.IOnNetworkActiveListener。

ReportBadNetwork(Network)
已过时.

向框架报告问题网络。

ReportNetworkConnectivity(Network, Boolean)

向框架报告网络是否具有工作连接。

RequestBandwidthUpdate(Network)

请求给定 Network 的带宽更新,并返回 ConnectivityService 是否接受更新请求。

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

请求网络以满足一组 NetworkCapabilities,受超时限制。

RequestNetwork(NetworkRequest, ConnectivityManager+NetworkCallback, Handler)

请求网络以满足一组 NetworkCapabilities。

RequestNetwork(NetworkRequest, ConnectivityManager+NetworkCallback, Int32)

请求网络以满足一组 NetworkCapabilities,受超时限制。

RequestNetwork(NetworkRequest, ConnectivityManager+NetworkCallback)

请求一个网络来满足一组 NetworkCapabilities。

RequestNetwork(NetworkRequest, PendingIntent)

请求一个网络来满足一组 NetworkCapabilities。

RequestRouteToHost(ConnectivityType, Int32)
已过时.

确保存在网络路由,以便通过指定的网络接口将流量传送到指定主机。

RequestRouteToHostAsync(ConnectivityType, Int32)

在线程池线程上运行旧主机路由请求。

ReserveNetwork(NetworkRequest, Handler, ConnectivityManager+NetworkCallback)

保留一个网络以满足一组 NetworkCapabilities。

SetHandle(IntPtr, JniHandleOwnership)

设置 Handle 属性。

(继承自 Object)
SetPeerReference(JniObjectReference, JniObjectReferenceOptions)

在不创建 JNI 引用副本的情况下,将引用值存储在控制块中。

(继承自 JavaObject)
SetProcessDefaultNetwork(Network)
已过时.

将当前进程 network绑定到 。

StartUsingNetworkFeature(ConnectivityType, String)
已过时.

告知基础网络系统,调用方希望开始使用命名功能。

StopUsingNetworkFeature(ConnectivityType, String)
已过时.

告知基础网络系统调用方使用命名功能完成。

ToArray<T>()

从此Java数组包装器创建托管数组。

(继承自 Object)
ToString()

返回对象的字符串表示形式。

(继承自 Object)
UnregisterFromRuntime()

从互操作运行时取消注册此Java对等。

(继承自 Object)
UnregisterNetworkCallback(ConnectivityManager+NetworkCallback)

取消注册来自和调用的网络 RequestNetwork(NetworkRequest, ConnectivityManager+NetworkCallback) 的回调, RegisterNetworkCallback(NetworkRequest, PendingIntent) 并可能释放网络。

UnregisterNetworkCallback(PendingIntent)

取消注册以前通过 #registerNetworkCallback(NetworkRequest, android.app.PendingIntent). 注册的回调。

Wait()

导致当前线程等待,直到它被唤醒,通常是通过 通知 或 中断。

(继承自 Object)
Wait(Int64, Int32)

使当前线程等待直到唤醒,通常是通过 通知 或 中断,或直到经过一定数量的实时。

(继承自 Object)
Wait(Int64)

使当前线程等待直到唤醒,通常是通过 通知 或 中断,或直到经过一定数量的实时。

(继承自 Object)

事件

名称 说明
DefaultNetworkActive

在默认数据网络处于活动状态时发生。

显式接口实现

名称 说明
IJavaPeerable.Disposed()

将此对等方标记为已释放,并将disposing调用Dispose设置为 true.

(继承自 JavaObject)
IJavaPeerable.Finalized()

将此对等方标记为已释放,并将disposing调用Dispose设置为 false.

(继承自 JavaObject)
IJavaPeerable.JniObjectReferenceControlBlock

获取此对等方使用的本机控制块指针。

(继承自 JavaObject)
IJavaPeerable.SetJniIdentityHashCode(Int32)

存储运行时提供的标识哈希代码。

(继承自 JavaObject)
IJavaPeerable.SetJniManagedPeerState(JniManagedPeerStates)

替换存储的托管对等状态标志。

(继承自 JavaObject)
IJavaPeerable.SetPeerReference(JniObjectReference)

更新对等引用,并在引用无效时释放已释放的对等方控制块。

(继承自 JavaObject)

扩展方法

名称 说明
GetJniTypeName(IJavaPeerable)

获取实例 self类型的 JNI 名称。

JavaAs<TResult>(IJavaPeerable)

尝试强制self键入TResult,检查强制是否在Java端有效。

JavaCast<TResult>(IJavaObject)

执行 Android 运行时检查的类型转换。

JavaCast<TResult>(IJavaObject)

重复使用兼容的托管对等,或获取请求类型的包装器。

TryJavaCast<TResult>(IJavaPeerable, TResult)

尝试强制self键入TResult,检查强制是否在Java端有效。

适用于