Queryable.Concat<TSource> Método

Definição

Namespace:

System.Linq

Assembly:

System.Linq.Queryable.dll

Origem:

Queryable.cs

Concatena duas sequências.

C#

public static System.Linq.IQueryable<TSource> Concat<TSource> (this System.Linq.IQueryable<TSource> source1, System.Collections.Generic.IEnumerable<TSource> source2);

Parâmetros de tipo

TSource

O tipo dos elementos das sequências de entrada.

Parâmetros

source1

IQueryable<TSource>

A primeira sequência a ser concatenada.

source2

IEnumerable<TSource>

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

Retornos

IQueryable<TSource>

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

Exceções

ArgumentNullException

source1 ou source2 é null.

Exemplos

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

C#

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

// This method creates and returns an array of Pet objects.
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;
}

// This method creates and returns an array of Pet objects.
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();

    // Concatenate a collection of cat names to a
    // collection of dog names by using Concat().
    IEnumerable<string> query =
        cats.AsQueryable()
        .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

Comentários

O Concat<TSource>(IQueryable<TSource>, IEnumerable<TSource>) método gera um MethodCallExpression que representa a própria chamada Concat<TSource>(IQueryable<TSource>, IEnumerable<TSource>) como um método genérico construído. Em seguida, ele passa o MethodCallExpression para o CreateQuery<TElement>(Expression) método do IQueryProvider representado pela Provider propriedade do source1 parâmetro .

O comportamento da consulta que ocorre como resultado da execução de uma árvore de expressão que representa a chamada Concat<TSource>(IQueryable<TSource>, IEnumerable<TSource>) depende da implementação do tipo do source1 parâmetro. O comportamento esperado é que os elementos em source2 são concatenados aos de source1 para criar uma nova sequência.

Aplica-se a