Environment.ExternalStorageDirectory プロパティ
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
プライマリ共有/外部ストレージ ディレクトリを返します。
public static Java.IO.File? ExternalStorageDirectory { [Android.Runtime.Register("getExternalStorageDirectory", "()Ljava/io/File;", "")] get; }
[<get: Android.Runtime.Register("getExternalStorageDirectory", "()Ljava/io/File;", "")>]
static member ExternalStorageDirectory : Java.IO.File
プロパティ値
- 属性
注釈
プライマリ共有/外部ストレージ ディレクトリを返します。 このディレクトリは、ユーザーがコンピューターにマウントされている場合、デバイスから削除された場合、または他の問題が発生した場合は、現在アクセスできない可能性があります。 を使用して、現在の状態を #getExternalStorageState()
確認できます。
<em>注: ここで"external"という単語で混乱しないでください。 このディレクトリは、メディア/共有ストレージと考える方が適しています。 これは、比較的大量のデータを保持でき、すべてのアプリケーションで共有されるファイルシステムです (アクセス許可は適用されません)。 従来は SD カードですが、保護された内部ストレージとは異なり、コンピューター上のファイルシステムとしてマウントできるデバイスに組み込みのストレージとして実装することもできます。</Em>
複数のユーザーを持つデバイス (で UserManager
説明されているように) では、各ユーザーは独自の分離された共有ストレージを持っています。 アプリケーションは、実行しているユーザーの共有ストレージにのみアクセスできます。
複数の共有/外部ストレージ ディレクトリを持つデバイスでは、このディレクトリは、ユーザーが操作するプライマリ ストレージを表します。 セカンダリ ストレージへのアクセスは、、Context#getExternalCacheDirs()
、および Context#getExternalMediaDirs()
を介してContext#getExternalFilesDirs(String)
使用できます。
アプリケーションでは、ユーザーのルート名前空間が汚染されないように、この最上位レベルのディレクトリを直接使用しないでください。 アプリケーションに対してプライベートなファイルは、 によって android.content.Context#getExternalFilesDir Context.getExternalFilesDir
返されるディレクトリに配置する必要があります。このディレクトリは、アプリケーションがアンインストールされた場合にシステムによって削除されます。 他の共有ファイルは、 によって #getExternalStoragePublicDirectory
返されるディレクトリのいずれかに配置する必要があります。
このパスに書き込むにはアクセス許可が android.Manifest.permission#WRITE_EXTERNAL_STORAGE
必要です android.os.Build.VERSION_CODES#KITKAT
。読み取りアクセスには アクセス許可が必要 android.Manifest.permission#READ_EXTERNAL_STORAGE
です。読み取りアクセス許可は、書き込みアクセス許可を保持している場合に自動的に付与されます。
以降では、アプリケーションでandroid.os.Build.VERSION_CODES#KITKAT
内部データのみを格納する必要がある場合は、読み取りまたは書き込みへのアクセス許可を必要としない 、Context#getExternalCacheDir()
、または Context#getExternalMediaDirs()
を使用Context#getExternalFilesDir(String)
することを検討してください。
このパスはプラットフォームのバージョン間で変更される可能性があるため、アプリケーションは相対パスのみを保持する必要があります。
外部ストレージの状態を監視する一般的なコードの例を次に示します。
{
の android.os.Environment.getExternalStorageDirectory()
Java ドキュメント。
このページの一部は、によって作成および共有された作業に基づく変更であり、に記載されている条件に従って使用されます。