ObjectQuery<T>.UnionAll(ObjectQuery<T>) 方法

定義

命名空間:

System.Data.Objects

組件:

System.Data.Entity.dll

結合此查詢的結果與另一個物件查詢的結果，而且包括所有重複項目。

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)

參數

query

ObjectQuery<T>

ObjectQuery<T>，它代表要加入的結果。

傳回

ObjectQuery<T>

新的 ObjectQuery<T> 執行個體，它就相當於套用了 UNION ALL 以便加入指定之 query 之結果的原始執行個體。

例外狀況

ArgumentNullException

query 參數為 null。

範例

這個範例會 UnionAll 使用 方法來建立新的 ObjectQuery<T> 物件。 然後，它會針對新的 Distinct 物件呼叫 ObjectQuery<T> 方法，以便取得這個查詢的唯一結果。

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);
}

備註

UnionAll 會加入提供 query 的結果，包括所有重複專案。

提供的 query ，定義要加入的結果必須是相同類型，或可升階為這個 ObjectQuery<T>類型的型別。 例如，下列專案有效，因為 DiscontinuedProducts 可以升階為 Products：

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

下列會擲回例外狀況，因為 Products 無法升級為 DiscontinuedProducts。

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

針對 型DbDataRecord別的 ，這兩個ObjectQuery<T>查詢中的記錄必須具有相同的數據行數目，而且傳遞query之 數據行中的DbDataRecord型別必須可提升至 中DbDataRecordObjectQuery<T>數據行的類型。

所提供 query 中定義的參數會與 實例中 ObjectQuery<T> 定義的參數合併。 參數在結合的 ObjectParameterCollection 中必須是唯一的。 結合的集合中不能有兩個參數同名。 如需詳細資訊，請參閱 查詢產生器方法。

結果查詢會從在上面呼叫 ObjectQuery<T> 的 UnionAll 執行個體繼承連接。

另請參閱

• 以物件形式查詢資料 (Entity Framework)