IUserDefinedFileAttributeView.Write(String, ByteBuffer) 方法
定義
重要
部分資訊涉及發行前產品,在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊,不做任何明確或隱含的瑕疵擔保。
從緩衝區寫入使用者定義屬性的值。
[Android.Runtime.Register("write", "(Ljava/lang/String;Ljava/nio/ByteBuffer;)I", "GetWrite_Ljava_lang_String_Ljava_nio_ByteBuffer_Handler:Java.Nio.FileNio.Attributes.IUserDefinedFileAttributeViewInvoker, Mono.Android, Version=0.0.0.0, Culture=neutral, PublicKeyToken=null", ApiSince=26)]
public int Write(string? name, Java.Nio.ByteBuffer? src);
[<Android.Runtime.Register("write", "(Ljava/lang/String;Ljava/nio/ByteBuffer;)I", "GetWrite_Ljava_lang_String_Ljava_nio_ByteBuffer_Handler:Java.Nio.FileNio.Attributes.IUserDefinedFileAttributeViewInvoker, Mono.Android, Version=0.0.0.0, Culture=neutral, PublicKeyToken=null", ApiSince=26)>]
abstract member Write : string * Java.Nio.ByteBuffer -> int
參數
- name
- String
屬性名稱
- src
- ByteBuffer
包含屬性值的緩衝區
傳回
寫入的位元組數,可能是零
- 屬性
備註
從緩衝區寫入使用者定義屬性的值。
此方法將屬性值從給定緩衝區寫入一串位元組。 要傳輸的值大小為 r,其中 r 是緩衝區中剩餘的位元組數,即 src.remaining()。 位元組序列從緩衝區從索引 p開始傳輸,其中 p 是緩衝區的位置。 返回時,緩衝區的位置將等 p + n於 ,其中 n 是傳輸的位元組數;其限制不會改變。
如果名稱的屬性已經存在,則其值會被替換。 如果該屬性不存在,則該屬性被創造出來。 如果是實作特定的測試,以檢查屬性的存在性以及屬性建立,這些測試是針對其他檔案系統活動進行的原子性測試。
當無法儲存屬性,或屬性名稱或值超過實作特定的最大大小時,會拋出 a IOException 。
<b>使用範例:</b> 假設我們想將檔案的 MIME 類型寫成使用者定義屬性:
UserDefinedFileAttributeView view =
FIles.getFileAttributeView(path, UserDefinedFileAttributeView.class);
view.write("user.mimetype", Charset.defaultCharset().encode("text/html"));
本頁部分內容為基於 Open Source Project 所創建與分享的作品,並依授權條款所描述的使用進行修改。