Enumerable.Concat<TSource> Método

Definição

Namespace:

System.Linq

Assembly:

System.Linq.dll

Origem:

Concat.cs

Concatena duas sequências.

C#

public static System.Collections.Generic.IEnumerable<TSource> Concat<TSource> (this System.Collections.Generic.IEnumerable<TSource> first, System.Collections.Generic.IEnumerable<TSource> second);

Parâmetros de tipo

TSource

O tipo dos elementos das sequências de entrada.

Parâmetros

first

IEnumerable<TSource>

A primeira sequência a ser concatenada.

second

IEnumerable<TSource>

A sequência a ser concatenada com a primeira sequência.

Retornos

IEnumerable<TSource>

Um IEnumerable<T> que contém os elementos concatenados das duas sequências de entrada.

Exceções

ArgumentNullException

first ou second é null.

Exemplos

O exemplo de código a seguir demonstra como usar Concat<TSource>(IEnumerable<TSource>, IEnumerable<TSource>) para concatenar duas sequências.

C#

class Pet
{
    public string Name { get; set; }
    public int Age { get; set; }
}

static Pet[] GetCats()
{
    Pet[] cats = { new Pet { Name="Barley", Age=8 },
                   new Pet { Name="Boots", Age=4 },
                   new Pet { Name="Whiskers", Age=1 } };
    return cats;
}

static Pet[] GetDogs()
{
    Pet[] dogs = { new Pet { Name="Bounder", Age=3 },
                   new Pet { Name="Snoopy", Age=14 },
                   new Pet { Name="Fido", Age=9 } };
    return dogs;
}

public static void ConcatEx1()
{
    Pet[] cats = GetCats();
    Pet[] dogs = GetDogs();

    IEnumerable<string> query =
        cats.Select(cat => cat.Name).Concat(dogs.Select(dog => dog.Name));

    foreach (string name in query)
    {
        Console.WriteLine(name);
    }
}

// This code produces the following output:
//
// Barley
// Boots
// Whiskers
// Bounder
// Snoopy
// Fido

Uma maneira alternativa de concatenar duas sequências é construir uma coleção, por exemplo, uma matriz, de sequências e, em seguida, aplicar o SelectMany método , passando-lhe a função seletora de identidade. O exemplo a seguir demonstra esse uso de SelectMany.

C#

Pet[] cats = GetCats();
Pet[] dogs = GetDogs();

IEnumerable<string> query =
    new[] { cats.Select(cat => cat.Name), dogs.Select(dog => dog.Name) }
    .SelectMany(name => name);

foreach (string name in query)
{
    Console.WriteLine(name);
}

// This code produces the following output:
//
// Barley
// Boots
// Whiskers
// Bounder
// Snoopy
// Fido

Comentários

Esse método é implementado usando a execução adiada. O valor retornado imediato é um objeto que armazena todas as informações necessárias para executar a ação. A consulta representada por esse método não é executada até que o objeto seja enumerado chamando seu GetEnumerator método diretamente ou usando foreach em C# ou For Each no Visual Basic.

O Concat<TSource>(IEnumerable<TSource>, IEnumerable<TSource>) método difere do Union método porque o Concat<TSource>(IEnumerable<TSource>, IEnumerable<TSource>) método retorna todos os elementos originais nas sequências de entrada. O Union método retorna apenas elementos exclusivos.

Aplica-se a