StorageVolume.CreateAccessIntent(String) Método

Definição

Namespace:: Android.OS.Storage

Assembly:: Mono.Android.dll

Importante

Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.

Cria uma intenção de dar acesso a um diretório de armazenamento padrão ou a um volume inteiro depois de obter a aprovação do usuário.

[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

deve ser um dos Environment#DIRECTORY_MUSIC, Environment#DIRECTORY_PODCASTS, Environment#DIRECTORY_RINGTONES, , Environment#DIRECTORY_NOTIFICATIONSEnvironment#DIRECTORY_ALARMS, Environment#DIRECTORY_PICTURES, Environment#DIRECTORY_MOVIES, , Environment#DIRECTORY_DCIMEnvironment#DIRECTORY_DOWNLOADSou , ou Environment#DIRECTORY_DOCUMENTSnull para solicitar acesso ao volume inteiro.

Retornos

Intent

intenção de solicitar acesso ou null se o diretório solicitado for inválido para esse volume.

Atributos: RegisterAttribute

Comentários

Cria uma intenção de dar acesso a um diretório de armazenamento padrão ou a um volume inteiro depois de obter a aprovação do usuário.

Quando invocado, o sistema solicitará ao usuário que conceda acesso ao diretório solicitado (e seus descendentes). O resultado da solicitação será retornado à atividade por meio do onActivityResult método.

Para obter acesso a documentos descendentes (filho, neto etc), use DocumentsContract#buildDocumentUriUsingTree(Uri, String)ou DocumentsContract#buildChildDocumentsUriUsingTree(Uri, String) com o URI retornado.

Se o aplicativo precisar apenas armazenar dados internos, considere usar Context#getExternalFilesDirs(String) Context.getExternalFilesDirs, Context#getExternalCacheDirs()ou Context#getExternalMediaDirs(), que não exijam permissões para ler ou gravar.

O acesso a todo o volume só está disponível para volumes não primários (para o volume primário, os aplicativos podem usar e android.Manifest.permission#READ_EXTERNAL_STORAGE permissões) e android.Manifest.permission#WRITE_EXTERNAL_STORAGE deve ser usado com cuidado, já que os usuários são mais propensos a negar acesso quando solicitados o acesso inteiro ao volume em vez de diretórios específicos.

Este membro foi preterido. Em vez disso, os chamadores devem migrar para o uso Intent#ACTION_OPEN_DOCUMENT_TREE . Iniciar isso Intent em dispositivos em execução android.os.Build.VERSION_CODES#Q ou superior terminará imediatamente com um código de resultado de android.app.Activity#RESULT_CANCELED.

Java documentação para android.os.storage.StorageVolume.createAccessIntent(java.lang.String).

Partes desta página são modificações baseadas no trabalho criado e compartilhado pelo Project Open Source do Open Source e usadas de acordo com os termos descritos na Creative Commons 2.5.

Aplica-se a