StorageVolume.CreateAccessIntent(String) Método
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
Crea una intención para conceder acceso a un directorio de almacenamiento estándar o a todo el volumen después de obtener la aprobación del usuario.
[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
Parámetros
- directoryName
- String
debe ser uno de Environment#DIRECTORY_MUSIC, Environment#DIRECTORY_PODCASTS, Environment#DIRECTORY_RINGTONES, Environment#DIRECTORY_ALARMS, Environment#DIRECTORY_NOTIFICATIONSEnvironment#DIRECTORY_MOVIESEnvironment#DIRECTORY_DOWNLOADSEnvironment#DIRECTORY_PICTURES, Environment#DIRECTORY_DCIM, o Environment#DIRECTORY_DOCUMENTS, o null para solicitar acceso a todo el volumen.
Devoluciones
intención de solicitar acceso o null si el directorio solicitado no es válido para ese volumen.
- Atributos
Comentarios
Crea una intención para conceder acceso a un directorio de almacenamiento estándar o a todo el volumen después de obtener la aprobación del usuario.
Cuando se invoca, el sistema pedirá al usuario que conceda acceso al directorio solicitado (y sus descendientes). El resultado de la solicitud se devolverá a la actividad a través del onActivityResult método .
Para obtener acceso a los documentos descendientes (secundarios, nietos, etc.), use DocumentsContract#buildDocumentUriUsingTree(Uri, String)o DocumentsContract#buildChildDocumentsUriUsingTree(Uri, String) con el URI devuelto.
Si la aplicación solo necesita almacenar datos internos, considere la posibilidad de usar Context#getExternalFilesDirs(String) Context.getExternalFilesDirs, Context#getExternalCacheDirs()o Context#getExternalMediaDirs(), que no requieren permisos para leer o escribir.
El acceso a todo el volumen solo está disponible para volúmenes que no son principales (para el volumen principal, las aplicaciones pueden usar los android.Manifest.permission#READ_EXTERNAL_STORAGE permisos y android.Manifest.permission#WRITE_EXTERNAL_STORAGE ) y debe usarse con precaución, ya que es más probable que los usuarios denieguen el acceso cuando se le solicite acceso de volumen completo en lugar de directorios específicos.
Este miembro está en desuso. Los autores de llamadas deben migrar al uso Intent#ACTION_OPEN_DOCUMENT_TREE en su lugar. Iniciarlo Intent en dispositivos que se ejecutan android.os.Build.VERSION_CODES#Q o superior, finalizará inmediatamente con un código de resultado de android.app.Activity#RESULT_CANCELED.
Documentación de Java para android.os.storage.StorageVolume.createAccessIntent(java.lang.String).
Las partes de esta página son modificaciones basadas en el trabajo creado y compartido por el proyecto de código abierto de Android y se usan según los términos descritos en la licencia de atribución de Creative Commons 2.5.