List<T>.RemoveRange(Int32, Int32) メソッド

定義

名前空間:

System.Collections.Generic

アセンブリ:

System.Collections.dll

ソース:

List.cs

List<T> から要素の範囲を削除します。

C#

public void RemoveRange (int index, int count);

パラメーター

index

Int32

削除する要素の範囲の開始位置を示す 0 から始まるインデックス。

count

Int32

削除する要素の数を指定します。

例外

ArgumentOutOfRangeException

index が 0 未満です。

または

count が 0 未満です。

ArgumentException

index および count は List<T> において要素の有効な範囲を表していません。

例

次の例では、範囲に対して RemoveRange 動作する クラスの メソッドとその他のさまざまなメソッドを List<T> 示します。 リストが作成および変更されると、 メソッドを RemoveRange 使用して、インデックス位置 2 から始まる 2 つの要素がリストから削除されます。

C#

using System;
using System.Collections.Generic;

public class Example
{
    public static void Main()
    {
        string[] input = { "Brachiosaurus",
                           "Amargasaurus",
                           "Mamenchisaurus" };

        List<string> dinosaurs = new List<string>(input);

        Console.WriteLine("\nCapacity: {0}", dinosaurs.Capacity);

        Console.WriteLine();
        foreach( string dinosaur in dinosaurs )
        {
            Console.WriteLine(dinosaur);
        }

        Console.WriteLine("\nAddRange(dinosaurs)");
        dinosaurs.AddRange(dinosaurs);

        Console.WriteLine();
        foreach( string dinosaur in dinosaurs )
        {
            Console.WriteLine(dinosaur);
        }

        Console.WriteLine("\nRemoveRange(2, 2)");
        dinosaurs.RemoveRange(2, 2);

        Console.WriteLine();
        foreach( string dinosaur in dinosaurs )
        {
            Console.WriteLine(dinosaur);
        }

        input = new string[] { "Tyrannosaurus",
                               "Deinonychus",
                               "Velociraptor"};

        Console.WriteLine("\nInsertRange(3, input)");
        dinosaurs.InsertRange(3, input);

        Console.WriteLine();
        foreach( string dinosaur in dinosaurs )
        {
            Console.WriteLine(dinosaur);
        }

        Console.WriteLine("\noutput = dinosaurs.GetRange(2, 3).ToArray()");
        string[] output = dinosaurs.GetRange(2, 3).ToArray();

        Console.WriteLine();
        foreach( string dinosaur in output )
        {
            Console.WriteLine(dinosaur);
        }
    }
}

/* 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
 */

注釈

項目は削除され、 内の List<T> 項目に続くすべての要素のインデックスが によって count減ります。

このメソッドは O(n) 操作です。 ここで、n は Countです。

適用対象

こちらもご覧ください

• Remove(T)
• RemoveAt(Int32)
• GetRange(Int32, Int32)
• AddRange(IEnumerable<T>)
• InsertRange(Int32, IEnumerable<T>)