ObjectQuery<T>.UnionAll(ObjectQuery<T>) メソッド

定義

クエリの結果と、すべての重複を含む別のオブジェクト クエリの結果を組み合わせます。

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>

返品

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

例外

query パラメーターはnull

この例では、 UnionAll メソッドを使用して新しい ObjectQuery<T> オブジェクトを作成します。 次に、新しいObjectQuery<T> オブジェクトのDistinct メソッドを呼び出して、このクエリの一意の結果を取得します。

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

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

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

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

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

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

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

適用対象

こちらもご覧ください