StorageVolume クラス

定義

名前空間:: Android.OS.Storage

アセンブリ:: Mono.Android.dll

重要

一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。

特定のユーザーの共有/外部ストレージボリュームに関する情報。

[Android.Runtime.Register("android/os/storage/StorageVolume", ApiSince=24, DoNotGenerateAcw=true)]
public sealed class StorageVolume : Java.Lang.Object, Android.OS.IParcelable, IDisposable

[<Android.Runtime.Register("android/os/storage/StorageVolume", ApiSince=24, DoNotGenerateAcw=true)>]
type StorageVolume = class
    inherit Object
    interface IParcelable
    interface IJavaObject
    interface IDisposable
    interface IJavaPeerable

継承: Object

JavaObject

Object
StorageVolume

属性: RegisterAttribute

実装: IParcelable IJavaObject IJavaPeerable IDisposable

注釈

特定のユーザーの共有/外部ストレージボリュームに関する情報。

デバイスには常にプライマリストレージボリュームが 1 つ (および 1 つだけ) ありますが、SD カードや USB ドライブなどの追加のボリュームが存在する可能性があります。このオブジェクトは、特定のユーザーのストレージボリュームの論理ビューを表します。異なるユーザーが同じ物理ボリュームに対して異なるビューを持つ場合があります (たとえば、ボリュームが組み込みのエミュレートされたストレージの場合)。

ストレージボリュームは必ずしもマウントされているわけではありません。アプリケーションでは、 #getState() を使用してその状態を確認する必要があります。

このストレージボリュームの読み取りまたは書き込みを行うアプリケーションは、まずユーザーからアクセス許可を取得する必要があります。これは、次の方法で実現できます。

<ul><li>標準ディレクトリ ( Environment#DIRECTORY_PICTURES など) にアクセスするには、 #createAccessIntent(String)を使用できます。これは、より単純な API を提供し、特定のディレクトリ (およびその子孫) へのアクセスを絞り込むため、推奨される方法です。 <li>任意のディレクトリ (およびその子孫) にアクセスするには、Storage Access Framework API ( Intent#ACTION_OPEN_DOCUMENT や Intent#ACTION_OPEN_DOCUMENT_TREE など) を使用できますが、これらの API はユーザーがこの特定のボリュームを選択することを保証するものではありません。 <li>プライマリストレージボリュームに対する読み取りと書き込みのアクセス権を取得するには、アプリケーションで、 android.Manifest.permission#READ_EXTERNAL_STORAGE と android.Manifest.permission#WRITE_EXTERNAL_STORAGE のアクセス許可をそれぞれ宣言できます。後者は前者を含みます。ユーザーは、ストレージデバイスに含まれるすべてのファイルへの広範なアクセスを許可することをためらう可能性があるため、この方法はお勧めしません。 </ul>

これは、 StorageManager#getStorageVolumes() と StorageManager#getPrimaryStorageVolume() を介して取得することができ、また、いくつかの放送で余分として( #EXTRA_STORAGE_VOLUME参照)。

共有/外部ストレージセマンティクスの詳細については、「 Environment#getExternalStorageDirectory() 」を参照してください。

Javaドキュメント。

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

フィールド

名前	説明
ExtraStorageVolume	`Parcelable`を含む`Intent#ACTION_MEDIA_REMOVED`、`Intent#ACTION_MEDIA_UNMOUNTED`、`Intent#ACTION_MEDIA_CHECKING`、`Intent#ACTION_MEDIA_NOFS`、`Intent#ACTION_MEDIA_MOUNTED`、`Intent#ACTION_MEDIA_SHARED`、`Intent#ACTION_MEDIA_BAD_REMOVAL`、`Intent#ACTION_MEDIA_UNMOUNTABLE`、および`Intent#ACTION_MEDIA_EJECT`ブロードキャストの追加の`StorageVolume`の名前。

プロパティ

名前	説明
Class	この `Object`のランタイムクラスを返します。 (継承元 Object)
Creator	特定のユーザーの共有/外部ストレージボリュームに関する情報。
Directory	このボリュームが現在マウントされているディレクトリを返します。
Handle	基になる Android インスタンスへのハンドル。 (継承元 Object)
IsEmulated	ボリュームがエミュレートされている場合は true を返します。
IsPrimary	ボリュームがプライマリ共有/外部ストレージ ( `Environment#getExternalStorageDirectory()`によってバックアップされたボリューム) の場合は true を返します。
IsRemovable	ボリュームがリムーバブルである場合は true を返します。
JniIdentityHashCode	相互運用ランタイムによってこのJava ピアに割り当てられた ID ハッシュコードを取得します。 (継承元 Object)
JniManagedPeerState	特定のユーザーの共有/外部ストレージボリュームに関する情報。 (継承元 JavaObject)
JniPeerMembers	特定のユーザーの共有/外部ストレージボリュームに関する情報。
MediaStoreVolumeName	`MediaStore`を介してこのストレージデバイスとの対話に使用できるボリューム名を返します。
Owner	このボリュームを所有するユーザーを返します
PeerReference	このJava ピアの JNI オブジェクト参照を取得します。 (継承元 Object)
State	ボリュームの現在の状態を返します。
StorageUuid	変換されたボリューム UUID を取得します。
ThresholdClass	この API は Android 用 Mono インフラストラクチャをサポートしており、コードから直接使用するためのものではありません。 (継承元 Object)
ThresholdType	この API は Android 用 Mono インフラストラクチャをサポートしており、コードから直接使用するためのものではありません。 (継承元 Object)
Uuid	ボリューム UUID (存在する場合) を取得します。

メソッド

名前	説明
Clone()	このオブジェクトのコピーを作成して返します。 (継承元 Object)
Construct(JniObjectReference, JniObjectReferenceOptions)	特定のユーザーの共有/外部ストレージボリュームに関する情報。 (継承元 JavaObject)
CreateAccessIntent(String)	ユーザーの承認を取得した後、Standard Storage ディレクトリまたはボリューム全体へのアクセス権を付与する意図を構築します。
CreateOpenDocumentTreeIntent()	ユーザーがデバイスで使用可能な`Intent#ACTION_OPEN_DOCUMENT_TREE`から任意のディレクトリサブツリー (またはボリューム全体) へのアクセスを許可できるようにする`android.provider.DocumentsProvider`を構築します。
DescribeContents()	特定のユーザーの共有/外部ストレージボリュームに関する情報。
Dispose()	このJava ピアによって保持されているリソースを解放します。 (継承元 Object)
Dispose(Boolean)	このJava ピアによって保持されているリソースを解放します。 (継承元 Object)
DisposeUnlessReferenced()	特定のユーザーの共有/外部ストレージボリュームに関する情報。 (継承元 JavaObject)
Equals(Object)	特定のユーザーの共有/外部ストレージボリュームに関する情報。 (継承元 JavaObject)
Equals(Object)	他のオブジェクトがこのオブジェクトと "等しい" かどうかを示します。 (継承元 Object)
GetDescription(Context)	ボリュームのユーザーに表示される説明を返します。
GetHashCode()	オブジェクトのハッシュコード値を返します。 (継承元 Object)
JavaFinalize()	オブジェクトへの参照がなくなったとガベージコレクションによって判断されたときに、オブジェクトのガベージコレクターによって呼び出されます。 (継承元 Object)
Notify()	このオブジェクトのモニターで待機している 1 つのスレッドを起動します。 (継承元 Object)
NotifyAll()	このオブジェクトのモニターで待機しているすべてのスレッドを起動します。 (継承元 Object)
SetHandle(IntPtr, JniHandleOwnership)	Handle プロパティを設定します。 (継承元 Object)
SetPeerReference(JniObjectReference, JniObjectReferenceOptions)	特定のユーザーの共有/外部ストレージボリュームに関する情報。 (継承元 JavaObject)
ToArray<T>()	このJava配列ラッパーからマネージド配列を作成します。 (継承元 Object)
ToString()	オブジェクトの文字列形式を返します。 (継承元 Object)
UnregisterFromRuntime()	相互運用ランタイムからこのJava ピアの登録を解除します。 (継承元 Object)
Wait()	現在のスレッドが起動するまで待機します。通常は、 <em>notified</em> または <em>interrupted</em>。 (継承元 Object)
Wait(Int64, Int32)	現在のスレッドは、通常、 <em>notified</em> または <em>interrupted</em>、または一定のリアルタイムが経過するまで、起動されるまで待機します。 (継承元 Object)
Wait(Int64)	現在のスレッドは、通常、 <em>notified</em> または <em>interrupted</em>、または一定のリアルタイムが経過するまで、起動されるまで待機します。 (継承元 Object)
WriteToParcel(Parcel, ParcelableWriteFlags)	特定のユーザーの共有/外部ストレージボリュームに関する情報。

明示的なインターフェイスの実装

名前	説明
IJavaPeerable.Disposed()	特定のユーザーの共有/外部ストレージボリュームに関する情報。 (継承元 JavaObject)
IJavaPeerable.Finalized()	特定のユーザーの共有/外部ストレージボリュームに関する情報。 (継承元 JavaObject)
IJavaPeerable.JniObjectReferenceControlBlock	特定のユーザーの共有/外部ストレージボリュームに関する情報。 (継承元 JavaObject)
IJavaPeerable.SetJniIdentityHashCode(Int32)	特定のユーザーの共有/外部ストレージボリュームに関する情報。 (継承元 JavaObject)
IJavaPeerable.SetJniManagedPeerState(JniManagedPeerStates)	特定のユーザーの共有/外部ストレージボリュームに関する情報。 (継承元 JavaObject)
IJavaPeerable.SetPeerReference(JniObjectReference)	特定のユーザーの共有/外部ストレージボリュームに関する情報。 (継承元 JavaObject)
IJavaPeerable.UnregisterFromRuntime()	特定のユーザーの共有/外部ストレージボリュームに関する情報。

拡張メソッド

名前	説明
GetJniTypeName(IJavaPeerable)	インスタンス `self`の型の JNI 名を取得します。
JavaAs<TResult>(IJavaPeerable)	`self`を強制的に`TResult`入力し、強制型がJava側で有効であることを確認します。
JavaCast<TResult>(IJavaObject)	Android ランタイムチェック型変換を実行します。
JavaCast<TResult>(IJavaObject)	特定のユーザーの共有/外部ストレージボリュームに関する情報。
TryJavaCast<TResult>(IJavaPeerable, TResult)	`self`を強制的に`TResult`入力し、強制型がJava側で有効であることを確認します。

適用対象