語言

FileManager 類別

定義

系統服務管理器,用於處理特權且長時間執行的檔案操作。

[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
屬性

備註

系統服務管理器,用於處理特權且長時間執行的檔案操作。

FileManager 提供一個 API,讓應用程式可以請求非同步的檔案操作,例如移動或複製檔案。 這些操作由系統服務(「FileService」)在背景執行緒中執行,以確保應用程式的響應性與系統穩定性。

使用概述

與檔案操作服務互動通常包含三個步驟:排隊請求:使用 enqueueOperation(FileOperationRequest) 提交新操作。 此方法會立即回傳一個 FileOperationEnqueueResult,若成功則包含唯一的請求 ID,若系統忙碌則包含錯誤代碼;進度追蹤(可選):應用程式可使用 fetchResult(String) 輪詢操作的當前狀態,或僅等待完成;處理完成:若操作完成(成功或失敗)時,要接收通知,呼叫 registerCompletionListener(String)。 當操作進入終端狀態時,系統會向你的包裹發送廣播ACTION_FILE_OPERATION_COMPLETED。

並行與限制

系統對同時進行的作業數量設有限制,以防止資源耗盡。 若系統負載過重,enqueueOperation(FileOperationRequest)可能會回傳錯誤代碼FileOperationResult.ERROR_BUSY。 應用程式應能優雅處理此情況,甚至可能稍後重試。

此外,系統會將 a FileOperationResult 中回報的個別檔案失敗次數限制為從 回傳 MaxReportedFailures的值。 若細緻故障報告對您的使用情境至關重要,請避免在單一請求中排入超過故障回報限制的檔案。

Android 參考資料。android.os.storage.FileManager

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

欄位

名稱 Description
ActionFileOperationCompleted

廣播動作:當檔案操作完成時傳送。

ExtraRequestId

額外內容: ActionFileOperationCompleted請求 ID(字串)。

ExtraResult

額外 對 ActionFileOperationCompleted:結果 (android.os.storage.operations.FileOperationResult)。

屬性

名稱 Description
Class

回傳此 Object的執行時類別。

(繼承來源 Object)
Handle

底層 Android 實例的帳號。

(繼承來源 Object)
JniIdentityHashCode

取得由互通執行時指派給此 Java 對等端的身份雜湊碼。

(繼承來源 Object)
JniManagedPeerState

取得執行時最後指派的狀態旗標。

(繼承來源 JavaObject)
JniPeerMembers

取得用於存取此 Java 綁定成員的 JNI 元資料。

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)

測試另一個受管理節點是否參考相同的 Java 物件。

(繼承來源 JavaObject)
Equals(Object)

表示是否有其他物體「等同」於此物。

(繼承來源 Object)
FetchResult(String)

取得檔案操作的當前結果。

GetHashCode()

回傳物件的雜湊碼值。

(繼承來源 Object)
JavaFinalize()
已淘汰.

當垃圾回收判定該物件不再有相關參考時,由垃圾回收器呼叫。

(繼承來源 Object)
Notify()

喚醒一個正在該物件監視器上等待的執行緒。

(繼承來源 Object)
NotifyAll()

喚醒所有等待該物件監視器的執行緒。

(繼承來源 Object)
RegisterCompletionListener(String)

註冊監聽器以完成特定檔案操作。

SetHandle(IntPtr, JniHandleOwnership)

設定 Handle 屬性。

(繼承來源 Object)
SetPeerReference(JniObjectReference, JniObjectReferenceOptions)

在控制區塊中儲存參考值,但不建立 JNI 參考副本。

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

從這個 Java 陣列包裝器建立一個受管理陣列。

(繼承來源 Object)
ToString()

回傳物件的字串表示。

(繼承來源 Object)
UnregisterCompletionListener(String)

將先前註冊的完成監聽器取消註冊,用於特定檔案操作。

UnregisterFromRuntime()

將此 Java 節點從互通執行時中取消註冊。

(繼承來源 Object)
Wait()

使目前執行緒等待被喚醒,通常是透過 通知 或 中斷。

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

使目前執行緒等待被喚醒(通常是透過 通知 或 中斷),或等待一定的實際時間過去。

(繼承來源 Object)
Wait(Int64)

使目前執行緒等待被喚醒(通常是透過 通知 或 中斷),或等待一定的實際時間過去。

(繼承來源 Object)

明確介面實作

名稱 Description
IJavaPeerable.Disposed()

標記此節點為處置,並以disposing設定為 true的呼叫Dispose。

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

標記此節點為處置,並以disposing設定為 false的呼叫Dispose。

(繼承來源 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 端是否有效。

適用於