HashDictionary Class

Oracle® Fusion Middleware .NET API Reference for Oracle Coherence
14c (14.1.1.0)
F23534-02

Hashtable-based IDictionary implementation that allows null keys.

Inheritance Hierarchy

SystemObject
System.CollectionsHashtable
Tangosol.Util.CollectionsHashDictionary

Namespace: Tangosol.Util.Collections
Assembly: Coherence (in Coherence.dll) Version: 14.1.1.14 (14.1.1.14)

Syntax

Copy

[SerializableAttribute]
public class HashDictionary : Hashtable, 
	IEnumerable

The HashDictionary type exposes the following members.

Constructors

	Name	Description
	HashDictionary	Initializes a new instance of the HashDictionary class using the default initial capacity, load factor, hash code provider, and comparer.
	HashDictionary(IDictionary)	Initializes a new instance of the HashDictionary class by copying the elements from the specified dictionary to the new HashDictionary object. The new HashDictionary object has an initial capacity equal to the number of elements copied, and uses the default load factor, hash code provider, and comparer.
	HashDictionary(IEqualityComparer)	Initializes a new instance of the HashDictionary class using the default initial capacity and load factor, and the specified IEqualityComparer object.
	HashDictionary(Int32)	Initializes a new instance of the HashDictionary class using the specified initial capacity, and the default load factor, hash code provider, and comparer.
	HashDictionary(IDictionary, IEqualityComparer)	Initializes a new instance of the HashDictionary class by copying the elements from the specified dictionary to the new HashDictionary object. The new HashDictionary object has an initial capacity equal to the number of elements copied, and uses the default load factor and the specified IEqualityComparer object.
	HashDictionary(IDictionary, Single)	Initializes a new instance of the HashDictionary class by copying the elements from the specified dictionary to the new HashDictionary object. The new HashDictionary object has an initial capacity equal to the number of elements copied, and uses the specified load factor, and the default hash code provider and comparer.
	HashDictionary(Int32, IEqualityComparer)	Initializes a new instance of the HashDictionary class using the specified initial capacity and IEqualityComparer, and the default load factor.
	HashDictionary(Int32, Single)	Initializes a new instance of the HashDictionary class using the specified initial capacity and load factor, and the default hash code provider and comparer.
	HashDictionary(SerializationInfo, StreamingContext)	Initializes a new instance of the HashDictionary class that is serializable using the specified SerializationInfo and StreamingContext objects.
	HashDictionary(IDictionary, Single, IEqualityComparer)	Initializes a new instance of the HashDictionary class by copying the elements from the specified dictionary to the new HashDictionary object. The new HashDictionary object has an initial capacity equal to the number of elements copied, and uses the specified load factor and IEqualityComparer object.
	HashDictionary(Int32, Single, IEqualityComparer)	Initializes a new instance of the HashDictionary class using the specified initial capacity, load factor, and IEqualityComparer object.

Top

Properties

	Name	Description
	comparer	Obsolete. Gets or sets the IComparer to use for the Hashtable. (Inherited from Hashtable.)
	Count	Gets the number of elements contained in the ICollection. (Overrides HashtableCount.)
	EqualityComparer	(Inherited from Hashtable.)
	hcp	Obsolete. Gets or sets the object that can dispense hash codes. (Inherited from Hashtable.)
	IsFixedSize	(Inherited from Hashtable.)
	IsNullValueSet	Returns true is the value for the null key is set, false otherwise.
	IsReadOnly	(Inherited from Hashtable.)
	IsSynchronized	(Inherited from Hashtable.)
	Item	Gets or sets the element with the specified key. (Overrides HashtableItemObject.)
	Keys	Gets an ICollection object containing the keys of this dictionary. (Overrides HashtableKeys.)
	SyncRoot	(Inherited from Hashtable.)
	Values	Gets an ICollection object containing the values in this dictionary. (Overrides HashtableValues.)

Top

Methods

	Name	Description
	Add	Adds an element with the provided key and value to the IDictionary object. (Overrides HashtableAdd(Object, Object).)
	AssertIsVariableSize	Throw an exception if this dictionary is fixed size.
	AssertIsWriteable	Throw an exception if this dictionary is read-only.
	Clear	Removes all elements from the IDictionary object. (Overrides HashtableClear.)
	Clone	Creates a new object that is a copy of the current instance. (Overrides HashtableClone.)
	Contains	Determines whether this dictionary contains an entry with the specified key. (Overrides HashtableContains(Object).)
	ContainsKey	Determines whether the HashDictionary contains a specific key. (Overrides HashtableContainsKey(Object).)
	ContainsValue	Determines whether the HashDictionary contains a specific value. (Overrides HashtableContainsValue(Object).)
	CopyTo	Copies the elements of the collection to an array, starting at a particular array index. (Overrides HashtableCopyTo(Array, Int32).)
	Equals(IDictionary)	Compares this dictionary with another dictionary for equality.
	Equals(Object)	Determines whether the specified object is equal to this object. (Overrides ObjectEquals(Object).)
	Finalize	Allows an object to try to free resources and perform other cleanup operations before it is reclaimed by garbage collection. (Inherited from Object.)
	GetEnumerator	Returns an IDictionaryEnumerator object for this dictionary. (Overrides HashtableGetEnumerator.)
	GetHash	(Inherited from Hashtable.)
	GetHashCode	Returns a hash code for this object. (Overrides ObjectGetHashCode.)
	GetObjectData	Overrides serialization method to add support for null value serialization. (Overrides HashtableGetObjectData(SerializationInfo, StreamingContext).)
	GetType	Gets the Type of the current instance. (Inherited from Object.)
	KeyEquals	(Inherited from Hashtable.)
	MemberwiseClone	Creates a shallow copy of the current Object. (Inherited from Object.)
	OnDeserialization	Implements the ISerializable interface and raises the deserialization event when the deserialization is complete. (Inherited from Hashtable.)
	Remove	Removes the element with the specified key from the IDictionary object. (Overrides HashtableRemove(Object).)
	ToString	Returns string representation of this instance. (Overrides ObjectToString.)

Top

Remarks

Note that null keys support intentionally breaks the IDictionary contract, which states that an ArgumentNullException should be raised if the key is null.

However, this is necessary in order to match the behavior in Java and C++, where some Map implementations support null keys.

Note: This implementation is not thread safe. If you need it to be, you should wrap it with the SynchronizedDictionary.

Reference

Tangosol.Util.Collections Namespace