StorageVolume.CreateAccessIntent(String) メソッド
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
ユーザーの承認を取得した後、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_MUSICは、Environment#DIRECTORY_PODCASTS、Environment#DIRECTORY_RINGTONES、Environment#DIRECTORY_ALARMS、Environment#DIRECTORY_NOTIFICATIONS、、Environment#DIRECTORY_PICTURES、、Environment#DIRECTORY_MOVIESEnvironment#DIRECTORY_DCIMEnvironment#DIRECTORY_DOWNLOADSまたはEnvironment#DIRECTORY_DOCUMENTSnullボリューム全体へのアクセスを要求する必要があります。
戻り値
アクセスを要求する意図、または null 要求されたディレクトリがそのボリュームに対して無効な場合。
- 属性
注釈
ユーザーの承認を取得した後、Standard Storage ディレクトリまたはボリューム全体へのアクセス権を付与する意図を構築します。
呼び出されると、システムは、要求されたディレクトリ (およびその子孫) へのアクセス権を付与するようにユーザーに求めます。 要求の結果は、メソッドを介して onActivityResult アクティビティに返されます。
子孫 (子、孫など) のドキュメントにアクセスするには、返された URI を使用 DocumentsContract#buildDocumentUriUsingTree(Uri, String)するか、または DocumentsContract#buildChildDocumentsUriUsingTree(Uri, String) 使用します。
アプリケーションで内部データのみを格納する必要がある場合は、読み取りまたは書き込みのアクセス許可を必要としない 、またはContext#getExternalMediaDirs()使用することを検討してください。Context#getExternalFilesDirs(String) Context.getExternalFilesDirsContext#getExternalCacheDirs()
ボリューム全体へのアクセスは、非プライマリ ボリュームでのみ使用できます (プライマリ ボリュームの場合、アプリはアクセス許可とandroid.Manifest.permission#WRITE_EXTERNAL_STORAGEアクセス許可をandroid.Manifest.permission#READ_EXTERNAL_STORAGE使用できます)。ユーザーは、特定のディレクトリではなくボリューム全体のアクセスを求められた場合にアクセスを拒否する可能性が高いため、注意して使用する必要があります。
このメンバーは非推奨です。 呼び出し元は、代わりに using 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)
このページの一部は、Android オープンソース プロジェクトによって作成および共有され、クリエイティブ コモンズ 2.5 属性ライセンスに記載されている条件に従って使用される作業に基づく変更です。