使用英语阅读

通过

List<T>.InsertRange(Int32, IEnumerable<T>) 方法

  • 参考

定义

命名空间:
System.Collections.Generic
程序集:
System.Collections.dll
程序集:
mscorlib.dll
程序集:
netstandard.dll
Source:
List.cs
Source:
List.cs
Source:
List.cs

将集合中的元素插入 List<T> 的指定索引处。

C# 
public void InsertRange (int index, System.Collections.Generic.IEnumerable<T> collection);

参数

index
Int32

应在此处插入新元素的从零开始的索引。

collection
IEnumerable<T>

应将其元素插入到 List<T> 中的集合。 集合自身不能为 null，但它可以包含为 null 的元素（如果类型 T 为引用类型）。

例外

ArgumentNullException

collection 为 null。

ArgumentOutOfRangeException

index 小于 0。

- 或 -

index 大于 Count。

示例

以下示例演示了 InsertRange 类中作用于范围的方法和各种其他方法 List<T> 。 创建列表并填充了几只和平的植物食用恐龙的名称后， InsertRange 该方法用于将三只凶猛的吃肉恐龙的数组插入到列表中，从索引位置 3 开始。

C# 
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> 接受 null 作为引用类型的有效值，并允许重复的元素。

如果新 Count (当前 Count 加上集合) 的大小将大于 Capacity，则 通过自动重新分配内部数组以适应新元素来增加 的容量 List<T> ，并在添加新元素之前将现有元素复制到新数组。

如果 index 等于 Count，则会将元素添加到 的 List<T>末尾。

集合中元素的顺序保留在 中 List<T>。

此方法是 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

另请参阅