Context.GetExternalFilesDirs(String) メソッド
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
アプリケーションが所有する永続ファイルを配置できるすべての共有/外部ストレージ デバイス上のアプリケーション固有のディレクトリへの絶対パスを返します。
[Android.Runtime.Register("getExternalFilesDirs", "(Ljava/lang/String;)[Ljava/io/File;", "GetGetExternalFilesDirs_Ljava_lang_String_Handler")]
public abstract Java.IO.File[]? GetExternalFilesDirs (string? type);
[<Android.Runtime.Register("getExternalFilesDirs", "(Ljava/lang/String;)[Ljava/io/File;", "GetGetExternalFilesDirs_Ljava_lang_String_Handler")>]
abstract member GetExternalFilesDirs : string -> Java.IO.File[]
パラメーター
- type
- String
返すファイル ディレクトリの種類。 null
ファイル ディレクトリのルート、またはサブディレクトリandroid.os.Environment#DIRECTORY_MUSIC
の定数 (、、 android.os.Environment#DIRECTORY_NOTIFICATIONS
android.os.Environment#DIRECTORY_MOVIES
android.os.Environment#DIRECTORY_PODCASTS
android.os.Environment#DIRECTORY_RINGTONES
android.os.Environment#DIRECTORY_ALARMS
android.os.Environment#DIRECTORY_PICTURES
のいずれか) の場合があります。
戻り値
アプリケーション固有のディレクトリへの絶対パス。 その共有ストレージが現在使用できない場合、一部の個々のパスが存在する可能性があります null
。 返される最初のパスは と同じです #getExternalFilesDir(String)
。
- 属性
注釈
アプリケーションが所有する永続ファイルを配置できるすべての共有/外部ストレージ デバイス上のアプリケーション固有のディレクトリへの絶対パスを返します。 これらのファイルはアプリケーションの内部にあり、通常はメディアとしてユーザーに表示されません。
これは、アプリケーションをアンインストールするとこれらのファイルが削除されるという点で似ています #getFilesDir()
が、いくつかの重要な違いがあります。 <ul><li>Shared Storage は、ユーザーがリムーバブル メディアを取り出すことができるため、常に使用できるとは限りません。 メディアの状態は、 を使用して Environment#getExternalStorageState(File)
確認できます。 <li>これらのファイルにはセキュリティは適用されません。 たとえば、保持しているアプリケーション android.Manifest.permission#WRITE_EXTERNAL_STORAGE
は、これらのファイルに書き込むことができます。 </ul>
共有ストレージ デバイスが (によって Environment#isExternalStorageEmulated(File)
決定される) エミュレートされた場合、その内容はプライベート ユーザー データ パーティションによってサポートされます。つまり、 によって返される #getFilesDir()
プライベート ディレクトリではなく、ここにデータを格納する利点はほとんどありません。
ここで返される共有ストレージ デバイスは、保護カバーの下の物理メディア スロットを含め、デバイスの安定した部分と見なされます。 返されるパスには、ハンドヘルド デバイスに接続されている USB フラッシュ ドライブなどの一時的なデバイスは含まれません。
アプリケーションは、返されたデバイスの一部または全部にデータを格納できます。 たとえば、アプリでは、 で StatFs
測定された、使用可能な領域が最も大きい大きなファイルをデバイスに格納することを選択できます。
呼び出し元アプリが、返されたパスの下にあるファイルを読み取りまたは書き込むための追加のアクセス許可は必要ありません。 セカンダリ外部ストレージ デバイス上のこれらのパスの外部への書き込みアクセスは使用できません。
異なる共有ストレージ メディアが挿入されると、返されるパスが時間の経過と同時に変更される可能性があるため、相対パスのみを保持する必要があります。
の android.content.Context.getExternalFilesDirs(java.lang.String)
Java ドキュメント。
このページの一部は、によって作成および共有された作業に基づく変更であり、に記載されている条件に従って使用されます。