語言

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_PICTURESEnvironment#DIRECTORY_NOTIFICATIONSEnvironment#DIRECTORY_ALARMSEnvironment#DIRECTORY_RINGTONESEnvironment#DIRECTORY_DOWNLOADSEnvironment#DIRECTORY_DCIMEnvironment#DIRECTORY_MOVIES或 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 and android.Manifest.permission#WRITE_EXTERNAL_STORAGE 權限），因此應謹慎使用，因為使用者在被要求提供整個卷的存取權時，較可能拒絕存取，而非特定目錄。

此會員已被棄用。 來電者應該轉而使用 Intent#ACTION_OPEN_DOCUMENT_TREE 。 在運行android.os.Build.VERSION_CODES#Q或更高效能的裝置上啟動此程序Intent，會立即結束，結果代碼為 android.app.Activity#RESULT_CANCELED。

Java 文件 android.os.storage.StorageVolume.createAccessIntent(java.lang.String)。

本頁部分內容為基於 Open Source Project 所創建與分享的作品，並依授權條款所描述的使用進行修改。

適用於