Este artigo foi traduzido por máquina. Para visualizar o arquivo em inglês, marque a caixa de seleção Inglês. Você também pode exibir o texto Em inglês em uma janela pop-up, movendo o ponteiro do mouse sobre o texto.
Tradução
Inglês

Método List<T>.InsertRange (Int32, IEnumerable<T>)

 
System_CAPS_noteObservação

The .NET API Reference documentation has a new home. Visit the .NET API Browser on docs.microsoft.com to see the new experience.

Insere os elementos de uma coleção no List<T> no índice especificado.

Namespace:   System.Collections.Generic
Assembly:  mscorlib (em mscorlib.dll)

public void InsertRange(
	int index,
	IEnumerable<T> collection
)

Parâmetros

index
Type: System.Int32

O índice baseado em zero no qual os novos elementos devem ser inseridos.

collection
Type: System.Collections.Generic.IEnumerable<T>

A coleção cujos elementos devem ser inseridos no List<T>. A coleção em si não pode ser null, mas pode conter elementos que são null, se o tipo T é um tipo de referência.

Exception Condition
ArgumentNullException

collection é null.

ArgumentOutOfRangeException

index é menor que 0.

-ou-

index é maior que Count.

List<T>aceita null como um valor válido para a referência de tipos e permite que os elementos duplicados.

Se o novo Count (atual Count mais o tamanho da coleção) será maior Capacity, a capacidade do List<T> é aumentado, automaticamente realocando a matriz interna para acomodar os novos elementos, e os elementos existentes são copiados para a nova matriz antes que os novos elementos são adicionados.

Se index é igual a Count, os elementos são adicionados ao final da List<T>.

A ordem dos elementos na coleção é preservada no List<T>.

Esse método é um O (n + m) operação, onde n é o número de elementos a serem adicionados e m é Count.

O exemplo a seguir demonstra InsertRange método e vários outros métodos do List<T> classe que atuam em intervalos. Depois que a lista foi criada e preenchida com os nomes dos vários tranquilo destruidores de fábrica dinossauros, o InsertRange método é usado para inserir uma matriz de três dinossauros um Feroz comer a parte mais importante na lista, começando no local de índice 3.

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
 */

Plataforma Universal do Windows
Disponível desde 8
.NET Framework
Disponível desde 2.0
Biblioteca de Classes Portátil
Com suporte no: plataformas portáteis do .NET
Silverlight
Disponível desde 2.0
Windows Phone Silverlight
Disponível desde 7.0
Windows Phone
Disponível desde 8.1
Retornar ao início
Mostrar: