C# | Insert at the specified index in StringCollection

StringCollection class is a new addition to the .NET Framework class library that represents a collection of strings. StringCollection class is defined in the System.Collections.Specialized namespace.
StringCollection.Insert(Int32, String) method is used to insert a string into the StringCollection at the specified index.

Syntax:

public void Insert (int index, string value);

Parameters:

• index: The zero-based index at which value is inserted.
• value: The string to insert. The value can be null.

Exception: This method will give ArgumentOutOfRangeException if the index is less than zero Or index is greater than Count.

Note:

• Duplicate strings are allowed in StringCollection.
• If index is equal to Count, value is added to the end of StringCollection.
• This method is an O(n) operation, where n is Count.

Below programs illustrate the use of StringCollection.Insert(Int32, String) Method:

Example 1:

// C# code to insert a string into
// the StringCollection at the
// specified index
using System;
using System.Collections;
using System.Collections.Specialized;

class GFG {

    // Driver code
    public static void Main()
    {

        // creating a StringCollection named myCol
        StringCollection myCol = new StringCollection();

        // Inserting elements into the string
        // at specified indexes
        myCol.Insert(0, "A");
        myCol.Insert(1, "B");
        myCol.Insert(2, "F");
        myCol.Insert(3, "L");
        myCol.Insert(4, "Y");
        myCol.Insert(5, "Z");

        // Displaying the elements in StringCollection
        foreach(Object obj in myCol)
        {
            Console.WriteLine(obj);
        }
    }
}

Output:

A
B
F
L
Y
Z

Example 2:

// C# code to insert a string into
// the StringCollection at the
// specified index
using System;
using System.Collections;
using System.Collections.Specialized;

class GFG {

    // Driver code
    public static void Main()
    {

        // creating a StringCollection named myCol
        StringCollection myCol = new StringCollection();

        // Inserting elements into the string
        // at specified indexes
        myCol.Insert(0, "2");
        myCol.Insert(1, "4");

        // This should raise exception
        // "ArgumentOutOfRangeException" as
        // index is less than 0
        myCol.Insert(-3, "6");

        myCol.Insert(3, "8");
        myCol.Insert(4, "10");
        myCol.Insert(5, "12");

        // Displaying the elements in StringCollection
        foreach(Object obj in myCol)
        {
            Console.WriteLine(obj);
        }
    }
}

Output:

Unhandled Exception:
System.ArgumentOutOfRangeException: Insertion index was out of range. Must be non-negative and less than or equal to size.
Parameter name: index

Reference:

• https://docs.microsoft.com/en-us/dotnet/api/system.collections.specialized.stringcollection.insert?view=netframework-4.7.2