Context.GetExternalFilesDir(String) メソッド

定義

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

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

[Android.Runtime.Register("getExternalFilesDir", "(Ljava/lang/String;)Ljava/io/File;", "GetGetExternalFilesDir_Ljava_lang_String_Handler")]
public abstract Java.IO.File? GetExternalFilesDir(string? type);
[<Android.Runtime.Register("getExternalFilesDir", "(Ljava/lang/String;)Ljava/io/File;", "GetGetExternalFilesDir_Ljava_lang_String_Handler")>]
abstract member GetExternalFilesDir : string -> Java.IO.File

パラメーター

type
String

返すファイル ディレクトリの種類。 ファイル ディレクトリのルート、またはサブディレクトリのnull、android.os.Environment#DIRECTORY_MUSIC、android.os.Environment#DIRECTORY_PODCASTS、android.os.Environment#DIRECTORY_RINGTONES、android.os.Environment#DIRECTORY_ALARMS、android.os.Environment#DIRECTORY_NOTIFICATIONS、またはandroid.os.Environment#DIRECTORY_PICTURESのいずれかの定数をandroid.os.Environment#DIRECTORY_MOVIESできます。

返品

File

アプリケーション固有のディレクトリへの絶対パス。 共有ストレージが現在使用できない場合は、 null が返されることがあります。

属性
RegisterAttribute

注釈

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

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

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

android.os.Build.VERSION_CODES#KITKAT以降、返されたパスの読み取りまたは書き込みにアクセス許可は必要ありません。呼び出し元のアプリから常にアクセスできます。 これは、呼び出し元アプリケーションのパッケージ名に対して生成されたパスにのみ適用されます。 他のパッケージに属するパスにアクセスするには、 android.Manifest.permission#WRITE_EXTERNAL_STORAGE または android.Manifest.permission#READ_EXTERNAL_STORAGE が必要です。

( UserManagerで説明されているように) 複数のユーザーを持つデバイスでは、各ユーザーは独自の分離された共有ストレージを持っています。 アプリケーションは、実行しているユーザーの共有ストレージにのみアクセスできます。

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

アプリケーションの共有ストレージ内のファイルを操作する一般的なコードの例を次に示します。

{

Javaドキュメント。

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

適用対象

こちらもご覧ください