Context.GetExternalFilesDirs(String) メソッド

  • リファレンス

定義

名前空間:
Android.Content
アセンブリ:
Mono.Android.dll

アプリケーションが所有する永続ファイルを配置できる、すべての共有/外部ストレージ デバイス上のアプリケーション固有のディレクトリへの絶対パスを返します。

[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_MUSICandroid.os.Environment#DIRECTORY_PODCASTSandroid.os.Environment#DIRECTORY_RINGTONESandroid.os.Environment#DIRECTORY_ALARMSandroid.os.Environment#DIRECTORY_NOTIFICATIONSandroid.os.Environment#DIRECTORY_PICTURESandroid.os.Environment#DIRECTORY_MOVIES

戻り値

File[]

アプリケーション固有のディレクトリへの絶対パス。 一部の個別のパスは、 null その共有ストレージが現在使用できない場合があります。 返される最初の #getExternalFilesDir(String)パスは.

属性
RegisterAttribute

注釈

アプリケーションが所有する永続ファイルを配置できる、すべての共有/外部ストレージ デバイス上のアプリケーション固有のディレクトリへの絶対パスを返します。 これらのファイルはアプリケーションの内部にあり、通常はメディアとしてユーザーに表示されません。

これは、アプリケーションをアンインストールするとこれらのファイルが削除されるという点に似ています #getFilesDir() が、いくつかの重要な違いがあります。 <ul><li>Shared Storage は、ユーザーがリムーバブル メディアを取り出すことができるため、常に使用できるわけではありません。 メディアの状態は Environment#getExternalStorageState(File)、 <li>これらのファイルにはセキュリティは適用されません。 たとえば、保持しているアプリケーション android.Manifest.permission#WRITE_EXTERNAL_STORAGE は、これらのファイルに書き込むことができます。 </ul>

共有ストレージ デバイスがエミュレートされた場合 (決定された Environment#isExternalStorageEmulated(File)とおり)、その内容はプライベート ユーザー データ パーティションによってサポートされます。つまり、返される #getFilesDir()プライベート ディレクトリではなく、ここにデータを格納する利点はほとんどありません。

ここで返される共有ストレージ デバイスは、保護カバーの下の物理メディア スロットなど、デバイスの安定した部分と見なされます。 返されるパスには、ハンドヘルド デバイスに接続されている USB フラッシュ ドライブなどの一時的なデバイスは含まれません。

アプリケーションは、返されたデバイスの一部または全部にデータを格納できます。 たとえば、アプリでは、デバイスに大きなファイルを保存し、使用可能な領域が最も多い場合があります。次のように指定します StatFs。

呼び出し元のアプリが、返されたパスの下のファイルを読み書きするために、追加のアクセス許可は必要ありません。 セカンダリ外部ストレージ デバイスでは、これらのパス以外の書き込みアクセスは使用できません。

異なる共有ストレージ メディアが挿入されると、返されるパスが時間の経過と同時に変化する可能性があるため、相対パスのみを保持する必要があります。

の Java ドキュメントandroid.content.Context.getExternalFilesDirs(java.lang.String)

このページの一部は、Android オープンソース プロジェクトによって作成および共有され、クリエイティブ コモンズ 2.5 属性ライセンスに記載されている条件に従って使用される作業に基づく変更です。

適用対象

こちらもご覧ください