Share via


DownloadManager 類別

定義

下載管理員是處理長時間執行 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
繼承
DownloadManager
屬性

備註

下載管理員是處理長時間執行 HTTP 下載的系統服務。 用戶端可能會要求將 URI 下載至特定目的地檔案。 下載管理員會在背景進行下載,負責 HTTP 互動,並在失敗或跨連線變更和系統重新開機之後重試下載。

透過此 API 要求下載的應用程式應該註冊廣播接收者 #ACTION_NOTIFICATION_CLICKED ,以在使用者按一下通知中的執行下載,或從下載 UI 中按一下執行中下載時適當處理。

請注意,應用程式必須具有 android.Manifest.permission#INTERNET 使用此類別的許可權。

android.app.DownloadManager JAVA 檔。

此頁面的部分是根據 原始碼專案所建立和共用的工作進行修改,並根據中所述的詞彙使用。

建構函式

DownloadManager(IntPtr, JniHandleOwnership)

建立 JNI 物件的 Managed 標記法時所使用的建構函式;由執行時間呼叫。

欄位

ActionDownloadComplete

下載管理員在下載完成時傳送的廣播意圖動作。

ActionNotificationClicked

當使用者從系統通知或下載 UI 按一下執行中的下載時,下載管理員所傳送的廣播意圖動作。

ActionViewDownloads

啟動活動以顯示所有下載的意圖動作。

ColumnBytesDownloadedSoFar

到目前為止下載的位元組數目。

ColumnDescription

此下載的用戶端提供的描述。

ColumnId

特定下載的識別碼,在整個系統中是唯一的。

ColumnLastModifiedTimestamp

上次修改下載時的時間戳記,以 UTC) (System#currentTimeMillis System.currentTimeMillis() 時鐘時間。

ColumnLocalFilename

磁片上下載之檔案的路徑。

ColumnLocalUri

將儲存下載的檔案的 URI。

ColumnMediaproviderUri

此下載專案的 MediaProvider 中對應專案的 URI。

ColumnMediaType

已下載檔案的網際網路媒體類型。

ColumnReason

提供有關下載狀態的詳細資料。

ColumnStatus

下載的目前狀態,做為其中一個STATUS_* 常數。

ColumnTitle

此下載的用戶端提供標題。

ColumnTotalSizeBytes

下載大小總計,以位元組為單位。

ColumnUri

要下載的 URI。

ErrorCannotResume
已淘汰.

#COLUMN_REASON當發生某些可能暫時性錯誤但無法繼續下載時的值。

ErrorDeviceNotFound
已淘汰.

#COLUMN_REASON找不到外部存放裝置時的 值。

ErrorFileAlreadyExists
已淘汰.

#COLUMN_REASON當要求的目的地檔案已經存在時的值, (下載管理員將不會覆寫現有的檔案) 。

ErrorFileError
已淘汰.

#COLUMN_REASON當儲存體問題發生時的值,不符合任何其他錯誤碼。

ErrorHttpDataError
已淘汰.

#COLUMN_REASON在 HTTP 層級發生錯誤接收或處理資料時的 值。

ErrorInsufficientSpace
已淘汰.

#COLUMN_REASON儲存空間不足時的 值。

ErrorTooManyRedirects
已淘汰.

#COLUMN_REASON當重新導向太多時的值。

ErrorUnhandledHttpCode
已淘汰.

#COLUMN_REASON收到下載管理員無法處理的 HTTP 程式碼時的值。

ErrorUnknown
已淘汰.

當下載完成且不符合任何其他錯誤碼的錯誤時,COLUMN_ERROR_CODE的值。

ExtraDownloadId

意圖隨附于 #ACTION_DOWNLOAD_COMPLETE 意圖中,表示識別碼 (為剛完成之下載的長時間) 。

ExtraNotificationClickDownloadIds

收到多個通知的點擊時,下列提供對應至已按一下之下載通知的下載識別碼陣列。

IntentExtrasSortBySize

在依大小排序模式中啟動 DownloadApp 時所 #ACTION_VIEW_DOWNLOADS 隨附的意圖。

PausedQueuedForWifi
已淘汰.

#COLUMN_REASON當下載超過透過行動網路下載的大小限制,且下載管理員正在等候 Wi-Fi 連線繼續時的值。

PausedUnknown
已淘汰.

#COLUMN_REASON因為其他原因而暫停下載時的 值。

PausedWaitingForNetwork
已淘汰.

#COLUMN_REASON當下載正在等候網路連線繼續時的值。

PausedWaitingToRetry
已淘汰.

#COLUMN_REASON當下載暫停時的值,因為發生某些網路錯誤,且下載管理員在重試要求之前正在等候。

StatusFailed
已淘汰.

#COLUMN_STATUS下載失敗 (且不會) 重試時的 值。

StatusPaused
已淘汰.

#COLUMN_STATUS下載等候重試或繼續時的 值。

StatusPending
已淘汰.

#COLUMN_STATUS下載等候啟動時的 值。

StatusRunning
已淘汰.

#COLUMN_STATUS下載目前正在執行時的 值。

StatusSuccessful
已淘汰.

#COLUMN_STATUS下載成功完成時的 值。

屬性

Class

傳回這個 Object 的執行時間類別。

(繼承來源 Object)
Handle

基礎 Android 實例的控制碼。

(繼承來源 Object)
JniIdentityHashCode

下載管理員是處理長時間執行 HTTP 下載的系統服務。

(繼承來源 Object)
JniPeerMembers

下載管理員是處理長時間執行 HTTP 下載的系統服務。

PeerReference

下載管理員是處理長時間執行 HTTP 下載的系統服務。

(繼承來源 Object)
ThresholdClass

此 API 支援 Mono for Android 基礎結構,並不適合直接從您的程式碼使用。

ThresholdType

此 API 支援 Mono for Android 基礎結構,並不適合直接從您的程式碼使用。

方法

AddCompletedDownload(String, String, Boolean, String, String, Int64, Boolean)

將檔案新增至下載資料庫系統,使其可能會出現在下載應用程式 (中,因此符合下載應用程式) 的管理資格。

AddCompletedDownload(String, String, Boolean, String, String, Int64, Boolean, Uri, Uri)

將檔案新增至下載資料庫系統,使其可能會出現在下載應用程式 (中,因此符合下載應用程式) 的管理資格。

Clone()

建立並傳回這個 物件的複本。

(繼承來源 Object)
Dispose()

下載管理員是處理長時間執行 HTTP 下載的系統服務。

(繼承來源 Object)
Dispose(Boolean)

下載管理員是處理長時間執行 HTTP 下載的系統服務。

(繼承來源 Object)
Enqueue(DownloadManager+Request)

加入新下載佇列。

Equals(Object)

指出其他物件是否「等於」這個物件。

(繼承來源 Object)
FromContext(Context)

下載管理員是處理長時間執行 HTTP 下載的系統服務。

GetHashCode()

傳回此物件的雜湊碼值。

(繼承來源 Object)
GetMaxBytesOverMobile(Context)

傳回可能經過行動連線的下載大小上限,以位元組為單位;如果沒有限制,則為 null

GetMimeTypeForDownloadedFile(Int64)

如果已成功下載檔案,則傳回指定下載之檔案識別碼的媒體類型。

GetRecommendedMaxBytesOverMobile(Context)

傳回可能經過行動連線之下載的建議大小上限,以位元組為單位;如果沒有建議的限制,則為 null。

GetUriForDownloadedFile(Int64)

如果已成功下載檔案,則傳 Uri 回指定下載之檔案識別碼的 。

InvokeQuery(DownloadManager+Query)

查詢下載管理員,以瞭解已要求的下載。

JavaFinalize()

當垃圾收集判斷物件沒有其他參考時,由物件上的垃圾收集行程呼叫。

(繼承來源 Object)
Notify()

喚醒正在等候此物件的監視器的單一線程。

(繼承來源 Object)
NotifyAll()

喚醒正在等候此物件監視器的所有線程。

(繼承來源 Object)
OpenDownloadedFile(Int64)

開啟下載的檔案以供讀取。

Remove(Int64[])

取消下載,並從下載管理員中移除它們。

SetHandle(IntPtr, JniHandleOwnership)

設定 Handle 屬性。

(繼承來源 Object)
ToArray<T>()

下載管理員是處理長時間執行 HTTP 下載的系統服務。

(繼承來源 Object)
ToString()

傳回物件的字串表示。

(繼承來源 Object)
UnregisterFromRuntime()

下載管理員是處理長時間執行 HTTP 下載的系統服務。

(繼承來源 Object)
Wait()

讓目前的執行緒等到喚醒為止,通常是藉由 < em > notified < /em > 或 < em > interrupted < /em > 來喚醒。

(繼承來源 Object)
Wait(Int64)

讓目前的執行緒等到喚醒為止,通常是 < 透過 em > notified < /em 或 em > interrupted < /em >> ,或 < 直到經過一定數量的即時為止。

(繼承來源 Object)
Wait(Int64, Int32)

讓目前的執行緒等到喚醒為止,通常是 < 透過 em > notified < /em 或 em > interrupted < /em >> ,或 < 直到經過一定數量的即時為止。

(繼承來源 Object)

明確介面實作

IJavaPeerable.Disposed()

下載管理員是處理長時間執行 HTTP 下載的系統服務。

(繼承來源 Object)
IJavaPeerable.DisposeUnlessReferenced()

下載管理員是處理長時間執行 HTTP 下載的系統服務。

(繼承來源 Object)
IJavaPeerable.Finalized()

下載管理員是處理長時間執行 HTTP 下載的系統服務。

(繼承來源 Object)
IJavaPeerable.JniManagedPeerState

下載管理員是處理長時間執行 HTTP 下載的系統服務。

(繼承來源 Object)
IJavaPeerable.SetJniIdentityHashCode(Int32)

下載管理員是處理長時間執行 HTTP 下載的系統服務。

(繼承來源 Object)
IJavaPeerable.SetJniManagedPeerState(JniManagedPeerStates)

下載管理員是處理長時間執行 HTTP 下載的系統服務。

(繼承來源 Object)
IJavaPeerable.SetPeerReference(JniObjectReference)

下載管理員是處理長時間執行 HTTP 下載的系統服務。

(繼承來源 Object)

擴充方法

JavaCast<TResult>(IJavaObject)

執行 Android 執行時間檢查的類型轉換。

JavaCast<TResult>(IJavaObject)

下載管理員是處理長時間執行 HTTP 下載的系統服務。

GetJniTypeName(IJavaPeerable)

下載管理員是處理長時間執行 HTTP 下載的系統服務。

適用於