【C#】InsertRange()メソッドでリストに複数の要素を一括挿入する方法

C#で既存のリストに複数の要素をまとめて挿入したい場合は、InsertRange()メソッドを使用します。このメソッドを使えば、配列や別のリストなどのコレクション要素を、指定した位置から一括で追加できるため、1つずつAdd()で追加する手間を省けます。

InsertRangeメソッドの基本構文

InsertRange()はList<T>クラスが提供するメソッドで、次のように記述します。

list.InsertRange(挿入開始位置（インデックス）, 追加するコレクション);

第1引数には挿入を開始するインデックス番号を、第2引数には追加したいコレクション（配列などIEnumerable<T>を実装したオブジェクト）を指定します。

サンプルコード

まず、元となるリストを作成します。

List<int> arr1 = new List<int>();
arr1.Add(10);
arr1.Add(20);
arr1.Add(30);
arr1.Add(40);
arr1.Add(50);

次に、リストへ追加するための配列を用意します。この配列の要素を先ほどのリストに挿入します。

int[] arr2 = new int[4];
arr2[0] = 60;
arr2[1] = 70;
arr2[2] = 80;
arr2[3] = 90;

InsertRange()メソッドを使い、インデックス5の位置に配列の要素を一括挿入します。

arr1.InsertRange(5, arr2);

ここまでの処理をまとめた完全なコードは以下の通りです。

実行例

using System;
using System.Collections.Generic;

public class Demo {
    public static void Main() {
        List<int> arr1 = new List<int>();
        arr1.Add(10);
        arr1.Add(20);
        arr1.Add(30);
        arr1.Add(40);
        arr1.Add(50);

        Console.WriteLine("Initial List ...");
        foreach (int i in arr1) {
            Console.WriteLine(i);
        }

        int[] arr2 = new int[4];
        arr2[0] = 60;
        arr2[1] = 70;
        arr2[2] = 80;
        arr2[3] = 90;

        arr1.InsertRange(5, arr2);

        Console.WriteLine("After adding elements ...");
        foreach (int i in arr1) {
            Console.WriteLine(i);
        }
    }
}

出力結果

Initial List ...
10
20
30
40
50
After adding elements ...
10
20
30
40
50
60
70
80
90

まとめ

InsertRange()メソッドを活用すれば、複数の要素を効率的にリストへ挿入でき、既存リストの中間位置への追加にも対応します。大量のデータを扱う際や、配列とリストを連携させたい場合に非常に便利なメソッドなので、ぜひ活用してみてください。