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

定義

命名空間:

System.Data.Objects

組件:

System.Data.Entity.dll

結合此查詢的結果與另一個物件查詢的結果，但不包含任何重複項目。

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)

參數

query

ObjectQuery<T>

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

傳回

ObjectQuery<T>

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

例外狀況

ArgumentNullException

query 參數為 null。

範例

這個範例會使用 Union 方法來建立新的 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.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);
    }
}

備註

Union 會新增提供 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> 的 Union 執行個體繼承連接。

另請參閱

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