IUserDefinedFileAttributeView 介面

定義

[Android.Runtime.Register("java/nio/file/attribute/UserDefinedFileAttributeView", "", "Java.Nio.FileNio.Attributes.IUserDefinedFileAttributeViewInvoker", ApiSince=26)]
public interface IUserDefinedFileAttributeView : IDisposable, Java.Interop.IJavaPeerable, Java.Nio.FileNio.Attributes.IFileAttributeView

[<Android.Runtime.Register("java/nio/file/attribute/UserDefinedFileAttributeView", "", "Java.Nio.FileNio.Attributes.IUserDefinedFileAttributeViewInvoker", ApiSince=26)>]
type IUserDefinedFileAttributeView = interface
    interface IFileAttributeView
    interface IAttributeView
    interface IJavaObject
    interface IDisposable
    interface IJavaPeerable

屬性

RegisterAttribute

實作

IJavaObject IJavaPeerable IAttributeView IFileAttributeView IDisposable

備註

檔案屬性檢視，提供檔案使用者定義屬性的視圖，有時稱為 <em>extended attributes</em>。 使用者自訂的檔案屬性用於儲存與檔案系統無意義的檔案中的元資料。 它主要用於直接支援此類功能的檔案系統實作，但也可進行模擬。 此類模擬的細節高度依賴實作，因此未明確說明。

此介面 FileAttributeView 提供檔案使用者定義屬性的視圖，表示一組名稱/值對，其中屬性名稱以 String表示。 實作時可能需要在存取屬性時，從平台或檔案系統的表示方式編碼並解碼。 該數值內容不透明。 此屬性視圖定義了 和 #read read#write write 方法，用來將值讀入或從 寫入 ByteBuffer。 此方法 FileAttributeView 不適用於屬性值大小大於 Integer#MAX_VALUE的情況。

在某些實作中，使用者定義屬性可用來儲存與安全相關的屬性，因此，至少在預設提供者的情況下，所有存取使用者定義屬性的方法在安裝安全管理器時都需要該 RuntimePermission("accessUserDefinedAttributes") 權限。

此 java.nio.file.FileStore#supportsFileAttributeView supportsFileAttributeView 方法可用來測試特定 java.nio.file.FileStore FileStore 功能是否支援儲存使用者定義屬性。

當需要動態存取檔案屬性時， java.nio.file.Files#getAttribute getAttribute 可使用此方法讀取屬性值。 屬性值會以位元組陣列（byte[]）的形式回傳。 此 java.nio.file.Files#setAttribute setAttribute 方法可用於從緩衝區（如 #write write 同呼叫該方法）或位元組陣列（byte[]）寫入使用者定義屬性的值。

在 1.7 版本中加入。

的 java.nio.file.attribute.UserDefinedFileAttributeViewJava 檔。

此頁面的部分是根據 Android 開放原始碼專案所建立和共用的工作進行修改，並根據 Creative Commons 2.5 屬性授權中所述的詞彙使用。