ObjectQuery<T>.Union(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, sem duplicatas.

public:
 System::Data::Objects::ObjectQuery<T> ^ Union(System::Data::Objects::ObjectQuery<T> ^ query);
public System.Data.Objects.ObjectQuery<T> Union (System.Data.Objects.ObjectQuery<T> query);
member this.Union : System.Data.Objects.ObjectQuery<'T> -> System.Data.Objects.ObjectQuery<'T>
Public Function Union (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 aplicado para adicionar os resultados ao query especificado.

Exceções

ArgumentNullException

O parâmetro query é null.

Exemplos

Este exemplo usa Union o método para criar um novo ObjectQuery<T> objeto .

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.Union(productQuery2);

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

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

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

Comentários

Union adiciona os resultados do fornecido query sem 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 passíveis de promoção 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 Union foi chamada.

Aplica-se a

Confira também