ObjectQuery<T>.Except(ObjectQuery<T>) ObjectQuery<T>.Except(ObjectQuery<T>) ObjectQuery<T>.Except(ObjectQuery<T>) ObjectQuery<T>.Except(ObjectQuery<T>) Method

Definition

Limits the query results by excluding results based on the results of another object query.

public:
 System::Data::Objects::ObjectQuery<T> ^ Except(System::Data::Objects::ObjectQuery<T> ^ query);
public System.Data.Objects.ObjectQuery<T> Except (System.Data.Objects.ObjectQuery<T> query);
member this.Except : System.Data.Objects.ObjectQuery<'T> -> System.Data.Objects.ObjectQuery<'T>
Public Function Except (query As ObjectQuery(Of T)) As ObjectQuery(Of T)

Parameters

query
ObjectQuery<T> ObjectQuery<T> ObjectQuery<T> ObjectQuery<T>

An ObjectQuery<T> that represents the results to exclude from the query.

Returns

A new ObjectQuery<T> instance that is equivalent to the original instance with EXCEPT applied based on the specified query.

Exceptions

Examples

This example is based on the AdventureWorks Sales Model. The example uses Except method to create a new ObjectQuery<T> object and then iterates through the result of the new query.

int productID = 900;
using (AdventureWorksEntities context =
    new AdventureWorksEntities())
{
    string queryString = @"SELECT VALUE product 
        FROM AdventureWorksEntities.Products AS product";

    ObjectQuery<Product> productQuery =
        new ObjectQuery<Product>(queryString,
            context, MergeOption.NoTracking);

    string queryString2 = @"SELECT VALUE product 
        FROM AdventureWorksEntities.Products 
        AS product WHERE product.ProductID < @productID";

    ObjectQuery<Product> productQuery2 =
        new ObjectQuery<Product>(queryString2,
            context, MergeOption.NoTracking);

    productQuery2.Parameters.Add(new ObjectParameter("productID", productID));

    ObjectQuery<Product> productQuery3 =
        productQuery.Except(productQuery2);

    Console.WriteLine("Result of Except");
    Console.WriteLine("------------------");

    // Iterate through the collection of Product items
    // after the Except method was called.
    foreach (Product result in productQuery3)
        Console.WriteLine("Product Name: {0}",
            result.ProductID);
}
Dim productID = 900
Using context As New AdventureWorksEntities()
    Dim queryString As String = "SELECT VALUE product FROM AdventureWorksEntities.Products AS product"
    Dim productQuery As New ObjectQuery(Of Product)(queryString, context, MergeOption.NoTracking)

    Dim queryString2 As String = "SELECT VALUE product FROM AdventureWorksEntities.Products " & _
        " AS product WHERE product.ProductID < @productID"
    Dim productQuery2 As New ObjectQuery(Of Product)(queryString2, context, MergeOption.NoTracking)
    productQuery2.Parameters.Add(New ObjectParameter("productID", productID))

    Dim productQuery3 As ObjectQuery(Of Product) = productQuery.Except(productQuery2)

    Console.WriteLine("Result of Except")
    Console.WriteLine("------------------")

    ' Iterate through the collection of Product items 
    ' after the Except method was called. 
    For Each result As Product In productQuery3
        Console.WriteLine("Product Name: {0}", result.ProductID)
    Next
End Using

Remarks

The supplied query that defines results to exclude must be of the same type or of a type that is compatible with the ObjectQuery<T>.

Parameters that are defined in the supplied query are merged with parameters that are defined in the ObjectQuery<T> instance. Parameters must be unique in the combined ObjectParameterCollection. There cannot be two parameters in the combined collection with the same name. For more information, see Query Builder Methods.

The resulting query inherits the connection from the ObjectQuery<T> instance on which Except was called.

Applies to

See also