ObjectQuery<T>.UnionAll(ObjectQuery<T>) メソッド
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
クエリの結果を、別のオブジェクト クエリの結果と、重複をすべて含めて結合します。
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> しいオブジェクトを作成します。 次に、新しい 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>の型に昇格できる型と同じ型または 型である必要があります。 たとえば、 に昇格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> が呼び出された UnionAll インスタンスから接続を継承します。
適用対象
こちらもご覧ください
.NET