StorageVolume.CreateAccessIntent(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.
Crea una finalità per concedere l'accesso a una directory di archiviazione standard o a un intero volume dopo aver ottenuto l'approvazione dell'utente.
[Android.Runtime.Register("createAccessIntent", "(Ljava/lang/String;)Landroid/content/Intent;", "", ApiSince=24)]
public Android.Content.Intent? CreateAccessIntent (string? directoryName);
[<Android.Runtime.Register("createAccessIntent", "(Ljava/lang/String;)Landroid/content/Intent;", "", ApiSince=24)>]
member this.CreateAccessIntent : string -> Android.Content.Intent
Parametri
- directoryName
- String
deve essere uno di Environment#DIRECTORY_MUSIC
, Environment#DIRECTORY_PODCASTS
Environment#DIRECTORY_RINGTONES
, Environment#DIRECTORY_ALARMS
, Environment#DIRECTORY_NOTIFICATIONS
, Environment#DIRECTORY_PICTURES
, , Environment#DIRECTORY_MOVIES
Environment#DIRECTORY_DOWNLOADS
Environment#DIRECTORY_DCIM
, , o Environment#DIRECTORY_DOCUMENTS
o null
per richiedere l'accesso all'intero volume.
Restituisce
finalità di richiedere l'accesso o null
se la directory richiesta non è valida per tale volume.
- Attributi
Commenti
Crea una finalità per concedere l'accesso a una directory di archiviazione standard o a un intero volume dopo aver ottenuto l'approvazione dell'utente.
Quando viene richiamato, il sistema chiederà all'utente di concedere l'accesso alla directory richiesta (e ai relativi discendenti). Il risultato della richiesta verrà restituito all'attività tramite il onActivityResult
metodo .
Per ottenere l'accesso ai documenti discendenti (figlio, nipote e così via), usare DocumentsContract#buildDocumentUriUsingTree(Uri, String)
o DocumentsContract#buildChildDocumentsUriUsingTree(Uri, String)
con l'URI restituito.
Se l'applicazione deve archiviare solo i dati interni, prendere in considerazione l'uso Context#getExternalFilesDirs(String) Context.getExternalFilesDirs
di , Context#getExternalCacheDirs()
o Context#getExternalMediaDirs()
, che non richiedono autorizzazioni per la lettura o la scrittura.
L'accesso all'intero volume è disponibile solo per i volumi non primari (per il volume primario, le app possono usare le android.Manifest.permission#READ_EXTERNAL_STORAGE
autorizzazioni e android.Manifest.permission#WRITE_EXTERNAL_STORAGE
) e devono essere usate con cautela, poiché è più probabile che gli utenti neghino l'accesso quando viene richiesto l'accesso all'intero volume anziché a directory specifiche.
Questo membro è deprecato. I chiamanti devono eseguire invece la migrazione all'uso Intent#ACTION_OPEN_DOCUMENT_TREE
. L'avvio di questa operazione Intent
nei dispositivi in esecuzione android.os.Build.VERSION_CODES#Q
o versione successiva termina immediatamente con il codice di risultato .android.app.Activity#RESULT_CANCELED
Documentazione java per android.os.storage.StorageVolume.createAccessIntent(java.lang.String)
.
Le parti di questa pagina sono modifiche basate sul lavoro creato e condiviso dal progetto Open Source Android e usato in base ai termini descritti nella licenza Creative Commons 2.5 Attribuzione.