LocalDataCollection Class

Hierarchy

ASNA.Monarch
   System.Collections 
   System.Collections.IEnumerable 
   System.Collections.ICollection 
   System.Collections.IDictionaryEnumerator
     ASNA.Monarch.LocalDataCollection 

Syntax

 Public class LocalDataCollection Inherits System.Collections      

Thread Safety

Any public static (Shared) members of this type are safe for multithreaded operations. Any instance members are not guaranteed to be thread safe.

Remarks

LocalDataCollection is a general-purpose in-memory table to store named values of any type. Similar to the System i LDA (Local Data Area), with the following advantages:

1. The size of the objects are only limited by the available memory (the System i LDA is limited to 2K bytes)
2. There is no need to remember the position within the Data where the object is stored, (unlike the System i LDA, unless it is mapped to a data structure). Using this property, if the specific name already exists in the dictionary, the value is replaced; otherwise, a new element is created. In contrast, the Add method adds a name/value pair but does not modify existing elements.
3. The syntax to access the values is much simpler with Job.LDC
4. The LocalDataCollection is more flexible, one can easily:
   • determine how many named objects are stored ( Count property)
   • query whether a particular name has already been stored ( Contains method)
   • remove all names values ( Clear or RemoveAll methods) or a single value ( Remove)
   • access the Values or Names ICollection

Requirements

See Also

ASNA.Monarch Namespace
LocalDataCollection Members