ObjectQuery<T>.Union(ObjectQuery<T>) Метод
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Сочетает результаты запроса с результатами другого запроса объектов и исключает повторы.
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>, эквивалентный первоначальному экземпляру с примененным предложением UNION для добавления результатов указанного элемента query
.
Исключения
Параметр 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 переданного query
объекта должны быть доступны для типов столбцов в DbDataRecordObjectQuery<T>.DbDataRecordObjectQuery<T>
Параметры, определенные в предоставленном query
, объединяются с параметрами, определенными в экземпляре ObjectQuery<T> . Параметры должны быть уникальными в объединенной коллекции ObjectParameterCollection. В объединенной коллекции не могут находиться два параметра, имеющие одинаковое имя. Дополнительные сведения см. в разделе Методы построителя запросов.
Результирующий запрос наследует соединение от экземпляра ObjectQuery<T>, для которого вызывался метод Union.