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_ALARMS
android.os.Environment#DIRECTORY_RINGTONES
、android.os.Environment#DIRECTORY_NOTIFICATIONS
、 android.os.Environment#DIRECTORY_PICTURES
或 android.os.Environment#DIRECTORY_MOVIES
。
傳回
應用程式特定目錄的絕對路徑。 某些個別路徑可能 null
目前無法使用該共享記憶體。 傳回的第一個路徑與 相同 #getExternalFilesDir(String)
。
- 屬性
備註
傳回應用程式所有共用/外部儲存裝置上應用程式特定目錄的絕對路徑,應用程式可以在其中放置它所擁有的永續性檔案。 這些檔案是應用程式內部的,通常不會向用戶顯示為媒體。
這就像 #getFilesDir()
在卸載應用程式時刪除這些檔案一樣,不過有一些重要的差異: <ul><li>共用記憶體可能不一定可用,因為使用者可以退出抽取式媒體。 您可以使用 來檢查 Environment#getExternalStorageState(File)
媒體狀態。 <li>這些檔案沒有強制執行安全性。 例如,任何持有 android.Manifest.permission#WRITE_EXTERNAL_STORAGE
的應用程式都可以寫入這些檔案。 </ul>
如果共用存放設備模擬(由 決定 Environment#isExternalStorageEmulated(File)
),其內容會受到私人用戶數據分割的支援,這表示在這裡儲存數據並無任何好處,而不是 由傳回 #getFilesDir()
的私人目錄等。
此處傳回的共用存儲設備會被視為裝置的穩定部分,包括保護蓋下的實體媒體插槽。 傳回的路徑不包含暫時性裝置,例如連線到手持裝置的USB快閃磁碟驅動器。
應用程式可以在任何或所有傳回的裝置上儲存數據。 例如,應用程式可以選擇將大型檔案儲存在具有最多可用空間的裝置上,如 所測量。StatFs
呼叫應用程式不需要額外的許可權,即可在傳回的路徑下讀取或寫入檔案。 次要外部儲存裝置上的這些路徑外部的寫入存取權無法使用。
如果插入不同的共用儲存媒體,傳回的路徑可能會隨著時間而變更,因此應該只保存相對路徑。
的 android.content.Context.getExternalFilesDirs(java.lang.String)
Java 檔。
此頁面的部分是根據 Android 開放原始碼專案所建立和共用的工作進行修改,並根據 Creative Commons 2.5 屬性授權中所述的詞彙使用。