Was this page helpful?
Your feedback about this content is important. Let us know what you think.
Additional feedback?
1500 characters remaining
Export (0) Print
Expand All

SortedList.GetByIndex Method

Gets the value at the specified index of a SortedList object.

Namespace:  System.Collections
Assembly:  mscorlib (in mscorlib.dll)

Public Overridable Function GetByIndex ( _
	index As Integer _
) As Object


Type: System.Int32

The zero-based index of the value to get.

Return Value

Type: System.Object
The value at the specified index of the SortedList object.


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.

Imports System
Imports System.Collections
Imports Microsoft.VisualBasic

Public Class SamplesSortedList

    Public Shared Sub Main()

        ' Creates and initializes a new SortedList. 
        Dim mySL As New 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. 
        Dim myIndex As Integer = 3
        Console.WriteLine("The key   at index {0} is {1}.", myIndex, _
        Console.WriteLine("The value at index {0} is {1}.", myIndex, _

        ' Gets the list of keys and the list of values. 
        Dim myKeyList As IList = mySL.GetKeyList()
        Dim myValueList As IList = mySL.GetValueList()

        ' Prints the keys in the first column and the values in the second column.
        Console.WriteLine(ControlChars.Tab & "-KEY-" & ControlChars.Tab & _
        Dim i As Integer 
        For i = 0 To mySL.Count - 1
            Console.WriteLine(ControlChars.Tab & "{0}" & ControlChars.Tab & _
               "{1}", myKeyList(i), myValueList(i))
        Next i
    End Sub 
End Class 

' 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

.NET Framework

Supported in: 4.6, 4.5, 4, 3.5, 3.0, 2.0, 1.1

.NET Framework Client Profile

Supported in: 4, 3.5 SP1

XNA Framework

Supported in: 3.0, 2.0, 1.0
© 2015 Microsoft