ObjectQuery<T>.Union(ObjectQuery<T>) メソッド
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
重複することなく、クエリの結果を別のオブジェクト クエリの結果と組み合わせます。
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> 。
返品
指定したqueryの結果を追加するために UNION が適用された元のインスタンスと同等の新しいObjectQuery<T> インスタンス。
例外
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の列の型は、ObjectQuery<T>のDbDataRecord内の列の型に昇格できる必要があります。
指定された query で定義されているパラメーターは、 ObjectQuery<T> インスタンスで定義されているパラメーターとマージされます。 パラメーターは、結合された ObjectParameterCollectionで一意である必要があります。 同じ名前の結合コレクションに 2 つのパラメーターを指定することはできません。 詳細については、「 クエリ ビルダーメソッド」を参照してください。
結果のクエリは、Unionが呼び出されたObjectQuery<T> インスタンスから接続を継承します。