Hashtable 類別

定義

[Android.Runtime.Register("java/util/Hashtable", DoNotGenerateAcw=true)]
[Java.Interop.JavaTypeParameters(new System.String[] { "K", "V" })]
public class Hashtable : Java.Util.Dictionary, IDisposable, Java.Interop.IJavaPeerable, Java.IO.ISerializable, Java.Lang.ICloneable, Java.Util.IMap

[<Android.Runtime.Register("java/util/Hashtable", DoNotGenerateAcw=true)>]
[<Java.Interop.JavaTypeParameters(new System.String[] { "K", "V" })>]
type Hashtable = class
    inherit Dictionary
    interface ISerializable
    interface IJavaObject
    interface IDisposable
    interface IJavaPeerable
    interface ICloneable
    interface IMap

繼承

Object

Object

Dictionary

Hashtable

屬性

RegisterAttribute JavaTypeParametersAttribute

實作

IJavaObject IJavaPeerable ISerializable ICloneable IMap IDisposable

備註

這個類別會實作哈希表，此哈希表會將索引鍵對應至值。 任何非null 物件都可以當做索引鍵或值使用。

若要成功從哈希表儲存和擷取物件，用作索引鍵的對象必須實 hashCode 作 方法和 equals 方法。

的 Hashtable 實例有兩個會影響其效能的參數： 初始容量 和 負載因數。 容量是哈希表中的貯體數目，而初始容量只是建立哈希表時的容量。 請注意，哈希表已 開啟：在「哈希衝突」的情況下，單一貯體會儲存多個專案，必須循序搜尋。 負載因數是一種測量哈希表在容量自動增加之前，允許取得哈希表的完整程度。 初始容量和負載因數參數只是實作的提示。 叫用 rehash 方法的確切詳細數據是否與實作相關。

一般而言，預設負載因數 （.75） 在時間和空間成本之間提供了良好的取捨。 較高的值會降低空間額外負荷，但會增加查閱項目的時間成本（這反映在大多數 Hashtable 作業中，包括 get 和 put）。

初始容量可控制浪費空間與作業需求 rehash 之間的取捨，這是耗時的。 如果初始容量大於 將包含的項目數目上限除以其負載因數，則不會rehash發生任何作業。Hashtable 不過，設定初始容量太高可能會浪費空間。

如果要將許多專案放入 Hashtable，建立具有足夠龐大容量的專案，可能會讓專案更有效率地插入，而不需要視需要執行自動重新套用以增加數據表。

此範例會建立數位的哈希表。 它會使用數字的名稱作為索引鍵：

{@code
              Hashtable<String, Integer> numbers
                = new Hashtable<String, Integer>();
              numbers.put("one", 1);
              numbers.put("two", 2);
              numbers.put("three", 3);}

若要擷取數位，請使用下列程式代碼：

{@code
              Integer n = numbers.get("two");
              if (n != null) {
                System.out.println("two = " + n);
              }}

由這個類別之所有「集合檢視方法」所傳回之集合方法所傳回 iterator 的反覆運算器是 <em>fail-fast</em>：如果在建立反覆運算器之後隨時以結構化方式修改 Hashtable， remove 則反覆運算器會擲回 ConcurrentModificationException。 因此，面對並行修改，反覆運算器會快速且乾淨地失敗，而不是在未來不確定的時間冒著任意、不具決定性的行為的風險。 Hashtable 的 #keys keys 和 #elements elements 方法><所傳回的列舉不是</em> 失敗快速;如果在建立列舉之後隨時以結構化方式修改 Hashtable，則列舉的結果會未定義。

請注意，Iterator 的失敗快速行為無法保證，一般來說，不可能在未同步處理並行修改的情況下進行任何硬式保證。 快速反覆運算器會盡最大努力擲回 ConcurrentModificationException 。 因此，撰寫依賴此例外狀況的程序正確性是錯誤的： Iterator 的失敗快速行為應該只用來偵測 Bug。

從 Java 2 平臺 v1.2 開始，此類別已進行改造以實 Map 作 介面，使其成為 的成員。

Java Collections Framework。 與新的集合實作不同， Hashtable 會同步處理。 如果不需要安全線程實作，建議使用 HashMap 來取代 Hashtable。 如果需要安全線程高度並行實作，建議使用 java.util.concurrent.ConcurrentHashMap 來取代 Hashtable。

已在1.0中新增。

的 java.util.HashtableJava 檔。

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

建構函式

屬性

方法

明確介面實作

擴充方法

適用於