FileManager 類別
定義
重要
部分資訊涉及發行前產品，在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊，不做任何明確或隱含的瑕疵擔保。
系統服務管理器，用於處理特權且長時間執行的檔案操作。
[Android.Runtime.Register("android/os/storage/FileManager", ApiSince=37, DoNotGenerateAcw=true)]
public sealed class FileManager : Java.Lang.Object[<Android.Runtime.Register("android/os/storage/FileManager", ApiSince=37, DoNotGenerateAcw=true)>]
type FileManager = class
inherit Object- 繼承
- 屬性
備註
系統服務管理器，用於處理特權且長時間執行的檔案操作。
FileManager 提供一個 API，讓應用程式可以請求非同步的檔案操作，例如移動或複製檔案。 這些操作由系統服務（「FileService」）在背景執行緒中執行，以確保應用程式的響應性與系統穩定性。 使用概述
與檔案操作服務互動通常包含三個步驟：排隊請求：使用 enqueueOperation（FileOperationRequest） 提交新操作。 此方法會立即回傳一個 FileOperationEnqueueResult，若成功則包含唯一的請求 ID，若系統忙碌則包含錯誤代碼;進度追蹤（可選）：應用程式可使用 fetchResult（String） 輪詢操作的當前狀態，或僅等待完成;處理完成：若操作完成（成功或失敗）時，要接收通知，呼叫 registerCompletionListener（String）。 當操作進入終端狀態時，系統會向你的包裹發送廣播ACTION_FILE_OPERATION_COMPLETED。 並行與限制
系統對同時進行的作業數量設有限制，以防止資源耗盡。 若系統負載過重，enqueueOperation（FileOperationRequest）可能會回傳錯誤代碼FileOperationResult.ERROR_BUSY。 應用程式應能優雅處理此情況，甚至可能稍後重試。
Android 參考資料。android.os.storage.FileManager
本頁部分內容為基於 Open Source Project 所創建與分享的作品，並依授權條款所描述的使用進行修改。
欄位
| 名稱 | Description |
|---|---|
| ActionFileOperationCompleted |
廣播動作：當檔案操作完成時傳送。 |
| ExtraRequestId |
額外內容： |
| ExtraResult |
額外 對 |
屬性
| 名稱 | Description |
|---|---|
| Class |
回傳此 |
| Handle |
底層 Android 實例的帳號。 (繼承來源 Object) |
| JniIdentityHashCode |
取得由互通執行時指派給此 Java 對等端的身份雜湊碼。 (繼承來源 Object) |
| JniManagedPeerState |
系統服務管理器，用於處理特權且長時間執行的檔案操作。 (繼承來源 JavaObject) |
| JniPeerMembers |
系統服務管理器，用於處理特權且長時間執行的檔案操作。 |
| MaxReportedFailures |
由於綁定器交易的限制，報告的失敗次數僅限於此方法回傳的次數。 |
| PeerReference |
取得這個 Java 節點的 JNI 物件參考。 (繼承來源 Object) |
| ThresholdClass |
此 API 支援 Mono for Android 基礎架構，並非直接從你的程式碼中使用。 (繼承來源 Object) |
| ThresholdType |
此 API 支援 Mono for Android 基礎架構，並非直接從你的程式碼中使用。 (繼承來源 Object) |
方法
| 名稱 | Description |
|---|---|
| Clone() |
建立並回傳此物件的副本。 (繼承來源 Object) |
| Construct(JniObjectReference, JniObjectReferenceOptions) |
系統服務管理器，用於處理特權且長時間執行的檔案操作。 (繼承來源 JavaObject) |
| Dispose() |
釋放該 Java 節點所持有的資源。 (繼承來源 Object) |
| Dispose(Boolean) |
釋放該 Java 節點所持有的資源。 (繼承來源 Object) |
| DisposeUnlessReferenced() |
系統服務管理器，用於處理特權且長時間執行的檔案操作。 (繼承來源 JavaObject) |
| EnqueueOperation(FileOperationRequest) |
排隊一個新的檔案操作請求。 |
| Equals(Object) |
系統服務管理器，用於處理特權且長時間執行的檔案操作。 (繼承來源 JavaObject) |
| Equals(Object) |
表示是否有其他物體「等同」於此物。 (繼承來源 Object) |
| FetchResult(String) |
取得檔案操作的當前結果。 |
| GetHashCode() |
回傳物件的雜湊碼值。 (繼承來源 Object) |
| JavaFinalize() |
已淘汰.
當垃圾回收判定該物件不再有相關參考時，由垃圾回收器呼叫。 (繼承來源 Object) |
| Notify() |
喚醒一個正在該物件監視器上等待的執行緒。 (繼承來源 Object) |
| NotifyAll() |
喚醒所有等待該物件監視器的執行緒。 (繼承來源 Object) |
| RegisterCompletionListener(String) |
註冊監聽器以完成特定檔案操作。 |
| SetHandle(IntPtr, JniHandleOwnership) |
設定 Handle 屬性。 (繼承來源 Object) |
| SetPeerReference(JniObjectReference, JniObjectReferenceOptions) |
系統服務管理器，用於處理特權且長時間執行的檔案操作。 (繼承來源 JavaObject) |
| ToArray<T>() |
從這個 Java 陣列包裝器建立一個受管理陣列。 (繼承來源 Object) |
| ToString() |
回傳物件的字串表示。 (繼承來源 Object) |
| UnregisterCompletionListener(String) |
將先前註冊的完成監聽器取消註冊，用於特定檔案操作。 |
| 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() |
系統服務管理器，用於處理特權且長時間執行的檔案操作。 (繼承來源 JavaObject) |
| IJavaPeerable.Finalized() |
系統服務管理器，用於處理特權且長時間執行的檔案操作。 (繼承來源 JavaObject) |
| IJavaPeerable.JniObjectReferenceControlBlock |
系統服務管理器，用於處理特權且長時間執行的檔案操作。 (繼承來源 JavaObject) |
| IJavaPeerable.SetJniIdentityHashCode(Int32) |
系統服務管理器，用於處理特權且長時間執行的檔案操作。 (繼承來源 JavaObject) |
| IJavaPeerable.SetJniManagedPeerState(JniManagedPeerStates) |
系統服務管理器，用於處理特權且長時間執行的檔案操作。 (繼承來源 JavaObject) |
| IJavaPeerable.SetPeerReference(JniObjectReference) |
系統服務管理器，用於處理特權且長時間執行的檔案操作。 (繼承來源 JavaObject) |
擴充方法
| 名稱 | Description |
|---|---|
| GetJniTypeName(IJavaPeerable) |
取得實例 |
| JavaAs<TResult>(IJavaPeerable) |
試著強制 |
| JavaCast<TResult>(IJavaObject) |
執行 Android 執行時檢查型別轉換。 |
| JavaCast<TResult>(IJavaObject) |
系統服務管理器，用於處理特權且長時間執行的檔案操作。 |
| TryJavaCast<TResult>(IJavaPeerable, TResult) |
試著強制 |