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>Note: ここで "external" という単語に混同しないでください。 このディレクトリは、メディア/共有ストレージと考える方が適しています。 これは、比較的大量のデータを保持でき、すべてのアプリケーションで共有されるファイルシステムです (アクセス許可は適用されません)。 従来はSDカードですが、保護された内部ストレージとは異なり、コンピュータ上のファイルシステムとしてマウントできるデバイスに組み込みストレージとして実装することもできます</em>
( UserManagerで説明されているように) 複数のユーザーを持つデバイスでは、各ユーザーは独自の分離された共有ストレージを持っています。 アプリケーションは、実行しているユーザーの共有ストレージにのみアクセスできます。
複数の共有/外部ストレージ ディレクトリを持つデバイスでは、このディレクトリは、ユーザーが操作するプライマリ ストレージを表します。 セカンダリ ストレージへのアクセスは、 Context#getExternalFilesDirs(String)、 Context#getExternalCacheDirs()、および Context#getExternalMediaDirs()を通じて利用できます。
アプリケーションでは、ユーザーのルート名前空間が汚染されないようにするために、この最上位ディレクトリを直接使用しないでください。 アプリケーションに対してプライベートなファイルは、 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#getExternalFilesDir(String)、Context#getExternalCacheDir()、またはContext#getExternalMediaDirs()の使用を検討してください。
このパスはプラットフォームのバージョン間で変更される可能性があるため、アプリケーションは相対パスのみを保持する必要があります。
外部ストレージの状態を監視する一般的なコードの例を次に示します。
{
このページの一部は、によって作成および共有され、に記載されている条件に従って使用される作業に基づく変更です。