StorageVolume.CreateAccessIntent(String) メソッド

定義

名前空間:

Android.OS.Storage

アセンブリ:

Mono.Android.dll

ユーザーの承認を得た後、Standard Storage ディレクトリまたはボリューム全体へのアクセス権を付与する意図を構築します。

[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_PODCASTSEnvironment#DIRECTORY_ALARMSEnvironment#DIRECTORY_RINGTONESEnvironment#DIRECTORY_MUSICEnvironment#DIRECTORY_NOTIFICATIONS要求するには、、、Environment#DIRECTORY_PICTURES、Environment#DIRECTORY_MOVIES、Environment#DIRECTORY_DOWNLOADS、Environment#DIRECTORY_DCIM、、または nullEnvironment#DIRECTORY_DOCUMENTSのいずれかである必要があります。

戻り値

Intent

アクセスを要求する意図、または null 要求されたディレクトリがそのボリュームに対して無効な場合は 。

属性

RegisterAttribute

注釈

ユーザーの承認を得た後、Standard Storage ディレクトリまたはボリューム全体へのアクセス権を付与する意図を構築します。

呼び出されると、システムはユーザーに、要求されたディレクトリ (およびその子孫) へのアクセス権を付与するように求めます。 要求の結果は、 メソッドを介してアクティビティに onActivityResult 返されます。

子孫 (子、孫など) のドキュメントにアクセスするには、 を使用するかDocumentsContract#buildChildDocumentsUriUsingTree(Uri, String)、返された URI で を使用DocumentsContract#buildDocumentUriUsingTree(Uri, String)します。

アプリケーションで内部データのみを格納する必要がある場合は、読み取りまたは書き込みアクセス許可を必要としない 、Context#getExternalCacheDirs()、または Context#getExternalMediaDirs()を使用Context#getExternalFilesDirs(String) Context.getExternalFilesDirsすることを検討してください。

ボリューム全体へのアクセスは、非プライマリ ボリューム (プライマリ ボリュームの場合は、 と android.Manifest.permission#WRITE_EXTERNAL_STORAGE のアクセス許可を使用android.Manifest.permission#READ_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 ドキュメント。

このページの一部は、によって作成および共有された作業に基づく変更であり、に記載されている条件に従って使用されます。