Exportar (0) Imprimir
Expandir Tudo
Este artigo foi traduzido por máquina. Coloque o ponteiro do mouse sobre as frases do artigo para ver o texto original. Mais informações.
Tradução
Original

Método List<T>.InsertRange

Insere os elementos de uma coleção em 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
Tipo: System.Int32
O índice de base zero no qual os novos elementos devem ser inseridos.
collection
Tipo: System.Collections.Generic.IEnumerable<T>
A coleção cujos elementos devem ser inseridos em 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.

ExceçãoCondição
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 e permite digitar os elementos duplicados.

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

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

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

Este método é uma operação denm(+), onde n é o número de elementos a serem adicionados e m é Count.

O exemplo a seguir demonstra o método de InsertRange e os vários métodos de List<T> classificação que agem em intervalos. Após a lista foi criada e populada com os nomes de vários dinossauros calmos planta- ter, o método de InsertRange é usado para inserir uma matriz de três dinossauros carnívoros ferozes na lista, começando em 3. local do índice.


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


.NET Framework

Com suporte em: 4.5.2, 4.5.1, 4.5, 4, 3.5, 3.0, 2.0

.NET Framework Client Profile

Com suporte em: 4, 3.5 SP1

Biblioteca de Classes Portátil

Com suporte em: Biblioteca de Classes Portátil

.NET para aplicativos da Windows Store

Com suporte em: Windows 8

.NET para aplicativos do Windows Phone

Com suporte em: Windows Phone 8, Silverlight 8.1

Windows Phone 8.1, Windows Phone 8, Windows 8.1, Windows Server 2012 R2, Windows 8, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008 (Função Server Core sem suporte), Windows Server 2008 R2 (Função Server Core com suporte com o SP1 ou posterior, Itanium sem suporte)

O .NET Framework não oferece suporte a todas as versões de cada plataforma. Para obter uma lista das versões com suporte, consulte Requisitos do sistema do .NET Framework.

Contribuições da comunidade

ADICIONAR
A Microsoft está realizando uma pesquisa online para saber sua opinião sobre o site do MSDN. Se você optar por participar, a pesquisa online lhe será apresentada quando você sair do site do MSDN.

Deseja participar?
Mostrar:
© 2014 Microsoft