ObjectQuery<T>.UnionAll(ObjectQuery<T>) Método

  • Referência

Definição

Namespace:
System.Data.Objects
Assembly:
System.Data.Entity.dll

Combina os resultados da consulta aos resultados de outra consulta de objeto, incluindo todas as duplicatas.

public:
 System::Data::Objects::ObjectQuery<T> ^ UnionAll(System::Data::Objects::ObjectQuery<T> ^ query);
public System.Data.Objects.ObjectQuery<T> UnionAll (System.Data.Objects.ObjectQuery<T> query);
member this.UnionAll : System.Data.Objects.ObjectQuery<'T> -> System.Data.Objects.ObjectQuery<'T>
Public Function UnionAll (query As ObjectQuery(Of T)) As ObjectQuery(Of T)

Parâmetros

query
ObjectQuery<T>

Um ObjectQuery<T> que representa os resultados a serem adicionados.

Retornos

ObjectQuery<T>

Uma nova instância de ObjectQuery<T> que é equivalente à instância original com UNION ALL aplicado para adicionar os resultados ao query especificado.

Exceções

ArgumentNullException

O parâmetro query é null.

Exemplos

Este exemplo usa o UnionAll método para criar um novo ObjectQuery<T> objeto. Em seguida, ele chama o Distinct método no novo ObjectQuery<T> objeto para obter os resultados exclusivos dessa consulta.

int productID = 100;
using (AdventureWorksEntities context =
    new AdventureWorksEntities())
{
    string queryString =
        @"SELECT VALUE product FROM AdventureWorksEntities.Products
            AS product WHERE product.ProductID < @productID";

    ObjectQuery<Product> productQuery =
        new ObjectQuery<Product>(queryString,
            context, MergeOption.NoTracking);

    ObjectQuery<Product> productQuery2 =
        new ObjectQuery<Product>(queryString,
            context, MergeOption.NoTracking);

    ObjectQuery<Product> productQuery3 =
        productQuery.UnionAll(productQuery2);

    productQuery3.Parameters.Add(new ObjectParameter("productID", productID));

    Console.WriteLine("Result of UnionAll");
    Console.WriteLine("------------------");

    // Iterate through the collection of Product items,
    // after the UnionAll method was called on two queries.
    foreach (Product result in productQuery3)
    {
        Console.WriteLine("Product Name: {0}", result.ProductID);
    }
    ObjectQuery<Product> productQuery4 = productQuery3.Distinct();

    Console.WriteLine("\nResult of Distinct");
    Console.WriteLine("------------------");

    // Iterate through the collection of Product items.
    // after the Distinct method was called on a query.
    foreach (Product result in productQuery4)
        Console.WriteLine("Product Name: {0}", result.ProductID);
}

Comentários

UnionAll adiciona os resultados do fornecido query , incluindo todas as duplicatas.

O fornecido query que define os resultados a serem adicionados deve ser do mesmo tipo ou de um tipo que pode ser promovido para o tipo deste ObjectQuery<T>. Por exemplo, o seguinte é válido porque DiscontinuedProducts pode ser promovido a Products:

ObjectQuery<Product>.Union(ObjectQuery<DiscontinuedProduct>)

O seguinte gerará uma exceção porque Products não pode ser promovido a DiscontinuedProducts.

ObjectQuery <DiscontinuedProduct>.Union(ObjectQuery<Product>)

Para um ObjectQuery<T> do tipo DbDataRecord, os registros em ambas as consultas devem ter o mesmo número de colunas, e os tipos nas colunas do DbDataRecord passado query devem ser promovíveis para os tipos das colunas no DbDataRecord do ObjectQuery<T>.

Os parâmetros definidos no fornecido são mesclados query com parâmetros definidos na ObjectQuery<T> instância. Os parâmetros devem ser exclusivos no combinado ObjectParameterCollection. Não pode haver dois parâmetros na coleção combinada com o mesmo nome. Para obter mais informações, consulte Métodos do Construtor de Consultas.

A consulta resultante herda a conexão da ObjectQuery<T> instância na qual UnionAll foi chamada.

Aplica-se a

Confira também