Context.GetExternalFilesDirs(String) Metodo
Definizione
Importante
Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.
Restituisce percorsi assoluti alle directory specifiche dell'applicazione in tutti i dispositivi di archiviazione condivisi/esterni in cui l'applicazione può inserire file persistenti di cui è proprietario.
[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[]
Parametri
- type
- String
Tipo di directory dei file da restituire. Può essere null
per la radice della directory dei file o una delle costanti seguenti per una sottodirectory: android.os.Environment#DIRECTORY_MUSIC
, , android.os.Environment#DIRECTORY_RINGTONES
android.os.Environment#DIRECTORY_PODCASTS
, android.os.Environment#DIRECTORY_ALARMS
android.os.Environment#DIRECTORY_NOTIFICATIONS
, android.os.Environment#DIRECTORY_PICTURES
, o android.os.Environment#DIRECTORY_MOVIES
.
Restituisce
i percorsi assoluti delle directory specifiche dell'applicazione. Alcuni singoli percorsi possono essere null
se tale risorsa di archiviazione condivisa non è attualmente disponibile. Il primo percorso restituito è uguale a #getExternalFilesDir(String)
.
- Attributi
Commenti
Restituisce percorsi assoluti alle directory specifiche dell'applicazione in tutti i dispositivi di archiviazione condivisi/esterni in cui l'applicazione può inserire file persistenti di cui è proprietario. Questi file sono interni all'applicazione e in genere non sono visibili all'utente come supporto.
Ciò è simile #getFilesDir()
al fatto che questi file verranno eliminati quando l'applicazione viene disinstallata, tuttavia esistono alcune differenze importanti: <l'archiviazione condivisa ul><li>potrebbe non essere sempre disponibile, poiché i supporti rimovibili possono essere rimossi dall'utente. Lo stato del supporto può essere controllato usando Environment#getExternalStorageState(File)
. <li>Non esiste alcuna sicurezza applicata con questi file. Ad esempio, qualsiasi applicazione che contiene android.Manifest.permission#WRITE_EXTERNAL_STORAGE
può scrivere in questi file. </ul>
Se un dispositivo di archiviazione condiviso viene emulato (come determinato da Environment#isExternalStorageEmulated(File)
), il contenuto è supportato da una partizione di dati utente privata, il che significa che l'archiviazione dei dati in questo caso è poco vantaggiosa anziché le directory private restituite da #getFilesDir()
e così via.
I dispositivi di archiviazione condivisi restituiti qui sono considerati una parte stabile del dispositivo, inclusi gli slot di supporti fisici sotto una copertura protettiva. I percorsi restituiti non includono dispositivi temporanei, ad esempio le unità flash USB connesse ai dispositivi palmari.
Un'applicazione può archiviare i dati in uno o in tutti i dispositivi restituiti. Ad esempio, un'app può scegliere di archiviare file di grandi dimensioni nel dispositivo con lo spazio più disponibile, come misurato da StatFs
.
Non sono necessarie autorizzazioni aggiuntive per consentire all'app chiamante di leggere o scrivere file nel percorso restituito. L'accesso in scrittura all'esterno di questi percorsi nei dispositivi di archiviazione esterni secondari non è disponibile.
Il percorso restituito può cambiare nel tempo se vengono inseriti supporti di archiviazione condivisi diversi, quindi devono essere salvati in modo permanente solo i percorsi relativi.
Documentazione java per android.content.Context.getExternalFilesDirs(java.lang.String)
.
Le parti di questa pagina sono modifiche basate sul lavoro creato e condiviso dal Android e usato in base ai termini descritti in 2.5 Attribution License Creative Commons 2.5 Attribution License.