DelphiBasics   Home  |  Delphi .net Home  |  System.Collections NameSpace

.NET Framework  Namespace References  System  System.Collections     ArrayList   Class    BitArray   Class    CaseInsensitiveComparer   Class    Comparer   Class    DictionaryEntry   Structure    HashTable   Class    ICollection   Interface    IComparer   Interface    IDictionary   Interface    IDictionaryEnumerator   Interface    IEnumerator   Interface    IList   Interface    Queue   Class    SortedList   Class    Stack   Class   System.Globalization  System.IO  Articles and Tutorials  Overview of .NET  Delphi and .NET  Winform Applications  ASP .Net Applications  php Web Services  Framework Collections  Framework String Handling  Framework Files and Folders       System.Collections.ArrayList Class    Description ArrayList is different in operation to the native Delphi primitive Array data type, and the System.Array class.   Unlike these other types, ArrayList supports element add and delete - the array size is readily modifiable. It is similar in operation to the native Classes unit TList class.   Like TList, ArrayList can hold a mix of data types - each element can hold any object type. You may need to cast to TObject to store primitive values such as numbers.   Internally, the list works with a certain Capacity of elements - when exceeded, the list size is doubled. The starting size is 16. You can reduce the capacity of an ArrayList object that has grown and now shrunk so as to release the now unneeded memory allocation.   You would use an ArrayList when you are dealing with a list that is volatile - maybe where the user can edit the contents.   You can create a new ArrayList using an existing System.Collections collection to furnish the data contents.  Syntax Constructor Create ( ); Constructor Create ( InitialCapacity : Integer ; ); Constructor Create ( SourceCollection : ICollection; );  Methods Add   Add a new Element to the end of the ArrayList AddRange   Add a range of elements to the end of the ArrayList BinarySearch   Searches the sorted ArrayList for a specific element Clear   Remove all elements from the ArrayList Clone   Creates a shallow clone (copy) of the current ArrayList to another Contains   Searches the sorted ArrayList for a specific element CopyTo   Copies elements from the ArrayList to a single dimension array GetEnumerator   Gets an enumerator to allow reading the elements of the current ArrayList GetRange   Creates a new ArrayList from a subset of the current ArrayList elements IndexOf   Tries to find the first occurence of an object in the current ArrayList Insert   Insert a new element into the ArrayList at the specified index position InsertRange   Add a range of elements into the ArrayList LastIndexOf   Tries to find the alst occurence of an object in the current ArrayList Remove   Remove a particular Object Element from the ArrayList RemoveAt   Remove an element from the ArrayList at the specified index position RemoveRange   Remove a range of elements from the ArrayList Repeat   Create a new ArrayList with all elements set to the same value Reverse   Reverse the sequence of elements in the ArrayList SetRange   Overlays elements from a collection onto the current ArrayList Sort   Sort the elements in the ArrayList into sequence ToArray   Copies elements from the ArrayList to a new single dimension array TrimToSize   Removes unused elements from the current ArrayList  Properties Capacity    Integer    The number of elements for which space is currently reserved Count    Integer    The actual number of elements in the array IsFixedSize    Boolean    If the array is constrained to updates only, with no element addition or removal. Use the FixedSize method to create an ArrayList with a fixed size. IsReadOnly    Boolean    The array cannot be updated in any way. Use the ReadOnly method to create a read only array. IsSynchronised    Boolean    Used for safer thread operation - but even this set to true will not help protect enumeration scans of an ArrayList from other threads updating. Item    Object    Indexed propetry - the indexed element can be read or updated SyncRoot    Object    Advanced synchronation mechanism  Microsoft MSDN links   System.Collections System.Collections.arraylist

Delphi Programming © Neil Moffatt . All rights reserved.  |  Home Page