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

備註

關於特定使用者共用/外部儲存磁碟區的資訊。

裝置總是只有一個（且只有一個）主要儲存區，但也可能有額外的磁碟區，比如 SD 卡和 USB 隨身碟。此物件代表特定使用者對儲存卷的邏輯視圖：不同使用者可能對同一實體卷有不同的視圖（例如，若該卷是內建模擬儲存）。

儲存磁碟區不一定是掛載的，應用程式應用 #getState() 來驗證其狀態。

願意讀寫此儲存卷的應用程式必須先取得使用者的許可，這可以透過以下方式達成：

<ul><li>要存取標準目錄（例如）， Environment#DIRECTORY_PICTURES他們可以使用 #createAccessIntent(String)。這是推薦的方式，因為它提供更簡單的 API，並縮小對指定目錄（及其後代）的存取範圍。 <li>為了存取任何目錄（及其後代），他們可以使用儲存存取框架的 API（例如 Intent#ACTION_OPEN_DOCUMENT 和 Intent#ACTION_OPEN_DOCUMENT_TREE，但這些 API 並不保證使用者一定會選擇這個特定磁碟區。 <為了>取得主儲存卷的讀寫權限，應用程式可以分別宣告 android.Manifest.permission#READ_EXTERNAL_STORAGE 與 android.Manifest.permission#WRITE_EXTERNAL_STORAGE 權限，後者包含前者。這種做法不被鼓勵，因為使用者可能對儲存裝置中所有檔案的廣泛存取持保留態度。 </ul>

它可以透過和，以及在某些廣播中作為額外內容獲得StorageManager#getStorageVolumes()StorageManager#getPrimaryStorageVolume()（參見）。#EXTRA_STORAGE_VOLUME

關於共享/外部儲存語意的更多資訊，請參見 Environment#getExternalStorageDirectory() 。

Java 文件 android.os.storage.StorageVolume。

本頁部分內容為基於 Open Source Project 所創建與分享的作品，並依授權條款所描述的使用進行修改。

欄位

名稱	Description
ExtraStorageVolume	`Parcelable`在廣播中`Intent#ACTION_MEDIA_REMOVED`包含 `Intent#ACTION_MEDIA_UNMOUNTED`的， `Intent#ACTION_MEDIA_CHECKING`， `Intent#ACTION_MEDIA_NOFS`， `Intent#ACTION_MEDIA_MOUNTEDIntent#ACTION_MEDIA_SHAREDIntent#ACTION_MEDIA_BAD_REMOVAL`， `Intent#ACTION_MEDIA_UNMOUNTABLE`，，， `Intent#ACTION_MEDIA_EJECTStorageVolume`

屬性

名稱	Description
Class	回傳此 `Object`的執行時類別。 (繼承來源 Object)
Creator	關於特定使用者共用/外部儲存磁碟區的資訊。
Directory	回傳該磁碟區目前掛載的目錄。
Handle	底層 Android 實例的帳號。 (繼承來源 Object)
IsEmulated	如果是模擬音量，則會回傳真值。
IsPrimary	若該卷是主要的共享/外部儲存，則回傳為真，而該磁碟區由。`Environment#getExternalStorageDirectory()`
IsRemovable	如果音量是可移除的，則會回傳為真。
JniIdentityHashCode	取得由互通執行時指派給此 Java 對等端的身份雜湊碼。 (繼承來源 Object)
JniManagedPeerState	關於特定使用者共用/外部儲存磁碟區的資訊。 (繼承來源 JavaObject)
JniPeerMembers	關於特定使用者共用/外部儲存磁碟區的資訊。
MediaStoreVolumeName	回傳可用來與此儲存裝置互動的 `MediaStore`磁碟區名稱。
Owner	回傳擁有此卷的使用者
PeerReference	取得這個 Java 節點的 JNI 物件參考。 (繼承來源 Object)
State	回傳該磁碟區目前的狀態。
StorageUuid	取得轉換後的體積 UUID。
ThresholdClass	此 API 支援 Mono for Android 基礎架構，並非直接從你的程式碼中使用。 (繼承來源 Object)
ThresholdType	此 API 支援 Mono for Android 基礎架構，並非直接從你的程式碼中使用。 (繼承來源 Object)
Uuid	如果有的話，會取得音量 UUID。

方法

名稱	Description
Clone()	建立並回傳此物件的副本。 (繼承來源 Object)
Construct(JniObjectReference, JniObjectReferenceOptions)	關於特定使用者共用/外部儲存磁碟區的資訊。 (繼承來源 JavaObject)
CreateAccessIntent(String)	建立一個意圖，在取得使用者批准後，允許存取標準儲存目錄或整個磁碟區。
CreateOpenDocumentTreeIntent()	建置並 `Intent#ACTION_OPEN_DOCUMENT_TREE` 允許使用者從裝置上可用的 s 中授權存取任何目錄子樹（或整個磁碟區 `android.provider.DocumentsProvider`）。
DescribeContents()	描述此 Parcelable 實例的分組表示中包含的特殊物件種類。
Dispose()	釋放該 Java 節點所持有的資源。 (繼承來源 Object)
Dispose(Boolean)	釋放該 Java 節點所持有的資源。 (繼承來源 Object)
DisposeUnlessReferenced()	關於特定使用者共用/外部儲存磁碟區的資訊。 (繼承來源 JavaObject)
Equals(Object)	關於特定使用者共用/外部儲存磁碟區的資訊。 (繼承來源 JavaObject)
Equals(Object)	表示是否有其他物體「等同」於此物。 (繼承來源 Object)
GetDescription(Context)	回傳使用者可見的磁碟描述。
GetHashCode()	回傳物件的雜湊碼值。 (繼承來源 Object)
JavaFinalize()	已淘汰. 當垃圾回收判定該物件不再有相關參考時，由垃圾回收器呼叫。 (繼承來源 Object)
Notify()	喚醒一個正在該物件監視器上等待的執行緒。 (繼承來源 Object)
NotifyAll()	喚醒所有等待該物件監視器的執行緒。 (繼承來源 Object)
SetHandle(IntPtr, JniHandleOwnership)	設定 Handle 屬性。 (繼承來源 Object)
SetPeerReference(JniObjectReference, JniObjectReferenceOptions)	關於特定使用者共用/外部儲存磁碟區的資訊。 (繼承來源 JavaObject)
ToArray<T>()	從這個 Java 陣列包裝器建立一個受管理陣列。 (繼承來源 Object)
ToString()	回傳物件的字串表示。 (繼承來源 Object)
UnregisterFromRuntime()	將此 Java 節點從互通執行時中取消註冊。 (繼承來源 Object)
Wait()	導致目前執行緒等待被喚醒，通常是透過 <em>通知</><em 或 em>中斷</em> 來喚醒。 (繼承來源 Object)
Wait(Int64, Int32)	會讓目前執行緒等待喚醒，通常是透過 <em>通知</><em 或 em>中斷</em>，或是經過一定的真實時間。 (繼承來源 Object)
Wait(Int64)	會讓目前執行緒等待喚醒，通常是透過 <em>通知</><em 或 em>中斷</em>，或是經過一定的真實時間。 (繼承來源 Object)
WriteToParcel(Parcel, ParcelableWriteFlags)	將中的這個物件扁平化為 Parcel。

明確介面實作

名稱	Description
IJavaPeerable.Disposed()	關於特定使用者共用/外部儲存磁碟區的資訊。 (繼承來源 JavaObject)
IJavaPeerable.Finalized()	關於特定使用者共用/外部儲存磁碟區的資訊。 (繼承來源 JavaObject)
IJavaPeerable.JniObjectReferenceControlBlock	關於特定使用者共用/外部儲存磁碟區的資訊。 (繼承來源 JavaObject)
IJavaPeerable.SetJniIdentityHashCode(Int32)	關於特定使用者共用/外部儲存磁碟區的資訊。 (繼承來源 JavaObject)
IJavaPeerable.SetJniManagedPeerState(JniManagedPeerStates)	關於特定使用者共用/外部儲存磁碟區的資訊。 (繼承來源 JavaObject)
IJavaPeerable.SetPeerReference(JniObjectReference)	關於特定使用者共用/外部儲存磁碟區的資訊。 (繼承來源 JavaObject)
IJavaPeerable.UnregisterFromRuntime()	關於特定使用者共用/外部儲存磁碟區的資訊。

擴充方法

名稱	Description
GetJniTypeName(IJavaPeerable)	取得實例 `self`類型的 JNI 名稱。
JavaAs<TResult>(IJavaPeerable)	試著強制`self`輸入 `TResult`，檢查強制在 Java 端是否有效。
JavaCast<TResult>(IJavaObject)	執行 Android 執行時檢查型別轉換。
JavaCast<TResult>(IJavaObject)	關於特定使用者共用/外部儲存磁碟區的資訊。
TryJavaCast<TResult>(IJavaPeerable, TResult)	試著強制`self`輸入 `TResult`，檢查強制在 Java 端是否有效。

適用於