Share via

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_RINGTONES, Environment#DIRECTORY_ALARMS, Environment#DIRECTORY_NOTIFICATIONS, Environment#DIRECTORY_PICTURES, Environment#DIRECTORY_MOVIES, , Environment#DIRECTORY_DCIMEnvironment#DIRECTORY_DOWNLOADSили Environment#DIRECTORY_DOCUMENTS, или null , чтобы запросить доступ ко всему тому.

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

Intent

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

Атрибуты
RegisterAttribute

Комментарии

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

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

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

Если приложению требуется хранить только внутренние данные, рассмотрите возможность использования Context#getExternalFilesDirs(String) Context.getExternalFilesDirs, Context#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 License.

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