ContextWrapper.GetExternalFilesDirs(String) メソッド

[Android.Runtime.Register("getExternalFilesDirs", "(Ljava/lang/String;)[Ljava/io/File;", "GetGetExternalFilesDirs_Ljava_lang_String_Handler")]
public override Java.IO.File[]? GetExternalFilesDirs(string? type);

[<Android.Runtime.Register("getExternalFilesDirs", "(Ljava/lang/String;)[Ljava/io/File;", "GetGetExternalFilesDirs_Ljava_lang_String_Handler")>]
override this.GetExternalFilesDirs : string -> Java.IO.File[]

パラメーター

返品

アプリケーションが所有する永続ファイルを配置できるすべての共有/外部ストレージ デバイス上のアプリケーション固有のディレクトリへの絶対パスを返します。 これらのファイルはアプリケーションの内部にあり、通常はメディアとしてユーザーに表示されません。 これは、アプリケーションのアンインストール時にこれらのファイルが削除されるという点で getFilesDir() に似ていますが、いくつかの重要な違いがあります。ユーザーがリムーバブル メディアを取り出すことができるため、共有ストレージが常に使用可能であるとは限りません。 メディアの状態は、Environment.getExternalStorageState(File) を使用して確認できます。 これらのファイルにはセキュリティは適用されません。 たとえば、Manifest.permission.WRITE_EXTERNAL_STORAGEを保持しているアプリケーションは、これらのファイルに書き込むことができます。 共有ストレージ デバイスがエミュレートされている場合 (Environment.isExternalStorageEmulated(File) によって決定されます)、その内容はプライベート ユーザー データ パーティションによってサポートされます。つまり、getFilesDir() によって返されるプライベート ディレクトリではなく、ここにデータを格納する利点はほとんどありません。ここで返される共有ストレージ デバイスは、保護カバーの下の物理メディア スロットなど、デバイスの安定した部分と見なされます。 返されるパスには、ハンドヘルド デバイスに接続されている USB フラッシュ ドライブなどの一時的なデバイスは含まれません。 アプリケーションは、返されたデバイスの一部または全部にデータを格納できます。 たとえば、アプリでは、StatFs によって測定される、使用可能な領域が最も多いデバイスに大きなファイルを格納することを選択できます。 呼び出し元のアプリが、返されたパスの下のファイルを読み書きするために、追加のアクセス許可は必要ありません。 セカンダリ外部ストレージ デバイスでは、これらのパス以外の書き込みアクセスは使用できません。 異なる共有ストレージ メディアが挿入されると、返されるパスが時間の経過と同時に変化する可能性があるため、相対パスのみを保持する必要があります。 パラメーターの型文字列: 返すファイル ディレクトリの型。 ファイル ディレクトリのルートの場合は null、サブディレクトリの場合は次のいずれかの定数を使用できます。Environment.DIRECTORY_MUSIC、Environment.DIRECTORY_PODCASTS、Environment.DIRECTORY_RINGTONES、Environment.DIRECTORY_ALARMS、Environment.DIRECTORY_NOTIFICATIONS、Environment.DIRECTORY_PICTURES、またはEnvironment.DIRECTORY_MOVIES。 アプリケーション固有のディレクトリへの絶対パスである File[] を返します。 共有ストレージが現在使用できない場合、一部の個々のパスは null になる可能性があります。 返される最初のパスは、getExternalFilesDir(String) と同じです。

属性

RegisterAttribute

注釈

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

Javaドキュメント。