StorageVolume.CreateAccessIntent(String) Methode

Definition

Namespace:

Android.OS.Storage

Assembly:

Mono.Android.dll

Erstellt eine Absicht, zugriff auf ein Standardspeicherverzeichnis oder ein gesamtes Volume nach erhalt der Genehmigung des Benutzers zu gewähren.

[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

Parameter

directoryName

String

muss einer von Environment#DIRECTORY_MUSIC, , , Environment#DIRECTORY_RINGTONES, Environment#DIRECTORY_ALARMSEnvironment#DIRECTORY_NOTIFICATIONS, Environment#DIRECTORY_PICTURES, , Environment#DIRECTORY_MOVIES, , Environment#DIRECTORY_DOWNLOADSoder Environment#DIRECTORY_DCIMEnvironment#DIRECTORY_DOCUMENTS, oder , um null den Zugriff auf das gesamte Volume anzufordernEnvironment#DIRECTORY_PODCASTS.

Gibt zurück

Intent

Absicht, den Zugriff anzufordern, oder null wenn das angeforderte Verzeichnis für dieses Volume ungültig ist.

Attribute

RegisterAttribute

Hinweise

Erstellt eine Absicht, zugriff auf ein Standardspeicherverzeichnis oder ein gesamtes Volume nach erhalt der Genehmigung des Benutzers zu gewähren.

Wenn das System aufgerufen wird, fordert das System den Benutzer auf, zugriff auf das angeforderte Verzeichnis (und seine Nachfolger) zu gewähren. Das Ergebnis der Anforderung wird über die onActivityResult Methode an die Aktivität zurückgegeben.

Um Zugriff auf untergeordnete Dokumente (untergeordnete, enkelkindische Dokumente usw.) zu erhalten, verwenden DocumentsContract#buildDocumentUriUsingTree(Uri, String)Sie oder DocumentsContract#buildChildDocumentsUriUsingTree(Uri, String) mit dem zurückgegebenen URI.

Wenn Ihre Anwendung nur interne Daten speichern muss, erwägen Sie, interne Daten zu verwenden Context#getExternalFilesDirs(String) Context.getExternalFilesDirsContext#getExternalCacheDirs()oder zu verwenden, die Context#getExternalMediaDirs()keine Berechtigungen zum Lesen oder Schreiben erfordern.

Der Zugriff auf das gesamte Volume ist nur für nicht primäre Volumes verfügbar (für das primäre Volume, Apps können diese android.Manifest.permission#READ_EXTERNAL_STORAGE und android.Manifest.permission#WRITE_EXTERNAL_STORAGE Berechtigungen verwenden) und sollte mit Vorsicht verwendet werden, da Benutzer den Zugriff wahrscheinlicher verweigern, wenn Sie nach vollständigem Volumezugriff gefragt werden, anstatt bestimmte Verzeichnisse.

Dieses Mitglied ist veraltet. Anrufer sollten stattdessen zur Verwendung Intent#ACTION_OPEN_DOCUMENT_TREE migrieren. Das Starten auf Intent Geräten, die ausgeführt android.os.Build.VERSION_CODES#Q werden oder höher, wird sofort mit einem Ergebniscode von android.app.Activity#RESULT_CANCELED.

Java-Dokumentation für android.os.storage.StorageVolume.createAccessIntent(java.lang.String).

Teile dieser Seite sind Änderungen auf der Grundlage von Arbeiten, die vom Android Open Source-Projekt erstellt und freigegeben werden und gemäß den in der Creative Commons 2.5 Attribution License beschriebenen Begriffen verwendet werden.