Поделиться через

StorageVolume.CreateAccessIntent(String) Метод

  • Ссылка

Определение

Пространство имен:
Android.OS.Storage
Сборка:
Mono.Android.dll

Создает намерение предоставить доступ к стандартному каталогу хранилища или всему тому после получения утверждения пользователя.

[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

Параметры

directoryName
String

должен быть одним из Environment#DIRECTORY_MUSIC, Environment#DIRECTORY_PODCASTS, Environment#DIRECTORY_RINGTONESEnvironment#DIRECTORY_MOVIESEnvironment#DIRECTORY_NOTIFICATIONSEnvironment#DIRECTORY_ALARMSEnvironment#DIRECTORY_DOWNLOADSEnvironment#DIRECTORY_DCIMEnvironment#DIRECTORY_PICTURESили Environment#DIRECTORY_DOCUMENTS, чтобы null запросить доступ ко всему тому.

Возвращаемое значение

Intent

намерение запрашивать доступ или null если запрошенный каталог недопустим для этого тома.

Атрибуты
RegisterAttribute

Комментарии

Создает намерение предоставить доступ к стандартному каталогу хранилища или всему тому после получения утверждения пользователя.

При вызове система попросит пользователя предоставить доступ к запрошенной папке (и ее потомкам). Результат запроса будет возвращен в действие с помощью onActivityResult метода.

Чтобы получить доступ к потомкам (дочерним, внукам и т. д.), используйте DocumentsContract#buildDocumentUriUsingTree(Uri, String)или DocumentsContract#buildChildDocumentsUriUsingTree(Uri, String) с возвращаемым универсальным кодом ресурса (URI).

Если приложение должно хранить только внутренние данные, рассмотрите возможность использования Context#getExternalFilesDirs(String) Context.getExternalFilesDirsContext#getExternalCacheDirs()или Context#getExternalMediaDirs()не требует разрешений на чтение или запись.

Доступ ко всему тому доступен только для не первичных томов (для основного тома приложения могут использовать android.Manifest.permission#READ_EXTERNAL_STORAGE и android.Manifest.permission#WRITE_EXTERNAL_STORAGE разрешения) и должен использоваться с осторожностью, так как пользователи, скорее всего, отклонят доступ при запросе всего доступа к тому, а не для определенных каталогов.

Этот элемент считается нерекомендуемым. Вместо этого вызывающие абоненты должны перейти на использование Intent#ACTION_OPEN_DOCUMENT_TREE . Запуск на Intent устройствах, работающих или более поздних android.os.Build.VERSION_CODES#Q версий, немедленно завершится с кодом android.app.Activity#RESULT_CANCELEDрезультата.

Документация по Java для android.os.storage.StorageVolume.createAccessIntent(java.lang.String).

Части этой страницы — это изменения на основе работы, созданной и общей проектом с открытым исходным кодом Android и используемой в соответствии с условиями, описанными в лицензии Creative Commons 2.5 Attribution.

Применяется к