Properties.Store 方法

定義

命名空間:: Java.Util

組件:: Mono.Android.dll

重要

部分資訊涉及發行前產品，在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊，不做任何明確或隱含的瑕疵擔保。

多載

名稱	Description
Store(Writer, String)	將此 `Properties` 表中的屬性清單（鍵與元素對）以適合使用該 `#load(java.io.Reader) load(Reader)` 方法的格式寫入輸出字元流。
Store(Stream, String)	將此表中的`Properties`屬性清單（鍵與元素對）寫入輸出串流，格式適合使用此`Properties`方法載入`#load(InputStream) load(InputStream)`資料表。

Store(Writer, String)

將此 Properties 表中的屬性清單（鍵與元素對）以適合使用該 #load(java.io.Reader) load(Reader) 方法的格式寫入輸出字元流。

[Android.Runtime.Register("store", "(Ljava/io/Writer;Ljava/lang/String;)V", "GetStore_Ljava_io_Writer_Ljava_lang_String_Handler")]
public virtual void Store(Java.IO.Writer? writer, string? comments);

[<Android.Runtime.Register("store", "(Ljava/io/Writer;Ljava/lang/String;)V", "GetStore_Ljava_io_Writer_Ljava_lang_String_Handler")>]
abstract member Store : Java.IO.Writer * string -> unit
override this.Store : Java.IO.Writer * string -> unit

參數

writer: Writer

輸出字元流編入器。

comments: String

房產清單說明。

屬性: RegisterAttribute

例外狀況

ClassCastException

若鍵或值不是字串

IOException

備註

將此 Properties 表中的屬性清單（鍵與元素對）以適合使用該 #load(java.io.Reader) load(Reader) 方法的格式寫入輸出字元流。

此表預設表 Properties 中的屬性（若有）不會被此方法寫出。

若註解參數非空，則先寫入 ASCII # 字元、註解字串及行分隔符至輸出串流。因此，這 comments 句話可以作為識別性評論。任何換行符（'\n'）、回車（'\r'）或註解中緊接換行的換行符，都被由產生的 Writer 行分隔符取代，若註解中的下一個字元不是字元 # 或字元 ! ，則在該行分隔符後會寫出 ASCII # 。

接著，必定寫入註解行，包含一個 ASCII # 字元、當前日期與時間（如同由 toString 的方法 Date 產生的當前時間），以及由 Writer產生的行分隔符。

然後這個表格中的 Properties 每個項目都會寫出來，每行一個。每個項目先寫入鍵串，接著寫入 ASCII， =接著寫入相關元素字串。對於鍵，所有空格字元前置一個 \ 字元。對於元素，前置空格字元（不含嵌入或後置空格字元）是以前 \ 置字元書寫的。鍵與元素字元 #、 !、 =以及 : 會以前斜線書寫，以確保它們正確載入。

在寫入這些項目後，輸出串流會被清除。此方法返回後，輸出串流仍保持開啟。

新增於1.6版本。

Java 文件 java.util.Properties.store(java.io.Writer, java.lang.String)。

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

適用於

Store(Stream, String)

將此表中的Properties屬性清單（鍵與元素對）寫入輸出串流，格式適合使用此Properties方法載入#load(InputStream) load(InputStream)資料表。

[Android.Runtime.Register("store", "(Ljava/io/OutputStream;Ljava/lang/String;)V", "GetStore_Ljava_io_OutputStream_Ljava_lang_String_Handler")]
public virtual void Store(System.IO.Stream? out, string? comments);

[<Android.Runtime.Register("store", "(Ljava/io/OutputStream;Ljava/lang/String;)V", "GetStore_Ljava_io_OutputStream_Ljava_lang_String_Handler")>]
abstract member Store : System.IO.Stream * string -> unit
override this.Store : System.IO.Stream * string -> unit

參數

out: Stream

一個輸出流。

comments: String

房產清單說明。

屬性: RegisterAttribute

例外狀況

ClassCastException

若鍵或值不是字串

IOException

備註

將此表中的Properties屬性清單（鍵與元素對）寫入輸出串流，格式適合使用此Properties方法載入#load(InputStream) load(InputStream)資料表。

此表預設表 Properties 中的屬性（若有）不會被此方法寫出。

此方法輸出註解、屬性鍵與值的格式與中 #store(java.io.Writer, java.lang.String) store(Writer)指定的相同，但有以下差異： <ul><li>串流是使用 ISO 8859-1 字元編碼寫入的。

<li>留言中非拉丁字母 1 的字元會以 \u005Cuxxxx 表示其適當的 Unicode 十六進位值 xxxx。

<li>屬性鍵或值中小於和 \u005Cu0020 大於的 \u005Cu007E 字元會寫成 \u005Cuxxxx 表示適當的十六進位值 xxxx。 </ul>

在寫入這些項目後，輸出串流會被清除。此方法返回後，輸出串流仍保持開啟。

在 1.2 版本中加入。

Java 文件 java.util.Properties.store(java.io.OutputStream, java.lang.String)。

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

適用於