SortedList Class
Represents a collection of key/value pairs that are sorted by the keys and are accessible by key and by index.
Assembly: mscorlib (in mscorlib.dll)
For the generic version of this collection, see System.Collections.Generic.SortedList<TKey, TValue>.
A SortedList element can be accessed by its key, like an element in any IDictionary implementation, or by its index, like an element in any IList implementation.
A SortedList object internally maintains two arrays to store the elements of the list; that is, one array for the keys and another array for the associated values. Each element is a key/value pair that can be accessed as a DictionaryEntry object. A key cannot be null, but a value can be.
The capacity of a SortedList object is the number of elements the SortedList can hold. As elements are added to a SortedList, the capacity is automatically increased as required through reallocation. The capacity can be decreased by calling TrimToSize or by setting the Capacity property explicitly.
The elements of a SortedList object are sorted by the keys either according to a specific IComparer implementation specified when the SortedList is created or according to the IComparable implementation provided by the keys themselves. In either case, a SortedList does not allow duplicate keys.
The index sequence is based on the sort sequence. When an element is added, it is inserted into SortedList in the correct sort order, and the indexing adjusts accordingly. When an element is removed, the indexing also adjusts accordingly. Therefore, the index of a specific key/value pair might change as elements are added or removed from the SortedList object.
Operations on a SortedList object tend to be slower than operations on a Hashtable object because of the sorting. However, the SortedList offers more flexibility by allowing access to the values either through the associated keys or through the indexes.
Elements in this collection can be accessed using an integer index. Indexes in this collection are zero-based.
The foreach statement of the C# language (for each in Visual Basic) requires the type of each element in the collection. Since each element of the SortedList object is a key/value pair, the element type is not the type of the key or the type of the value. Rather, the element type is DictionaryEntry. For example:
The foreach statement is a wrapper around the enumerator, which allows only reading from, not writing to, the collection.
The following code example shows how to create and initialize a SortedList object and how to print out its keys and values.
using System; using System.Collections; public class SamplesSortedList { public static void Main() { // Creates and initializes a new SortedList. SortedList mySL = new SortedList(); mySL.Add("Third", "!"); mySL.Add("Second", "World"); mySL.Add("First", "Hello"); // Displays the properties and values of the SortedList. Console.WriteLine( "mySL" ); Console.WriteLine( " Count: {0}", mySL.Count ); Console.WriteLine( " Capacity: {0}", mySL.Capacity ); Console.WriteLine( " Keys and Values:" ); PrintKeysAndValues( mySL ); } public static void PrintKeysAndValues( SortedList myList ) { Console.WriteLine( "\t-KEY-\t-VALUE-" ); for ( int i = 0; i < myList.Count; i++ ) { Console.WriteLine( "\t{0}:\t{1}", myList.GetKey(i), myList.GetByIndex(i) ); } Console.WriteLine(); } } /* This code produces the following output. mySL Count: 3 Capacity: 16 Keys and Values: -KEY- -VALUE- First: Hello Second: World Third: ! */
Public static (Shared in Visual Basic) members of this type are thread safe. Any instance members are not guaranteed to be thread safe.
A SortedList object can support multiple readers concurrently, as long as the collection is not modified. To guarantee the thread safety of the SortedList, all operations must be done through the wrapper returned by the Synchronized method.
Enumerating through a collection is intrinsically not a thread-safe procedure. Even when a collection is synchronized, other threads can still modify the collection, which causes the enumerator to throw an exception. To guarantee thread safety during enumeration, you can either lock the collection during the entire enumeration or catch the exceptions resulting from changes made by other threads.
Windows 7, Windows Vista, Windows XP SP2, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP Starter Edition, Windows Server 2008 R2, Windows Server 2008, Windows Server 2003, Windows Server 2000 SP4, Windows Millennium Edition, Windows 98, Windows CE, Windows Mobile for Smartphone, Windows Mobile for Pocket PC, Xbox 360, Zune
The .NET Framework and .NET Compact Framework do not support all versions of every platform. For a list of the supported versions, see .NET Framework System Requirements.
Can anyone leads us there?
Thank you!
---
What you're looking may be the Dictionary class.
System.Collections.Generic.Dictionary
However, the documentation there states that the results are returned in an "undefined" order. So your best bet may be to maintain a list of keys in insertion order and a separate SortedList or Dictionary with the same keys. Wrap the whole thing in a custom class that inherits SortedList, and override the Add and Remove methods to update your un-sorted key list.
- 9/16/2009
- Fabio Milheiro
- 12/7/2009
- Tom At Moto
- It does say that keys must be unique.
- 7/21/2009
- OxG
- 12/7/2009
- Tom At Moto
Actually it does say "a SortedList does not allow duplicate keys".
Any suggestions for a class that does allow duplicates?
I don't think you can do that... if you need to store multiple items with the same key, what you need is to create a SortedList with another container type as the value. You then add your values to the container class.
For example: SortedList<string, List<x>> could do the job. You'd need to create a wrapper for this by creating a new class that inherits this, like this:
class MultiList : SortedList <string, List<x>> {
// create a custom add method to add multiple values for one key
override void Add(string key, x value) {
if(keys.Contains(string)) {
this[key].add(value);
else {
List<x> l=new List<x>();
l.Add(value);
this.add(key, l);
}
}
}
Using this technique, adds are the same as you're used to with SortedList, but since the list is actually storing lists, rather than individual items, you need to index the result to get the specific item you need. This should give you the first item in the result (I haven't tried this... if it's wrong, please edit this to correct it):
result = MyMultiList[key][0];
you can also iterate through the contents of a single key's values, like so:
foreach(x item in MyMultiList[key]) {
- 8/10/2009
- Phil Preen
- 12/7/2009
- Tom At Moto
To answer OxG's question above, the answer is that keys in a sorted list must be unique. Thus trying to call the Add() method with a non-unique key will generate an exception, as shown in the following PowerShell session log:
PSH [C:\foo]: $sl = New-Object system.Collections.SortedList
PSH [C:\foo]: $sl
PSH [C:\foo]: $sl.Add("first","foo")
PSH [C:\foo]: $sl
Name Value
---- -----
first foo
PSH [C:\foo]: $sl.Add("first","foo2")
Exception calling "Add" with "2" argument(s): "Item has already been added. Key in dictionary: 'first' Key being added: 'first'"
At line:1 char:8
+ $sl.Add <<<< ("first","foo2")
+ CategoryInfo : NotSpecified: (:) [], MethodInvocationException
+ FullyQualifiedErrorId : DotNetMethodException
- 8/2/2009
- Thomas Lee
This example has some data and get enumerator from their values,keys shown below.
SortedList sl = new SortedList();
sl.Add("hip", "hop");
sl.Add("fest", "country");
sl.Add("quer", "bolete");
if ( x.Contains("hip") )
Console.Write("Hip has gone!");
IDictionaryEnumerator iDic = x.GetEnumerator();
while ( iDic.MoveNext() )
Console.Write("key:" + iDic.Key.ToString() + " value:" + iDic.Value.ToString());
- 5/29/2009
- Allan Pedroni
The example already has the sample data entered in alphabetical order as shown below:
SortedList mySL = new SortedList();
mySL.Add("First", "Hello");
mySL.Add("Second", "World");
mySL.Add("Third", "!");
It would be less confusing and a better demonstration to change the order.
# get-sortedlist.ps1
# Sortedlist sample using PowerShell
# Thomas Lee - tfl@psp.co.uk
# Define helper function
function PrintKeysAndValues( $myList ) {
"`t-KEY-`t-VALUE-"
for ( [int] $i = 0; $i -lt $myList.Count; $i++ ) {
"`t{0}:`t{1}" -F $myList.GetKey($i), $myList.GetByIndex($i)
}
""
}
# Create and initialise a new SortedList object
$mySL = new-object system.collections.SortedList
$mySL.Add("First", "Hello")
$mySL.Add("Second", "World")
$mySL.Add("Third", "!")
# Display the properties and values of the SortedList
"`$mySL"
" Count: {0}" -f $mySL.Count
" Capacity: {0}" -f $mySL.Capacity
" Keys and Values:"
PrintKeysAndValues( $mySL )
# Add two more and display results
$mysl.add("aaaa", "aaaa")
$mysl.add("zzzz" , "zzzz")
# display results
"`$mySL after two additions"
" Count: {0}" -f $mySL.Count
" Capacity: {0}" -f $mySL.Capacity
" Keys and Values:"
PrintKeysAndValues( $mySL )
This script produces the following output
PS D:\foo>
D:\foo\get-sortedlist.ps1
$mySL
Count: 3
Capacity: 16
Keys and Values:
-KEY- -VALUE-
First: Hello
Second: World
Third: !
$mySL after two additions
Count: 5
Capacity: 16
Keys and Values:
-KEY- -VALUE-
aaaa: aaaa
First: Hello
Second: World
Third: !
zzzz: zzzz
- 4/11/2008
- Thomas Lee