Language

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_MUSIC、 Environment#DIRECTORY_PODCASTS、 Environment#DIRECTORY_RINGTONES、 Environment#DIRECTORY_ALARMS、 Environment#DIRECTORY_NOTIFICATIONS、 Environment#DIRECTORY_PICTURES、 Environment#DIRECTORY_MOVIES、 Environment#DIRECTORY_DOWNLOADS、 Environment#DIRECTORY_DCIM、または Environment#DIRECTORY_DOCUMENTSnull のいずれかである必要があります。

返品

Intent

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

属性
RegisterAttribute

注釈

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

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

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

アプリケーションで内部データのみを格納する必要がある場合は、読み取りまたは書き込みアクセス許可を必要としない 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の結果コードですぐに完了します。

Javaドキュメント。

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

適用対象