StorageVolume.CreateAccessIntent(String) Método

Definição

Namespace:

Android.OS.Storage

Assembly:

Mono.Android.dll

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 de Environment#DIRECTORY_MUSIC, Environment#DIRECTORY_PODCASTS, Environment#DIRECTORY_RINGTONES, , Environment#DIRECTORY_ALARMS, Environment#DIRECTORY_NOTIFICATIONS, Environment#DIRECTORY_MOVIESEnvironment#DIRECTORY_PICTURES, Environment#DIRECTORY_DOWNLOADSEnvironment#DIRECTORY_DCIMou Environment#DIRECTORY_DOCUMENTS, ou null para solicitar acesso a todo o volume.

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 através do onActivityResult método.

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

Se seu aplicativo precisar armazenar apenas dados internos, considere usar Context#getExternalFilesDirs(String) Context.getExternalFilesDirs, Context#getExternalCacheDirs()ou Context#getExternalMediaDirs(), que não exigem permissões para leitura ou gravação.

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

Este membro foi preterido. Os chamadores devem migrar para o uso Intent#ACTION_OPEN_DOCUMENT_TREE em vez disso. Iniciando 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.

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

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