ContextWrapper.GetExternalFilesDirs(String) 方法

[Android.Runtime.Register("getExternalFilesDirs", "(Ljava/lang/String;)[Ljava/io/File;", "GetGetExternalFilesDirs_Ljava_lang_String_Handler")]
public override Java.IO.File[]? GetExternalFilesDirs(string? type);

[<Android.Runtime.Register("getExternalFilesDirs", "(Ljava/lang/String;)[Ljava/io/File;", "GetGetExternalFilesDirs_Ljava_lang_String_Handler")>]
override this.GetExternalFilesDirs : string -> Java.IO.File[]

參數

傳回

回傳所有共享/外部儲存裝置上應用程式專屬目錄的絕對路徑，該應用程式可在其中放置其擁有的持久檔案。 這些檔案是應用程式內部的，使用者通常不會以媒體形式看到。 這類似 getFilesDir（），這些檔案在應用程式卸載時會被刪除，但兩者有一些重要差異：共享儲存空間不一定總是可用，因為使用者可以彈出可移除的媒體。 媒體狀態可透過 Environment.getExternalStorageState（File） 檢查。 這些檔案並未執行任何安全措施。 例如，任何持有Manifest.permission.WRITE_EXTERNAL_STORAGE的應用程式都能寫入這些檔案。 若共用儲存裝置被模擬（依 Environment.isExternalStorageEmulated（File） 判定），其內容會由私人使用者資料分割區支援，這意味著在此儲存資料與 getFilesDir（） 等所回傳的私有目錄相比，幾乎沒有太大好處。此處歸還的共享儲存裝置被視為裝置的穩定部分，包括保護蓋下的實體媒體槽。 回傳路徑不包含暫時性裝置，例如連接於手持裝置的 USB 隨身碟。 應用程式可能會將資料儲存在任何或所有退回的裝置上。 例如，應用程式可能會選擇將大型檔案儲存在可用空間最多的裝置上，該裝置以 StatF 衡量。 呼叫應用程式在回傳路徑下讀寫檔案不需要額外權限。 在這些路徑之外，次級外部儲存裝置無法寫入存取。 若插入不同的共享儲存媒介，回傳路徑可能會隨時間改變，因此應僅保留相對路徑。 參數類型 String ：要回傳的檔案目錄類型。 檔案目錄根目錄的常數可能是空，或子目錄的常數之一為空：Environment.DIRECTORY_MUSIC、Environment.DIRECTORY_PODCASTS、Environment.DIRECTORY_RINGTONES、Environment.DIRECTORY_ALARMS、Environment.DIRECTORY_NOTIFICATIONS、Environment.DIRECTORY_PICTURES 或 Environment.DIRECTORY_MOVIES。 回傳檔案[]，提供應用程式專屬目錄的絕對路徑。 若該共享儲存目前無法使用，某些個別路徑可能會為空。 回傳的第一條路徑與 getExternalFilesDir（String） 相同。

屬性

RegisterAttribute

備註

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

Java 文件 android.content.ContextWrapper.getExternalFilesDirs(java.lang.String)。