SortedList::GetByIndex Method (Int32)
.NET Framework (current version)
Gets the value at the specified index of a SortedList object.
Assembly: mscorlib (in mscorlib.dll)
Parameters
- index
-
Type:
System::Int32
The zero-based index of the value to get.
| Exception | Condition |
|---|---|
| ArgumentOutOfRangeException | index is outside the range of valid indexes for the SortedList object. |
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.
This method is an O(1) operation.
The following code example shows how to get one or all the keys or values in a SortedList object.
#using <system.dll> using namespace System; using namespace System::Collections; int main() { // Creates and initializes a new SortedList. SortedList^ mySL = gcnew SortedList; mySL->Add( 1.3, "fox" ); mySL->Add( 1.4, "jumped" ); mySL->Add( 1.5, "over" ); mySL->Add( 1.2, "brown" ); mySL->Add( 1.1, "quick" ); mySL->Add( 1.0, "The" ); mySL->Add( 1.6, "the" ); mySL->Add( 1.8, "dog" ); mySL->Add( 1.7, "lazy" ); // Gets the key and the value based on the index. int myIndex = 3; Console::WriteLine( "The key at index {0} is {1}.", myIndex, mySL->GetKey( myIndex ) ); Console::WriteLine( "The value at index {0} is {1}.", myIndex, mySL->GetByIndex( myIndex ) ); // Gets the list of keys and the list of values. IList^ myKeyList = mySL->GetKeyList(); IList^ myValueList = mySL->GetValueList(); // Prints the keys in the first column and the values in the second column. Console::WriteLine( "\t-KEY-\t-VALUE-" ); for ( int i = 0; i < mySL->Count; i++ ) Console::WriteLine( "\t{0}\t{1}", myKeyList[ i ], myValueList[ i ] ); } /* This code produces the following output. The key at index 3 is 1.3. The value at index 3 is fox. -KEY- -VALUE- 1 The 1.1 quick 1.2 brown 1.3 fox 1.4 jumped 1.5 over 1.6 the 1.7 lazy 1.8 dog */
Universal Windows Platform
Available since 10
.NET Framework
Available since 1.1
Available since 10
.NET Framework
Available since 1.1
Show: