ConnectivityManager 類別

定義

命名空間:: Android.Net

組件:: Mono.Android.dll

重要

部分資訊涉及發行前產品，在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊，不做任何明確或隱含的瑕疵擔保。

用來回答有關網路連線狀態的詢問的類別。

[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

繼承: Object

JavaObject

Object
ConnectivityManager

屬性: RegisterAttribute

備註

用來回答有關網路連線狀態的詢問的類別。當網路連線發生變化時，它也會通知應用程式。

本類別的主要職責包括：<ol><li 監控>網路連線（Wi-Fi、GPRS、UMTS 等）</li>li 當網路連線改變<時傳送廣播意圖/li><li>在網路連接中斷<時嘗試「故障切換」至其他網路/li><li>提供一個 API，讓應用程式查詢可用網路<的粗粒度或細粒度狀態/li><li>提供一個 API，允許應用程式請求並選擇其資料流量<的網路/li></ol><>

Java 文件 android.net.ConnectivityManager。

本頁部分內容為基於 Open Source Project 所創建與分享的作品，並依授權條款所描述的使用進行修改。

建構函式

名稱	Description
ConnectivityManager(IntPtr, JniHandleOwnership)	用於建立 JNI 物件受管理表示的建構器;由執行時呼叫。

欄位

名稱	Description
ActionBackgroundDataSettingChanged	已淘汰. 廣播動作：背景資料使用設定已改變值。
ActionCaptivePortalSignIn	該裝置已連接到一個呈現自用入口的網路，該入口網站阻擋了網際網路連線。
ActionRestrictBackgroundChanged	背景計量網路活動限制發生了變更。
ConnectivityAction	網路連線發生了變化。
DefaultNetworkPreference	已淘汰. 如果你想設定預設的網路偏好設定，可以直接在 Framework 設定中更改 networkAttributes 陣列。
ExtraCaptivePortal	物件的查詢金鑰 `CaptivePortal` 隨意圖附帶 `#ACTION_CAPTIVE_PORTAL_SIGN_IN` 。
ExtraCaptivePortalUrl	傳遞 URL 給 captive portal 登入活動的鑰匙。
ExtraExtraInfo	查找字串的查詢鍵，提供可選性提供的網路狀態額外資訊。
ExtraIsFailover	查詢一個布林值的查詢鍵，表示連接事件是否屬於連接管理器在另一個網路斷線後故障轉移的網路。
ExtraNetwork	成功找到應用程式請求的網路後，物件的查詢金鑰 `Network` 隨意圖附贈。
ExtraNetworkInfo	已淘汰. 物件的查詢金鑰 `NetworkInfo` 。
ExtraNetworkRequest	成功找到應用程式請求的網路後，物件的查詢金鑰 `NetworkRequest` 隨意圖附贈。
ExtraNetworkType	網路類型觸發了 `#CONNECTIVITY_ACTION` 廣播。
ExtraNoConnectivity	對於一個布林值的查詢鍵，用來判斷是否完全缺乏連通性，i.
ExtraOtherNetworkInfo	物件的查詢金鑰 `NetworkInfo` 。
ExtraReason	查詢字串的查詢鍵，指示為何嘗試連接網路失敗的原因。
RestrictBackgroundStatusDisabled	已淘汰. 當應用程式在背景執行時，裝置並未限制計量網路活動。
RestrictBackgroundStatusEnabled	已淘汰. 裝置在應用程式背景執行時限制了計量網路活動。
RestrictBackgroundStatusWhitelisted	已淘汰. 裝置在應用程式背景執行時限制計量網路活動，但應用程式被允許繞過。

屬性

名稱	Description
ActiveNetwork	回傳 `Network` 對應當前啟用預設資料網路的物件。
ActiveNetworkInfo	回傳目前啟用的預設資料網路詳細資訊。
BackgroundDataSetting	已淘汰. 回傳背景資料使用設定的值。
BoundNetworkForProcess	回傳`Network`目前綁定於此程序的，`#bindProcessToNetwork`若 `null`，`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`目前綁定於此程序的，`#bindProcessToNetwork`若 `null`，`Network`則明確綁定。
RestrictBackgroundStatus	判斷呼叫應用程式在背景運行時是否受到計量網路限制。
ThresholdClass	此 API 支援 Mono for Android 基礎架構，並非直接從你的程式碼中使用。
ThresholdType	此 API 支援 Mono for Android 基礎架構，並非直接從你的程式碼中使用。

方法

名稱	Description
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)	用來回答有關網路連線狀態的詢問的類別。 (繼承來源 JavaObject)
Equals(Object)	表示是否有其他物體「等同」於此物。 (繼承來源 Object)
FromContext(Context)	用來回答有關網路連線狀態的詢問的類別。
GetAllNetworkInfo()	已淘汰. 回傳裝置支援的所有網路類型的連線狀態資訊。
GetAllNetworks()	回傳框架目前追蹤的所有 `Network` 資料陣列。
GetConnectionOwnerUid(Int32, InetSocketAddress, InetSocketAddress)	回傳網路連線擁有者的資訊 `uid` 。
GetHashCode()	回傳物件的雜湊碼值。 (繼承來源 Object)
GetLinkProperties(Network)	取得 `LinkProperties` 給定 `Network`的。
GetMultipathPreference(Network)	向呼叫應用程式提供提示，判斷是否適合使用多網路 API（例如：
GetNetworkCapabilities(Network)	取得 `NetworkCapabilities` 給定 `Network`的，或為零。
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)	註冊一個待定意圖，當網路可用且滿足給定 `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)	用來回答有關網路連線狀態的詢問的類別。
RequestNetwork(NetworkRequest, ConnectivityManager+NetworkCallback, Handler)	用來回答有關網路連線狀態的詢問的類別。
RequestNetwork(NetworkRequest, ConnectivityManager+NetworkCallback, Int32)	用來回答有關網路連線狀態的詢問的類別。
RequestNetwork(NetworkRequest, ConnectivityManager+NetworkCallback)	請求一個網路滿足一組 NetworkCapabilities。
RequestNetwork(NetworkRequest, PendingIntent)	請求一個網路滿足一組 `NetworkCapabilities`。
RequestRouteToHost(ConnectivityType, Int32)	已淘汰. 確保存在網路路由，透過指定的網路介面將流量傳送至指定主機。
RequestRouteToHostAsync(ConnectivityType, Int32)	用來回答有關網路連線狀態的詢問的類別。
ReserveNetwork(NetworkRequest, Handler, ConnectivityManager+NetworkCallback)	用來回答有關網路連線狀態的詢問的類別。
SetHandle(IntPtr, JniHandleOwnership)	設定 Handle 屬性。 (繼承來源 Object)
SetPeerReference(JniObjectReference, JniObjectReferenceOptions)	用來回答有關網路連線狀態的詢問的類別。 (繼承來源 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()	讓目前線程等候直到喚醒為止，通常是藉由em <notified/em>或<em>interrupted</em> 來喚醒它。<> (繼承來源 Object)
Wait(Int64, Int32)	讓目前的線程等到喚醒為止，通常是因為 <em>notified</em> 或 <em>interrupted</em>，或直到經過一定數量的實時為止。 (繼承來源 Object)
Wait(Int64)	讓目前的線程等到喚醒為止，通常是因為 <em>notified</em> 或 <em>interrupted</em>，或直到經過一定數量的實時為止。 (繼承來源 Object)

事件

名稱	Description
DefaultNetworkActive	當升起時 `DefaultNetworkActive` 發生。

明確介面實作

名稱	Description
IJavaPeerable.Disposed()	用來回答有關網路連線狀態的詢問的類別。 (繼承來源 JavaObject)
IJavaPeerable.Finalized()	用來回答有關網路連線狀態的詢問的類別。 (繼承來源 JavaObject)
IJavaPeerable.JniObjectReferenceControlBlock	用來回答有關網路連線狀態的詢問的類別。 (繼承來源 JavaObject)
IJavaPeerable.SetJniIdentityHashCode(Int32)	用來回答有關網路連線狀態的詢問的類別。 (繼承來源 JavaObject)
IJavaPeerable.SetJniManagedPeerState(JniManagedPeerStates)	用來回答有關網路連線狀態的詢問的類別。 (繼承來源 JavaObject)
IJavaPeerable.SetPeerReference(JniObjectReference)	用來回答有關網路連線狀態的詢問的類別。 (繼承來源 JavaObject)

擴充方法

名稱	Description
GetJniTypeName(IJavaPeerable)	取得實例 `self`類型的 JNI 名稱。
JavaAs<TResult>(IJavaPeerable)	試著強制`self`輸入 `TResult`，檢查強制在 Java 端是否有效。
JavaCast<TResult>(IJavaObject)	執行 Android 執行時檢查型別轉換。
JavaCast<TResult>(IJavaObject)	用來回答有關網路連線狀態的詢問的類別。
TryJavaCast<TResult>(IJavaPeerable, TResult)	試著強制`self`輸入 `TResult`，檢查強制在 Java 端是否有效。

適用於