DownloadManager 類別
定義
重要
部分資訊涉及發行前產品，在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊，不做任何明確或隱含的瑕疵擔保。
下載管理器是一種系統服務，負責處理長時間執行的 HTTP 下載。
[Android.Runtime.Register("android/app/DownloadManager", DoNotGenerateAcw=true)]
public class DownloadManager : Java.Lang.Object[<Android.Runtime.Register("android/app/DownloadManager", DoNotGenerateAcw=true)>]
type DownloadManager = class
inherit Object- 繼承
- 屬性
備註
下載管理器是一種系統服務，負責處理長時間執行的 HTTP 下載。 用戶端可要求將 URI 下載至特定目的檔案。 下載管理器會在背景執行下載，負責 HTTP 互動並在失敗後、連線變更與系統重啟後重新嘗試下載。 透過此 API 請求下載的應用程式，應註冊一個廣播接收器，以便ACTION_NOTIFICATION_CLICKED在使用者點擊正在下載的通知或下載介面時適當處理。 請注意，應用程式必須擁有 Manifest.permission.INTERNET 權限才能使用此類別。
Android 參考資料。android.app.DownloadManager
本頁部分內容為基於 Open Source Project 所創建與分享的作品，並依授權條款所描述的使用進行修改。
建構函式
| 名稱 | Description |
|---|---|
| DownloadManager(IntPtr, JniHandleOwnership) |
初始化現有 Java 原生介面物件的受管理表示。 |
欄位
| 名稱 | Description |
|---|---|
| ActionDownloadComplete |
下載管理器在下載完成時會發送廣播意圖動作。 |
| ActionNotificationClicked |
當使用者點擊正在進行的下載時，下載管理員會發送廣播意圖動作，無論是從系統通知還是下載介面。 |
| ActionViewDownloads |
意圖動作啟動活動以顯示所有下載。 |
| ColumnBytesDownloadedSoFar |
目前下載的位元組數量。 |
| ColumnDescription |
客戶提供的此下載說明。 |
| ColumnId |
一個特定下載的識別碼，系統中唯一。 |
| ColumnLastModifiedTimestamp |
下載最後修改的時間戳記，時間為 |
| ColumnLocalFilename |
已淘汰.
下載後的磁碟路徑。 |
| ColumnLocalUri |
下載 Uri 會存放在下載檔案的位置。 |
| ColumnMediaproviderUri |
將 URI 連結至本下載條目中 MediaProvider 對應的條目。 |
| ColumnMediaType |
下載檔案的網路媒體類型。 |
| ColumnReason |
提供更多下載狀態的詳細資訊。 |
| ColumnStatus |
下載目前狀態，作為STATUS_*常數之一。 |
| ColumnTitle |
本次下載的標題由客戶提供。 |
| ColumnTotalSizeBytes |
下載總大小以位元組為單位。 |
| ColumnUri |
URI 將會下載。 |
| ErrorCannotResume |
已淘汰.
值是 |
| ErrorDeviceNotFound |
已淘汰.
當沒有發現外部儲存裝置時的 |
| ErrorFileAlreadyExists |
已淘汰.
請求的目標檔案已經存在時的 |
| ErrorFileError |
已淘汰.
當儲存問題發生時的價值 |
| ErrorHttpDataError |
已淘汰.
在 |
| ErrorInsufficientSpace |
已淘汰.
當儲存空間不足時的價值 |
| ErrorTooManyRedirects |
已淘汰.
當重定向太多時的 |
| ErrorUnhandledHttpCode |
已淘汰.
|
| ErrorUnknown |
已淘汰.
當下載完成時出現不符合其他錯誤代碼的錯誤，COLUMN_ERROR_CODE值。 |
| ExtraDownloadId |
意圖附加條款包含 |
| ExtraNotificationClickDownloadIds |
當收到多個通知點擊時，以下會提供一組對應點擊的下載通知的下載ID。 |
| IntentExtrasSortBySize |
|
| PausedQueuedForWifi |
已淘汰.
當下載超過行動網路下載大小限制，且下載管理員正在等待 Wi-Fi 連線繼續時，該值為值 |
| PausedUnknown |
已淘汰.
下載暫停的時間值 |
| PausedWaitingForNetwork |
已淘汰.
下載等待網路連線進行時的 |
| PausedWaitingToRetry |
已淘汰.
值是 |
| StatusFailed |
已淘汰.
下載失敗（且不會再嘗試）的數值 |
| StatusPaused |
已淘汰.
下載等待重試或繼續的時間值 |
| StatusPending |
已淘汰.
|
| StatusRunning |
已淘汰.
下載目前正在執行的時間值 |
| StatusSuccessful |
已淘汰.
下載成功完成時的 |
屬性
| 名稱 | Description |
|---|---|
| Class |
回傳此 |
| Handle |
底層 Android 實例的帳號。 (繼承來源 Object) |
| JniIdentityHashCode |
取得由互通執行時指派給此 Java 對等端的身份雜湊碼。 (繼承來源 Object) |
| JniManagedPeerState |
下載管理器是一種系統服務，負責處理長時間執行的 HTTP 下載。 (繼承來源 JavaObject) |
| JniPeerMembers |
提供 Android.App.DownloadManager 的 JNI 綁定基礎架構。 |
| PeerReference |
取得這個 Java 節點的 JNI 物件參考。 (繼承來源 Object) |
| ThresholdClass |
提供 Android.App.DownloadManager 的 JNI 綁定基礎架構。 |
| ThresholdType |
提供 Android.App.DownloadManager 的 JNI 綁定基礎架構。 |
方法
| 名稱 | Description |
|---|---|
| AddCompletedDownload(String, String, Boolean, String, String, Int64, Boolean, Uri, Uri) |
將檔案加入下載資料庫系統，使其能出現在下載應用程式中（從而有資格由下載應用程式管理）。 |
| AddCompletedDownload(String, String, Boolean, String, String, Int64, Boolean) |
將檔案加入下載資料庫系統，使其能出現在下載應用程式中（從而有資格由下載應用程式管理）。 |
| Clone() |
建立並回傳此物件的副本。 (繼承來源 Object) |
| Construct(JniObjectReference, JniObjectReferenceOptions) |
下載管理器是一種系統服務，負責處理長時間執行的 HTTP 下載。 (繼承來源 JavaObject) |
| Dispose() |
釋放該 Java 節點所持有的資源。 (繼承來源 Object) |
| Dispose(Boolean) |
釋放該 Java 節點所持有的資源。 (繼承來源 Object) |
| DisposeUnlessReferenced() |
下載管理器是一種系統服務，負責處理長時間執行的 HTTP 下載。 (繼承來源 JavaObject) |
| Enqueue(DownloadManager+Request) |
排隊進行新的下載。 |
| Equals(Object) |
下載管理器是一種系統服務，負責處理長時間執行的 HTTP 下載。 (繼承來源 JavaObject) |
| Equals(Object) |
表示是否有其他物體「等同」於此物。 (繼承來源 Object) |
| FromContext(Context) | |
| GetHashCode() |
回傳物件的雜湊碼值。 (繼承來源 Object) |
| GetMaxBytesOverMobile(Context) |
回傳可透過行動連線的最大下載大小（位元組）;若無限制則為零 |
| GetMimeTypeForDownloadedFile(Int64) |
如果檔案成功下載，會回傳所下載檔案 ID 的媒體類型。 |
| GetRecommendedMaxBytesOverMobile(Context) |
回傳可透過行動網路傳輸的下載最大大小（位元組）;如果沒有推薦的上限，則是無效。 |
| GetUriForDownloadedFile(Int64) |
若檔案成功下載，則回傳 |
| InvokeQuery(DownloadManager+Query) |
查詢下載管理員中已申請的下載資料。 |
| JavaFinalize() |
已淘汰.
當垃圾回收判定該物件不再有相關參考時，由垃圾回收器呼叫。 (繼承來源 Object) |
| Notify() |
喚醒一個正在該物件監視器上等待的執行緒。 (繼承來源 Object) |
| NotifyAll() |
喚醒所有等待該物件監視器的執行緒。 (繼承來源 Object) |
| OpenDownloadedFile(Int64) |
打開下載的檔案閱讀。 |
| Remove(Int64[]) |
取消下載並從下載管理員中移除。 |
| SetHandle(IntPtr, JniHandleOwnership) |
設定 Handle 屬性。 (繼承來源 Object) |
| SetPeerReference(JniObjectReference, JniObjectReferenceOptions) |
下載管理器是一種系統服務，負責處理長時間執行的 HTTP 下載。 (繼承來源 JavaObject) |
| ToArray<T>() |
從這個 Java 陣列包裝器建立一個受管理陣列。 (繼承來源 Object) |
| ToString() |
回傳物件的字串表示。 (繼承來源 Object) |
| UnregisterFromRuntime() |
將此 Java 節點從互通執行時中取消註冊。 (繼承來源 Object) |
| Wait() |
導致目前執行緒等待被喚醒，通常是透過 <em>通知</><em 或 em>中斷</em> 來喚醒。 (繼承來源 Object) |
| Wait(Int64, Int32) |
會讓目前執行緒等待喚醒，通常是透過 <em>通知</><em 或 em>中斷</em>，或是經過一定的真實時間。 (繼承來源 Object) |
| Wait(Int64) |
會讓目前執行緒等待喚醒，通常是透過 <em>通知</><em 或 em>中斷</em>，或是經過一定的真實時間。 (繼承來源 Object) |
明確介面實作
| 名稱 | Description |
|---|---|
| IJavaPeerable.Disposed() |
下載管理器是一種系統服務，負責處理長時間執行的 HTTP 下載。 (繼承來源 JavaObject) |
| IJavaPeerable.Finalized() |
下載管理器是一種系統服務，負責處理長時間執行的 HTTP 下載。 (繼承來源 JavaObject) |
| IJavaPeerable.JniObjectReferenceControlBlock |
下載管理器是一種系統服務，負責處理長時間執行的 HTTP 下載。 (繼承來源 JavaObject) |
| IJavaPeerable.SetJniIdentityHashCode(Int32) |
下載管理器是一種系統服務，負責處理長時間執行的 HTTP 下載。 (繼承來源 JavaObject) |
| IJavaPeerable.SetJniManagedPeerState(JniManagedPeerStates) |
下載管理器是一種系統服務，負責處理長時間執行的 HTTP 下載。 (繼承來源 JavaObject) |
| IJavaPeerable.SetPeerReference(JniObjectReference) |
下載管理器是一種系統服務，負責處理長時間執行的 HTTP 下載。 (繼承來源 JavaObject) |
擴充方法
| 名稱 | Description |
|---|---|
| GetJniTypeName(IJavaPeerable) |
取得實例 |
| JavaAs<TResult>(IJavaPeerable) |
試著強制 |
| JavaCast<TResult>(IJavaObject) |
執行 Android 執行時檢查型別轉換。 |
| JavaCast<TResult>(IJavaObject) |
下載管理器是一種系統服務，負責處理長時間執行的 HTTP 下載。 |
| TryJavaCast<TResult>(IJavaPeerable, TResult) |
試著強制 |