Context.GetExternalFilesDirs(String) Metode
Definisi
Penting
Beberapa informasi terkait produk prarilis yang dapat diubah secara signifikan sebelum dirilis. Microsoft tidak memberikan jaminan, tersirat maupun tersurat, sehubungan dengan informasi yang diberikan di sini.
Mengembalikan jalur absolut ke direktori khusus aplikasi di semua perangkat penyimpanan bersama/eksternal tempat aplikasi dapat menempatkan file persisten yang dimilikinya.
[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[]Parameter
- type
- String
Tipe direktori file yang akan dikembalikan. Mungkin null untuk akar direktori file atau salah satu konstanta berikut untuk subdirektori: android.os.Environment#DIRECTORY_MUSIC, , android.os.Environment#DIRECTORY_PODCASTS, android.os.Environment#DIRECTORY_RINGTONESandroid.os.Environment#DIRECTORY_ALARMS, android.os.Environment#DIRECTORY_NOTIFICATIONS, android.os.Environment#DIRECTORY_PICTURES, , atau android.os.Environment#DIRECTORY_MOVIES.
Mengembalikan
jalur absolut ke direktori khusus aplikasi. Beberapa jalur individual mungkin null jika penyimpanan bersama tersebut saat ini tidak tersedia. Jalur pertama yang dikembalikan sama #getExternalFilesDir(String)dengan .
- Atribut
Keterangan
Mengembalikan jalur absolut ke direktori khusus aplikasi di semua perangkat penyimpanan bersama/eksternal tempat aplikasi dapat menempatkan file persisten yang dimilikinya. File-file ini bersifat internal untuk aplikasi, dan biasanya tidak terlihat oleh pengguna sebagai media.
Ini seperti #getFilesDir() dalam file-file ini akan dihapus ketika aplikasi dihapus instalannya, namun ada beberapa perbedaan penting: <penyimpanan bersama ul><li>mungkin tidak selalu tersedia, karena media yang dapat dilepas dapat dikeluarkan oleh pengguna. Status media dapat diperiksa menggunakan Environment#getExternalStorageState(File). <li>Tidak ada keamanan yang diberlakukan dengan file-file ini. Misalnya, setiap penahanan android.Manifest.permission#WRITE_EXTERNAL_STORAGE aplikasi dapat menulis ke file-file ini. </Ul>
Jika perangkat penyimpanan bersama ditiru (sebagaimana ditentukan oleh Environment#isExternalStorageEmulated(File)), kontennya didukung oleh partisi data pengguna pribadi, yang berarti ada sedikit manfaat untuk menyimpan data di sini alih-alih direktori privat yang dikembalikan oleh #getFilesDir(), dll.
Perangkat penyimpanan bersama yang dikembalikan di sini dianggap sebagai bagian yang stabil dari perangkat, termasuk slot media fisik di bawah sampul pelindung. Jalur yang dikembalikan tidak termasuk perangkat sementara, seperti usb flash drive yang terhubung ke perangkat genggam.
Aplikasi dapat menyimpan data di salah satu atau semua perangkat yang dikembalikan. Misalnya, aplikasi dapat memilih untuk menyimpan file besar di perangkat dengan ruang yang paling tersedia, seperti yang diukur oleh StatFs.
Tidak ada izin tambahan yang diperlukan agar aplikasi panggilan membaca atau menulis file di bawah jalur yang dikembalikan. Akses tulis di luar jalur ini pada perangkat penyimpanan eksternal sekunder tidak tersedia.
Jalur yang dikembalikan dapat berubah dari waktu ke waktu jika media penyimpanan bersama yang berbeda dimasukkan, sehingga hanya jalur relatif yang harus dipertahankan.
Dokumentasi Java untuk android.content.Context.getExternalFilesDirs(java.lang.String).
Bagian halaman ini adalah modifikasi berdasarkan pekerjaan yang dibuat dan dibagikan oleh Proyek Sumber Terbuka Android dan digunakan sesuai dengan istilah yang dijelaskan dalam Lisensi Atribusi Creative Commons 2.5.