LiteDictionary Class |
14c (14.1.1.0)
F23534-02
An implementation of IDictionary that is optimal (in terms of
both size and speed) for very small sets of data but still works
excellently with large sets of data.
Inheritance HierarchyNamespace: Tangosol.Util
Assembly: Coherence (in Coherence.dll) Version: 14.1.1.14 (14.1.1.14)
SyntaxC#
public class LiteDictionary : IDictionary, ICollection, IEnumerable
The LiteDictionary type exposes the following members.
Constructors| Name | Description | |
|---|---|---|
 | LiteDictionary |
Constructs a LiteDictionary.
|
| LiteDictionary(IDictionary) |
Construct a LiteDictionary with the same mappings as the given
dictionary.
|
Properties| Name | Description | |
|---|---|---|
 | Count |
Gets the number of elements contained in this dictionary.
|
| IsEmpty |
Gets true if this dictionary contains no key-value
mappings.
|
| IsFixedSize |
Gets a value indicating whether the IDictionary object has
a fixed size.
|
| IsReadOnly |
Gets a value indicating whether the IDictionary object is
read-only.
|
| IsSynchronized |
Gets a value indicating whether access to the ICollection
is synchronized (thread safe).
|
| Item |
Returns the value to which this dictionary maps the specified
key.
|
| Keys |
Gets a collection containing the keys of the LiteDictionary.
|
| SyncRoot |
Gets an object that can be used to synchronize access to the
ICollection.
|
| Values |
Gets a collection containing the values in the LiteDictionary.
|
Methods| Name | Description | |
|---|---|---|
| Add |
Adds an element with the provided key and value to the
IDictionary object.
|
 | CheckShrinkFromOther |
After a mutation operation has reduced the size of an underlying
dictionary, check if the delegation model should be replaced with
a more size-efficient storage approach, and switch accordingly.
|
| Clear |
Removes all elements from the dictionary.
|
| Contains |
Returns true if this dictionary contains a mapping for the
specified key.
|
| CopyTo |
Copies the elements of the ICollection to an Array,
starting at a particular index.
|
| Equals | Determines whether the specified object is equal to the current object. (Inherited from 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 IEnumerator object for this LiteDictionary.
|
| GetHashCode | Serves as the default hash function. (Inherited from Object.) |
| GetType | Gets the Type of the current instance. (Inherited from Object.) |
| InstantiateDictionary |
Instantiate an IDictionary object to store entries in once
the "lite" threshold has been exceeded.
|
| InstantiateEntry |
Instantiate a DictionaryEntry.
|
| MemberwiseClone | Creates a shallow copy of the current Object. (Inherited from Object.) |
| Remove |
Removes the mapping for this key from this dictionary if present.
|
| RemoveEx |
Removes the mapping for this key from this map if present.
|
| ToString | Returns a string that represents the current object. (Inherited from Object.) |
RemarksThis implementation is not thread-safe.
The LiteDictionary implementation switches at runtime between several different sub-implementations for storing the IDictionary of objects, described here:
- "empty dictionary" - a dictionary that contains no data;
- "single entry" - a reference directly to a single dictionary entry;
- "object[]" - a reference to an array of entries; the item limit for this implementation is determined by the THRESHOLD constant;
- "delegation" - for more than THRESHOLD items, a dictionary is created to delegate the dictionary management to; sub-classes can override the default delegation class Hashtable by overriding the factory method InstantiateDictionary.
The LiteDictionary implementation supports the null key value.
See Also