Open In App

C# | Adding the elements of the specified collection to the end of the List

Improve
Improve
Improve
Like Article
Like
Save Article
Save
Share
Report issue
Report

List<T>.AddRange(IEnumerable<T>) Method is used to add the elements of the specified collection to the end of the List<T>.

Properties of List:

  • It is different from the arrays. A list can be resized dynamically but arrays cannot.
  • List class can accept null as a valid value for reference types and it also allows duplicate elements.
  • If the Count becomes equals to Capacity, then the capacity of the List increases automatically by reallocating the internal array. The existing elements will be copied to the new array before the addition of the new element.

Syntax:

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

Parameter:

collection: It is the specified collection whose elements will be added to the end of the List<T>.

Exception: This method will give ArgumentNullException if the collection is null.

Note: The collection itself cannot be null, but it can contain elements that are null if type T is a reference type. The order of the elements in the collection is always preserved in the List<T>.

Below programs illustrate the use of above discussed method:

Example 1:




// C# program to illustrate the
// List.AddRange Method
using System;
using System.Collections.Generic;
  
class Geeks {
  
    // Main Method
    public static void Main(String[] args)
    {
  
        // Creating a List of Strings
        List<String> firstlist = new List<String>();
  
        // adding elements in firstlist
        firstlist.Add("Geeks");
        firstlist.Add("GFG");
        firstlist.Add("C#");
        firstlist.Add("Tutorials");
  
        Console.WriteLine("Before AddRange Method");
        Console.WriteLine();
  
        // displaying the item of List
        foreach(String str in firstlist)
        {
            Console.WriteLine(str);
        }
  
        Console.WriteLine("\nAfter AddRange Method\n");
  
        // Here we are using AddRange method
        // Which adds the elements of firstlist
        // Collection in firstlist again i.e.
        // we have copied the whole firstlist
        // in it
        firstlist.AddRange(firstlist);
  
        // displaying the item of List
        foreach(String str in firstlist)
        {
            Console.WriteLine(str);
        }
    }
}


Output:

Before AddRange Method

Geeks
GFG
C#
Tutorials

After AddRange Method

Geeks
GFG
C#
Tutorials
Geeks
GFG
C#
Tutorials

Example 2:




// C# program to illustrate the
// List.AddRange Method
using System;
using System.Collections.Generic;
  
class Geeks {
  
    // Main Method
    public static void Main(String[] args)
    {
  
        // Creating a List of Strings
        List<String> firstlist = new List<String>();
  
        // adding elements in firstlist
        firstlist.Add("Geeks");
        firstlist.Add("GFG");
        firstlist.Add("C#");
        firstlist.Add("Tutorials");
  
        Console.WriteLine("Before AddRange Method");
        Console.WriteLine();
  
        // displaying the item of List
        foreach(String str in firstlist)
        {
            Console.WriteLine(str);
        }
  
        Console.WriteLine("\nAfter AddRange Method\n");
  
        // taking array of String
        string[] str_add = { "Collections",
                             "Generic",
                             "List" };
  
        // here we are adding the elements
        // of the str_add to the end of
        // the List<T>.
        firstlist.AddRange(str_add);
  
        // displaying the item of List
        foreach(String str in firstlist)
        {
            Console.WriteLine(str);
        }
    }
}


Output:

Before AddRange Method

Geeks
GFG
C#
Tutorials

After AddRange Method

Geeks
GFG
C#
Tutorials
Collections
Generic
List

Reference:



Last Updated : 01 Feb, 2019
Like Article
Save Article
Previous
Next
Share your thoughts in the comments
Similar Reads