Context.GetExternalFilesDirs(String) 方法
定義
重要
部分資訊涉及發行前產品，在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊，不做任何明確或隱含的瑕疵擔保。
回傳所有共享/外部儲存裝置上應用程式專屬目錄的絕對路徑，該應用程式可在其中放置其擁有的持久檔案。
[Android.Runtime.Register("getExternalFilesDirs", "(Ljava/lang/String;)[Ljava/io/File;", "GetGetExternalFilesDirs_Ljava_lang_String_Handler")]
public abstract Java.IO.File[]? GetExternalFilesDirs(string? type);[<Android.Runtime.Register("getExternalFilesDirs", "(Ljava/lang/String;)[Ljava/io/File;", "GetGetExternalFilesDirs_Ljava_lang_String_Handler")>]
abstract member GetExternalFilesDirs : string -> Java.IO.File[]參數
- type
- String
要回傳的檔案目錄類型。 可以是null檔案目錄的根，或是子目錄的下列常數之一：android.os.Environment#DIRECTORY_MUSIC、android.os.Environment#DIRECTORY_PODCASTS、android.os.Environment#DIRECTORY_RINGTONES、android.os.Environment#DIRECTORY_ALARMSandroid.os.Environment#DIRECTORY_NOTIFICATIONSandroid.os.Environment#DIRECTORY_PICTURES或。android.os.Environment#DIRECTORY_MOVIES
傳回
絕對路徑指向特定應用程式目錄。 有些個別路徑可能是 null 因為該共享儲存目前無法使用。 回傳的第一條路徑與 #getExternalFilesDir(String)相同。
- 屬性
備註
回傳所有共享/外部儲存裝置上應用程式專屬目錄的絕對路徑，該應用程式可在其中放置其擁有的持久檔案。 這些檔案是應用程式內部的，使用者通常不會以媒體形式看到。
這類似 #getFilesDir() 於這些檔案在應用程式卸載時會被刪除，但兩者有一些重要差異： <ul><li>共享儲存空間可能不一定隨時可用，因為使用者可以彈出可移除的媒體。 媒體狀態可用 檢查 Environment#getExternalStorageState(File)。
<李>：這些檔案沒有執行任何安全措施。 例如，任何持有的 android.Manifest.permission#WRITE_EXTERNAL_STORAGE 應用程式都可以寫入這些檔案。
</ul>
若共享儲存裝置被模擬（由 決定 Environment#isExternalStorageEmulated(File)），其內容由私人使用者資料分割區支援，這意味著將資料存放於此處與由 等回傳 #getFilesDir()的私有目錄相比，幾乎沒有太大益處。
此處歸還的共享儲存裝置被視為裝置的穩定部分，包括保護蓋下的實體媒體槽。 回傳路徑不包含暫時性裝置，例如連接於手持裝置的 USB 隨身碟。
應用程式可能會將資料儲存在任何或所有退回的裝置上。 例如，應用程式可能會選擇將較大檔案儲存在空間最大（以 StatFs為單位）的裝置上。
呼叫應用程式在回傳路徑下讀寫檔案不需要額外權限。 在這些路徑之外，次級外部儲存裝置無法寫入存取。
若插入不同的共享儲存媒介，回傳路徑可能會隨時間改變，因此應僅保留相對路徑。
Java 文件 android.content.Context.getExternalFilesDirs(java.lang.String)。
本頁部分內容為基於 Open Source Project 所創建與分享的作品，並依授權條款所描述的使用進行修改。