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_PODCASTS、Environment#DIRECTORY_PICTURESEnvironment#DIRECTORY_RINGTONESEnvironment#DIRECTORY_NOTIFICATIONSEnvironment#DIRECTORY_ALARMSEnvironment#DIRECTORY_MOVIESEnvironment#DIRECTORY_DOWNLOADS、Environment#DIRECTORY_DCIM、 或 null Environment#DIRECTORY_DOCUMENTS或 的Environment#DIRECTORY_MUSIC其中一個，才能要求存取整個磁碟區。

傳回

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 在執行 或更新版本的裝置android.os.Build.VERSION_CODES#Q上啟動此專案Intent，將會立即完成的結果代碼android.app.Activity#RESULT_CANCELED。

的 android.os.storage.StorageVolume.createAccessIntent(java.lang.String)Java 檔。

此頁面的部分是根據 Android 開放原始碼專案所建立和共用的工作進行修改，並根據 Creative Commons 2.5 屬性授權中所述的詞彙使用。