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

List(Of T).RemoveRange Method

Removes a range of elements from the List(Of T).

Namespace:  System.Collections.Generic
Assemblies:   mscorlib (in mscorlib.dll)
  System.Collections (in System.Collections.dll)

'Declaration
Public Sub RemoveRange ( _
	index As Integer, _
	count As Integer _
)

Parameters

index
Type: System.Int32

The zero-based starting index of the range of elements to remove.

count
Type: System.Int32

The number of elements to remove.

ExceptionCondition
ArgumentOutOfRangeException

index is less than 0.

-or-

count is less than 0.

ArgumentException

index and count do not denote a valid range of elements in the List(Of T).

The items are removed and all the elements following them in the List(Of T) have their indexes reduced by count.

This method is an O(n) operation, where n is Count.

The following example demonstrates the RemoveRange method and various other methods of the List(Of T) class that act on ranges. After the list has been created and modified, the RemoveRange method is used to remove two elements from the list, beginning at index location 2.

Imports System
Imports System.Collections.Generic

Public Class Example

    Public Shared Sub Main()

        Dim input() As String = { "Brachiosaurus", _
                                  "Amargasaurus", _
                                  "Mamenchisaurus" }

        Dim dinosaurs As New List(Of String)(input)

        Console.WriteLine(vbLf & "Capacity: {0}", dinosaurs.Capacity)

        Console.WriteLine()
        For Each dinosaur As String In dinosaurs
            Console.WriteLine(dinosaur)
        Next

        Console.WriteLine(vbLf & "AddRange(dinosaurs)")
        dinosaurs.AddRange(dinosaurs)

        Console.WriteLine()
        For Each dinosaur As String In dinosaurs
            Console.WriteLine(dinosaur)
        Next

        Console.WriteLine(vbLf & "RemoveRange(2, 2)")
        dinosaurs.RemoveRange(2, 2)

        Console.WriteLine()
        For Each dinosaur As String In dinosaurs
            Console.WriteLine(dinosaur)
        Next

        input = New String() { "Tyrannosaurus", _
                               "Deinonychus", _
                               "Velociraptor" }

        Console.WriteLine(vbLf & "InsertRange(3, input)")
        dinosaurs.InsertRange(3, input)

        Console.WriteLine()
        For Each dinosaur As String In dinosaurs
            Console.WriteLine(dinosaur)
        Next

        Console.WriteLine(vbLf & "output = dinosaurs.GetRange(2, 3).ToArray")
        Dim output() As String = dinosaurs.GetRange(2, 3).ToArray()

        Console.WriteLine()
        For Each dinosaur As String In output
            Console.WriteLine(dinosaur)
        Next 

    End Sub 
End Class 

' This code example produces the following output: 

'Capacity: 3 

'Brachiosaurus 
'Amargasaurus 
'Mamenchisaurus 

'AddRange(dinosaurs) 

'Brachiosaurus 
'Amargasaurus 
'Mamenchisaurus 
'Brachiosaurus 
'Amargasaurus 
'Mamenchisaurus 

'RemoveRange(2, 2) 

'Brachiosaurus 
'Amargasaurus 
'Amargasaurus 
'Mamenchisaurus 

'InsertRange(3, input) 

'Brachiosaurus 
'Amargasaurus 
'Amargasaurus 
'Tyrannosaurus 
'Deinonychus 
'Velociraptor 
'Mamenchisaurus 

'output = dinosaurs.GetRange(2, 3).ToArray 

'Amargasaurus 
'Tyrannosaurus 
'Deinonychus

.NET Framework

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

.NET Framework Client Profile

Supported in: 4, 3.5 SP1

XNA Framework

Supported in: 3.0, 2.0, 1.0

.NET for Windows Phone apps

Supported in: Windows Phone 8.1, Windows Phone Silverlight 8.1, Windows Phone Silverlight 8

Portable Class Library

Supported in: Portable Class Library
Show:
© 2015 Microsoft