Properties 類別

定義

命名空間:

Java.Util

組件:

Mono.Android.dll

類別 Properties 代表一組永續性的屬性。

[Android.Runtime.Register("java/util/Properties", DoNotGenerateAcw=true)]
public class Properties : Java.Lang.Object

[<Android.Runtime.Register("java/util/Properties", DoNotGenerateAcw=true)>]
type Properties = class
    inherit Object

繼承

Object

Object

Properties

衍生

Java.Security.Provider

屬性

RegisterAttribute

備註

類別 Properties 代表一組永續性的屬性。 Properties可以儲存至數據流或從數據流載入。 屬性清單中的每個索引鍵及其對應的值都是字串。

屬性清單可以包含另一個屬性清單作為其「預設值」;如果在原始屬性清單中找不到屬性索引鍵，則會搜尋這個第二個屬性清單。

因為 Properties 繼承自 Hashtable， put 所以 和 putAll 方法可以套用至 Properties 物件。 強烈建議不要使用，因為它們允許呼叫端插入索引鍵或值不是 Strings的專案。 setProperty應該改用 方法。 store如果在包含非String索引鍵或值的「遭入侵」Properties物件上呼叫 或 save 方法，則呼叫將會失敗。 同樣地，如果在包含非String索引鍵的propertyNames「遭入侵」Properties物件上呼叫 或方法，呼叫 或 list 方法將會失敗。

方法 #load(java.io.Reader) load(Reader)/#store(java.io.Writer, java.lang.String) store(Writer, String) 會以下面指定的簡單行導向格式，從和載入和儲存屬性到以字元為基礎的數據流。

方法 #load(java.io.InputStream) load(InputStream)/#store(java.io.OutputStream, java.lang.String) store(OutputStream, String) 的運作方式與載入 (讀取器) /store (寫入器、字串) 配對相同，但輸入/輸出數據流是以 ISO 8859-1 字元編碼方式編碼。 無法直接在此編碼中表示的字元可以使用 Unicode 逸出來撰寫，如引用>Java&交易的第 3.3 <節所定義;語言規格</引用>;逸出序列中只允許單一 'u' 字元。 native2ascii 工具可用來將屬性檔轉換成其他字元編碼。

#loadFromXML(InputStream)和 #storeToXML(OutputStream, String, String) 方法會以簡單的 XML 格式載入和儲存屬性。 根據預設，會使用UTF-8字元編碼，但如有需要，可能會指定特定的編碼方式。 實作需要支援UTF-8和UTF-16，而且可能支援其他編碼。 XML 屬性檔具有下列 DOCTYPE 宣告：

<!DOCTYPE properties SYSTEM "http://java.sun.com/dtd/properties.dtd">

請注意，導出或匯入屬性時不會存取系統 URI (http://java.sun.com/dtd/properties.dtd);它只是做為字串來唯一識別 DTD，也就是：

<?xml version="1.0" encoding="UTF-8"?>

               <!-- DTD for properties -->

               <!ELEMENT properties ( comment?, entry* ) >

               <!ATTLIST properties version CDATA #FIXED "1.0">

               <!ELEMENT comment (#PCDATA) >

               <!ELEMENT entry (#PCDATA) >

               <!ATTLIST entry key CDATA #REQUIRED>

此類別是安全線程：多個線程可以共用單 Properties 一物件，而不需要外部同步處理。

已在 JDK1.0 中新增。

的 java.util.PropertiesJava 檔。

此頁面的部分是根據 所建立和共用的工作進行修改，並根據 2.5 屬性授權中所述的詞彙來使用。

建構函式

Properties()	建立不含預設值的空白屬性清單。
Properties(IntPtr, JniHandleOwnership)	建立 JNI 物件的 Managed 表示法時使用的建構函式;由運行時間呼叫。
Properties(Properties)	建立具有指定預設值的空白屬性清單。

屬性

Class	傳回這個 Object的運行時間類別。 (繼承來源 Object)
Defaults	屬性清單，其中包含此屬性清單中找不到之任何索引鍵的預設值。
Handle	基礎Android實例的句柄。 (繼承來源 Object)
JniIdentityHashCode	類別 Properties 代表一組永續性的屬性。 (繼承來源 Object)
JniPeerMembers	類別 Properties 代表一組永續性的屬性。
PeerReference	類別 Properties 代表一組永續性的屬性。 (繼承來源 Object)
ThresholdClass	此 API 支援適用於 Android 的 Mono 基礎結構，並不適合直接從您的程式代碼使用。
ThresholdType	此 API 支援適用於 Android 的 Mono 基礎結構，並不適合直接從您的程式代碼使用。

方法

Clone()	建立並傳回這個 對象的複本。 (繼承來源 Object)
Dispose()	類別 Properties 代表一組永續性的屬性。 (繼承來源 Object)
Dispose(Boolean)	類別 Properties 代表一組永續性的屬性。 (繼承來源 Object)
Equals(Object)	指出其他物件是否「等於」這個物件。 (繼承來源 Object)
GetHashCode()	傳回此物件的雜湊碼值。 (繼承來源 Object)
GetProperty(String)	在此屬性清單中搜尋具有指定索引鍵的屬性。
GetProperty(String, String)	在此屬性清單中搜尋具有指定索引鍵的屬性。
JavaFinalize()	當垃圾收集判斷物件不再參考物件時，垃圾收集行程會在物件上呼叫。 (繼承來源 Object)
List(PrintStream)	將此屬性清單列印到指定的輸出資料流。
List(PrintWriter)	將此屬性清單列印到指定的輸出資料流。
Load(Reader)	以簡單行導向格式從輸入字元數據流讀取屬性清單 (索引鍵和元素組) 。
Load(Stream)	從輸入位元組資料流讀取 (索引鍵和專案組) 的屬性清單。
LoadFromXML(Stream)	將指定之輸入數據流上 XML 檔所代表的所有屬性載入至這個屬性資料表。
Notify()	喚醒正在等候此物件監視器的單一線程。 (繼承來源 Object)
NotifyAll()	喚醒正在等候此物件監視器的所有線程。 (繼承來源 Object)
PropertyNames()	傳回此屬性清單中所有索引鍵的列舉，如果在主要屬性清單中找不到相同名稱的索引鍵，則包括預設屬性清單中的相異索引鍵。
Save(Stream, String)	已淘汰. store(OutputStream out, String comments)呼叫 方法，並隱藏擲回的 IOException。
SetHandle(IntPtr, JniHandleOwnership)	設定 Handle 屬性。 (繼承來源 Object)
SetProperty(String, String)	Hashtable呼叫 方法 put。
Store(Stream, String)	將這個屬性清單 (索引鍵和元素組) 寫入此Properties數據表中的輸出數據流，格式適合使用 #load(InputStream) load(InputStream) 方法載入至Properties資料表。
Store(Writer, String)	將這個屬性清單 (索引鍵和元素組寫入此 Properties 數據表中) 的輸出字元數據流，格式適合使用 #load(java.io.Reader) load(Reader) 方法。
StoreToXML(Stream, String)	發出 XML 檔，此檔案代表此表格中包含的所有屬性。
StoreToXML(Stream, String, String)	使用指定的編碼，發出 XML 檔，此檔案代表此資料表中包含的所有屬性。
StringPropertyNames()	傳回此屬性清單中的一組索引鍵，其中索引鍵及其對應的值是字串，如果在主要屬性清單中找不到相同名稱的索引鍵，則包括預設屬性清單中的相異索引鍵。
ToArray<T>()	類別 Properties 代表一組永續性的屬性。 (繼承來源 Object)
ToString()	傳回物件的字串表示。 (繼承來源 Object)
UnregisterFromRuntime()	類別 Properties 代表一組永續性的屬性。 (繼承來源 Object)
Wait()	讓目前的線程等到喚醒為止，通常是em <notified/em>或<em>interrupted</em>。>< (繼承來源 Object)
Wait(Int64)	讓目前的線程等到喚醒為止，通常是em <notified/em>或<em>interrupted</em>，或直到經過一定數量的實時為止。<> (繼承來源 Object)
Wait(Int64, Int32)	讓目前的線程等到喚醒為止，通常是em <notified/em>或<em>interrupted</em>，或直到經過一定數量的實時為止。<> (繼承來源 Object)

明確介面實作

IJavaPeerable.Disposed()	類別 Properties 代表一組永續性的屬性。 (繼承來源 Object)
IJavaPeerable.DisposeUnlessReferenced()	類別 Properties 代表一組永續性的屬性。 (繼承來源 Object)
IJavaPeerable.Finalized()	類別 Properties 代表一組永續性的屬性。 (繼承來源 Object)
IJavaPeerable.JniManagedPeerState	類別 Properties 代表一組永續性的屬性。 (繼承來源 Object)
IJavaPeerable.SetJniIdentityHashCode(Int32)	類別 Properties 代表一組永續性的屬性。 (繼承來源 Object)
IJavaPeerable.SetJniManagedPeerState(JniManagedPeerStates)	類別 Properties 代表一組永續性的屬性。 (繼承來源 Object)
IJavaPeerable.SetPeerReference(JniObjectReference)	類別 Properties 代表一組永續性的屬性。 (繼承來源 Object)

擴充方法

JavaCast<TResult>(IJavaObject)	執行 Android 執行時間檢查的類型轉換。
JavaCast<TResult>(IJavaObject)	類別 Properties 代表一組永續性的屬性。
GetJniTypeName(IJavaPeerable)	類別 Properties 代表一組永續性的屬性。