C# List의 AddRange 메서드 완벽 정리 – 컬렉션 요소 한 번에 추가하기

C# List의 AddRange 메서드란?

C#에서 AddRange 메서드는 리스트(List)에 다른 컬렉션의 요소들을 한 번에 전체 추가할 때 사용하는 기능입니다. 개별 요소를 하나씩 Add()로 추가하는 대신, 배열이나 다른 컬렉션을 통째로 넣을 수 있어 코드가 훨씬 간결해집니다.

실제 예제를 통해 살펴보겠습니다.

1. 리스트 생성 및 요소 추가

먼저 C#에서 리스트를 만들고 요소를 추가합니다.

List<int> list = new List<int>();
list.Add(100);
list.Add(200);
list.Add(300);
list.Add(400);

2. 추가할 배열 준비

이제 리스트에 추가할 4개의 요소를 가진 배열을 선언합니다.

// 4개의 요소를 가진 배열
int[] arr = new int[4];
arr[0] = 500;
arr[1] = 600;
arr[2] = 700;
arr[3] = 800;

3. AddRange()로 컬렉션 전체 추가

AddRange() 메서드를 사용하면 배열의 모든 요소가 리스트 끝에 한꺼번에 추가됩니다.

list.AddRange(arr);

전체 실행 코드

아래는 지금까지의 내용을 모두 합친 완성된 코드와 출력 결과입니다.

using System;
using System.Collections.Generic;

class Demo {
    static void Main() {
        List<int> list = new List<int>();
        list.Add(100);
        list.Add(200);
        list.Add(300);
        list.Add(400);

        // 4개의 요소를 가진 배열
        int[] arr = new int[4];
        arr[0] = 500;
        arr[1] = 600;
        arr[2] = 700;
        arr[3] = 800;

        list.AddRange(arr);

        foreach (int val in list) {
            Console.WriteLine(val);
        }
    }
}

실행 결과

100
200
300
400
500
600
700
800

AddRange 사용 시 참고 사항

• AddRange는 IEnumerable<T> 인터페이스를 구현하는 모든 컬렉션(배열, List, HashSet 등)을 인자로 받을 수 있습니다.
• 요소를 반복문으로 하나씩 추가하는 것보다 성능 면에서 유리한 경우가 많습니다.
• 추가되는 요소들은 항상 리스트의 맨 뒤에 순서대로 삽입됩니다.