C#でListの末尾にコレクションの要素を追加する方法（AddRangeメソッドの使い方）

C#で既存のListの末尾に、指定したコレクション（配列など）の要素をまとめて追加したい場合は、AddRangeメソッドを使用します。本記事では、文字列型と数値型のListを例に、AddRangeメソッドの基本的な使い方をコード付きで解説します。

例1：文字列型のListに配列の要素を追加する

まずは、string型のListに対して、string型の配列の要素を末尾に追加する例を見てみましょう。

using System;
using System.Collections.Generic;
public class Demo {
   public static void Main(String[] args){
      List<string> list = new List<string>();
      list.Add("Andy");
      list.Add("Gary");
      list.Add("Katie");
      list.Add("Amy");
      Console.WriteLine("Elements in List...");
      foreach (string res in list){
         Console.WriteLine(res);
      }
      string[] strArr = { "John", "Jacob" };
      list.AddRange(strArr);
      Console.WriteLine("Elements in List...UPDATED");
      foreach(String str in list){
         Console.WriteLine(str);
      }
   }
}

実行結果

上記のコードを実行すると、次のような出力が得られます。

Elements in List...
Andy
Gary
Katie
Amy
Elements in List...UPDATED
Andy
Gary
Katie
Amy
John
Jacob

例2：数値型のListに配列の要素を追加する

続いて、int型のListにint型の配列の要素を追加する例です。使い方は文字列型の場合とまったく同じです。

using System;
using System.Collections.Generic;
public class Demo {
   public static void Main(String[] args){
      List<int> list = new List<int>();
      list.Add(25);
      list.Add(50);
      list.Add(75);
      list.Add(100);
      Console.WriteLine("Elements in List...");
      foreach (int val in list){
         Console.WriteLine(val);
      }
      int[] intArr = { 150, 200, 250, 300 };
      list.AddRange(intArr);
      Console.WriteLine("Elements in List...UPDATED");
      foreach(int val in list){
         Console.WriteLine(val);
      }
   }
}

実行結果

上記のコードを実行すると、次のような出力が得られます。

Elements in List...
25
50
75
100
Elements in List...UPDATED
25
50
75
100
150
200
250
300

AddRangeメソッドのポイント

AddRangeメソッドは、引数として受け取ったコレクション（IEnumerable<T>を実装するオブジェクト）内のすべての要素を、Listの現在の末尾へ順番に追加します。

• 配列だけでなく、別のListやHashSetなど、さまざまなコレクションを渡すことができます。
• foreachループで要素を1つずつAddするよりもコードが簡潔になり、意図も明確になります。
• 追加後のListには、元の要素の後に新しい要素が渡した順序どおり並びます。

複数の要素を一度にListへ追加したい場面では、AddRangeメソッドを活用することで、効率的かつ可読性の高いコードを実現できます。