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_NOTIFICATIONS
Environment#DIRECTORY_MOVIES
Environment#DIRECTORY_DOWNLOADS
Environment#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.