java.util
類別 PropertyResourceBundle

java.lang.Object
  java.util.ResourceBundle
      java.util.PropertyResourceBundle

public class PropertyResourceBundle
extends ResourceBundle

PropertyResourceBundle 是 ResourceBundle 的一個具體子類別，它使用屬性檔案中的靜態字元串集來管理語言環境資源。有關資源套件的更多資訊，請參閱 ResourceBundle。

與其他資源包型別不同，不能為 PropertyResourceBundle 創建子類別。相反，要提供含有資源資料的屬性檔案。ResourceBundle.getBundle 將自動尋找合適的屬性檔案並創建參考該檔案的 PropertyResourceBundle。有關搜尋和實例化策略的完整描述，請參閱 ResourceBundle.getBundle。

下面的範例顯示了資源包系列中具有基本名稱 "MyResources" 的成員。文本定義了包 "MyResources_de"，這是該套件系列中的德語成員。該成員基於 PropertyResourceBundle，因此文本就是檔案 "MyResources_de.properties" 的內容（一個相關的 範例顯示了如何將包添加到該系列中，該系列作為 ListResourceBundle 的子類別來實作）。本範例的鍵形式為 "s1" 等等。實際的鍵完全取決於您的選擇，只要它們與在程序中使用的、用於從套件中獲取物件的鍵相同即可。鍵是區分大小寫的。

 # MessageFormat pattern
 s1=Die Platte \"{1}\" enthält {0}.

 # location of {0} in pattern
 s2=1

 # sample disk name
 s3=Meine Platte

 # first ChoiceFormat choice
 s4=keine Dateien

 # second ChoiceFormat choice
 s5=eine Datei

 # third ChoiceFormat choice
 s6={0,number} Dateien

 # sample date
 s7=3. März 1996
 

註：可根據 InputStream 或 Reader 建構 PropertyResourceBundle，它表示一個屬性檔案。根據 InputStream 建構一個 PropertyResourceBundle 實例要求輸入串流必須使用 ISO-8859-1 編碼。在這種情況下，不能使用 ISO-8859-1 編碼表示的字元必須用 Unicode 轉義表示，而其他帶有 Reader 的建構子沒有該限制。

從以下版本開始：

JDK1.1

另請參見：

ResourceBundle, ListResourceBundle, Properties

巢狀類別摘要

從類別 java.util.ResourceBundle 繼承的巢狀類別/介面

ResourceBundle.Control

欄位摘要

從類別 java.util.ResourceBundle 繼承的欄位

parent

建構子摘要

PropertyResourceBundle(InputStream stream)
根據 InputStream 創建屬性資源套件。

PropertyResourceBundle(Reader reader)
根據 Reader 創建屬性資源套件。

方法摘要

Enumeration<String>	getKeys() 返回包含在此 ResourceBundle 及其父包中的鍵的 Enumeration。
Object	handleGetObject(String key) 從此資源包中獲取給定鍵的物件。
protected Set<String>	handleKeySet() 返回只 套件含在此 ResourceBundle 中的鍵的 Set。

從類別 java.util.ResourceBundle 繼承的方法

clearCache, clearCache, containsKey, getBundle, getBundle, getBundle, getBundle, getBundle, getBundle, getLocale, getObject, getString, getStringArray, keySet, setParent

從類別 java.lang.Object 繼承的方法

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

建構子詳細資訊

PropertyResourceBundle

public PropertyResourceBundle(InputStream stream)
                       throws IOException

根據 InputStream 創建屬性資源套件。使用此建構子讀取的屬性檔案必須使用 ISO-8859-1。

參數：

stream - 一個 InputStream，表示要從其進行讀取的屬性檔案。

拋出：

IOException - 如果發生 I/O 錯誤

NullPointerException - 如果 stream 為 null

PropertyResourceBundle

public PropertyResourceBundle(Reader reader)
                       throws IOException

根據 Reader 創建屬性資源套件。與 PropertyResourceBundle(InputStream) 建構子不同，關於輸入屬性檔案的編碼沒有限制。

參數：

reader - 一個 Reader，表示要從其進行讀取的屬性檔案。

拋出：

IOException - 如果發生 I/O 錯誤

NullPointerException - 如果 reader 為 null

從以下版本開始：

1.6

方法詳細資訊

handleGetObject

public Object handleGetObject(String key)

從類別 ResourceBundle 複製的描述

從此資源包中獲取給定鍵的物件。如果此資源包未包含給定鍵的物件，則返回 null。

指定者：

類別 ResourceBundle 中的 handleGetObject

參數：

key - 所需物件的鍵

返回：

給定鍵的物件，或者返回 null

getKeys

public Enumeration<String> getKeys()

返回包含在此 ResourceBundle 及其父包中的鍵的 Enumeration。

指定者：

類別 ResourceBundle 中的 getKeys

返回：

包含在此 ResourceBundle 及其父包中的鍵的 Enumeration。

另請參見：

ResourceBundle.keySet()

handleKeySet

protected Set<String> handleKeySet()

返回只 套件含在此 ResourceBundle 中的鍵的 Set。

覆寫：

類別 ResourceBundle 中的 handleKeySet

返回：

只包含在此 ResourceBundle 中的鍵的 Set

從以下版本開始：

1.6

另請參見：

ResourceBundle.keySet()