英語で読む

次の方法で共有

List<T>.AddRange(IEnumerable<T>) メソッド

  • リファレンス

定義

名前空間:
System.Collections.Generic
アセンブリ:
System.Collections.dll
アセンブリ:
mscorlib.dll
アセンブリ:
netstandard.dll
ソース:
List.cs
ソース:
List.cs
ソース:
List.cs

指定したコレクションの要素を List<T> の末尾に追加します。

public void AddRange (System.Collections.Generic.IEnumerable<T> collection);

パラメーター

collection
IEnumerable<T>

List<T> の末尾に要素が追加されるコレクション。 コレクション自体を null にすることはできませんが、型 T が参照型の場合、コレクションに格納する要素は null であってもかまいません。

例外

ArgumentNullException

collection が nullです。

例

次の例では、範囲に対して AddRange 動作する クラスの メソッドとその他のさまざまなメソッドを List<T> 示します。 文字列の配列が作成され、コンストラクターに渡され、配列の要素がリストに設定されます。 メソッドが AddRange 呼び出され、リストが引数として使用されます。 その結果、リストの現在の要素がリストの末尾に追加され、すべての要素が複製されます。

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 (現在 Count のとコレクションのサイズ) が より Capacity大きい場合、 の List<T> 容量は、新しい要素に合わせて内部配列を自動的に再割り当てすることで増加し、新しい要素が追加される前に既存の要素が新しい配列にコピーされます。

を List<T> 増や Capacityさずに新しい要素に対応できる場合、このメソッドは O(n) 操作です。 ここで、n は追加する要素の数です。 新しい要素に対応するために容量を増やす必要がある場合、このメソッドは O(n + m) 操作になります。 ここで、n は追加する要素の数、 m は です Count。

適用対象

製品 バージョン
.NET Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 1.0, 1.1, 1.2, 1.3, 1.4, 1.6, 2.0, 2.1
UWP 10.0

こちらもご覧ください