StorageVolume.CreateAccessIntent(String) Méthode

Référence

Définition

Espace de noms:: Android.OS.Storage

Assembly:: Mono.Android.dll

Important

Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.

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.

S’applique à

Partager via