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>

指定された query の結果を追加するために UNION を適用した元のインスタンスに相当する、新しい ObjectQuery<T> インスタンス。

例外

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>の型に昇格できる型と同じ型または 型である必要があります。 たとえば、 に昇格Productsできるため、次は有効ですDiscontinuedProducts。

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

に昇格DiscontinuedProductsできないため、次の例外Productsがスローされます。

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

ObjectQuery<T>型DbDataRecordの の場合、両方のクエリのレコードの列数が同じである必要があります。また、渡される query の の列のDbDataRecord型は、 の 内の列DbDataRecordObjectQuery<T>の型に昇格可能である必要があります。

指定された query で定義されているパラメーターは、 インスタンスで ObjectQuery<T> 定義されているパラメーターとマージされます。 パラメーターは、結合された ObjectParameterCollection 内で一意である必要があります。 結合されたコレクション内に同じ名前のパラメーターが 2 つ存在することはできません。 詳細については、「 Query Builder メソッド」を参照してください。

結果のクエリは、ObjectQuery<T> が呼び出された Union インスタンスから接続を継承します。

こちらもご覧ください

• オブジェクトとしてのデータのクエリ (Entity Framework)