StorageVolume.CreateAccessIntent(String) Méthode

Définition

Espace de noms:

Android.OS.Storage

Assembly:

Mono.Android.dll

Génère une intention d’accorder l’accès à un répertoire de stockage standard ou à un volume entier après avoir obtenu l’approbation de l’utilisateur.

[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

Paramètres

directoryName

String

doit être l’un des Environment#DIRECTORY_MUSIC, Environment#DIRECTORY_ALARMSEnvironment#DIRECTORY_PICTURESEnvironment#DIRECTORY_DOWNLOADSEnvironment#DIRECTORY_MOVIESEnvironment#DIRECTORY_DCIMEnvironment#DIRECTORY_RINGTONESEnvironment#DIRECTORY_NOTIFICATIONSEnvironment#DIRECTORY_PODCASTSou Environment#DIRECTORY_DOCUMENTSnull pour demander l’accès à l’intégralité du volume.

Retours

Intent

intention de demander l’accès ou null si le répertoire demandé n’est pas valide pour ce volume.

Attributs

RegisterAttribute

Remarques

Génère une intention d’accorder l’accès à un répertoire de stockage standard ou à un volume entier après avoir obtenu l’approbation de l’utilisateur.

Lorsqu’il est appelé, le système demande à l’utilisateur d’accorder l’accès au répertoire demandé (et à ses descendants). Le résultat de la requête est retourné à l’activité par le biais de la onActivityResult méthode.

Pour accéder aux documents descendants (enfant, petit-enfant, etc.), utilisez DocumentsContract#buildDocumentUriUsingTree(Uri, String)ou DocumentsContract#buildChildDocumentsUriUsingTree(Uri, String) avec l’URI retourné.

Si votre application doit uniquement stocker des données internes, envisagez d’utiliser Context#getExternalFilesDirs(String) Context.getExternalFilesDirs, Context#getExternalCacheDirs()ou , ou Context#getExternalMediaDirs(), qui ne nécessitent aucune autorisation de lecture ou d’écriture.

L’accès à l’ensemble du volume est disponible uniquement pour les volumes non principaux (pour le volume principal, les applications peuvent utiliser les autorisations et android.Manifest.permission#WRITE_EXTERNAL_STORAGE les android.Manifest.permission#READ_EXTERNAL_STORAGE autorisations) et doit être utilisé avec précaution, car les utilisateurs sont plus susceptibles de refuser l’accès lorsqu’ils sont invités à accéder à l’ensemble du volume plutôt qu’à des répertoires spécifiques.

Ce membre est déconseillé. Les appelants doivent migrer vers l’utilisation à la Intent#ACTION_OPEN_DOCUMENT_TREE place. Le lancement de ce code Intent sur les appareils en cours d’exécution android.os.Build.VERSION_CODES#Q ou version ultérieure se termine immédiatement avec un code de résultat de android.app.Activity#RESULT_CANCELED.

Documentation Java pour android.os.storage.StorageVolume.createAccessIntent(java.lang.String).

Les parties de cette page sont des modifications basées sur le travail créé et partagé par le projet Android Open Source et utilisés en fonction des termes décrits dans la licence d’attribution Creative Commons 2.5.