HOWTO · Csharp

Cómo agregar una lista a otra lista en C#

Aprenda a agregar una lista a otra lista en C#

En esta página

Para anexar los elementos de una List<T> de C# a otra, llame a AddRange en la lista que debe recibirlos. El tipo de colección genérica es List<T>, donde T representa el tipo de elemento. Los elementos de origen se agregan después de los elementos existentes del destino, en su orden original. AddRange cambia el destino; no agrega la lista de origen como un elemento anidado. Use este método cuando ambas colecciones contengan tipos de elementos compatibles. Una List<T> almacena elementos de un tipo, así que elija un destino y un origen que coincidan.

Cómo agregar una lista a otra lista en C#

List<T> es una colección redimensionable cuyos elementos comparten el mismo tipo T. En este ejemplo, ambas listas contienen enteros. El espacio de nombres System.Collections.Generic proporciona List<T>, así que inclúyalo si su proyecto aún no importa ese espacio de nombres. El programa anexa la segunda lista a la primera y luego imprime la lista de destino resultante:

La notación de tipo genérico es List<T>; reemplace T por el tipo de elemento compartido por cada elemento, como int.

Ejecute este ejemplo completo:

using System;
using System.Collections.Generic;

class Program
{
    static void Main()
    {
        List<int> firstList = new List<int> { 1, 2, 3 };
        List<int> secondList = new List<int> { 4, 5, 6 };

        firstList.AddRange(secondList);

        Console.WriteLine(string.Join(", ", firstList));
    }
}
1, 2, 3, 4, 5, 6

La llamada anexa los valores de secondList después de los valores que ya están en firstList; el destino sigue siendo una List<int> plana. Ambas listas deben tener tipos de elementos compatibles. Por ejemplo, una List<int> no puede recibir cadenas de una List<string> mediante esta llamada. Convierta o asigne los elementos primero si el destino necesita un tipo diferente.

Anexar una lista con List.AddRange

AddRange es un método de instancia de List<T>. Llámelo en el destino y pase una colección que proporcione elementos del mismo T. Su parámetro es IEnumerable<T>, por lo que el origen puede ser una matriz u otra secuencia compatible; no tiene que ser otra List<T>. Por ejemplo, firstList.AddRange(secondList) anexa la secuencia de origen al final de firstList.

El método enumera el origen y anexa sus elementos en el orden de la secuencia. Después de la llamada, firstList contiene sus valores originales seguidos de los valores de secondList, mientras que secondList conserva sus propios elementos. Esta distinción es importante cuando el código posterior aún necesita la colección de origen. Si también necesita conservar el destino, llame a AddRange en una lista separada, como se muestra en la siguiente sección.

Mantener las listas originales sin cambios

Para combinar dos entradas sin cambiar ninguna de ellas, cree un nuevo destino a partir de la primera lista y anexe la segunda lista a él: List<int> combined = new List<int>(firstList); seguido de combined.AddRange(secondList);. El constructor copia los elementos de la primera entrada en una nueva lista, y el método cambia solo ese nuevo destino. Use combined para la secuencia unida; las listas originales permanecen disponibles en su estado anterior.

Esto es una copia superficial. Copia la estructura de la lista y las referencias a los elementos, no los objetos a los que hacen referencia los elementos. Para tipos de valor como int, los valores se copian en la nueva lista. Para tipos de referencia, la nueva lista y la lista original siguen apuntando a los mismos objetos. Si esos objetos son mutables y necesitan un estado independiente, cree también copias de los objetos.

Agregar listas de objetos personalizados

AddRange también funciona con clases personalizadas cuando los elementos de origen se pueden almacenar en el destino. Por ejemplo, si people y peopleToAdd son ambas List<Person>, llamar a people.AddRange(peopleToAdd) coloca cada persona después de las entradas existentes. Luego puede iterar sobre people y leer una propiedad como person.Name para mostrarlas o procesarlas.

El método anexa referencias a las instancias Person existentes; no clona los objetos. Cambiar una persona mutable a través de cualquiera de las listas es visible a través de la otra lista porque ambas listas se refieren a esa misma instancia. El mismo enfoque se aplica a otros tipos personalizados, como productos o registros de usuarios, siempre que sus tipos de elementos sean compatibles con la T del destino.