EntityCollection<TEntity>.Contains Method (TEntity)


The .NET API Reference documentation has a new home. Visit the .NET API Browser on docs.microsoft.com to see the new experience.

Determines whether a specific object exists in the collection.

Namespace:   System.Data.Objects.DataClasses
Assembly:  System.Data.Entity (in System.Data.Entity.dll)

public bool Contains(
	TEntity entity


Type: TEntity

The object to locate in the EntityCollection<TEntity>.

Return Value

Type: System.Boolean

true if the object is found in the EntityCollection<TEntity>; otherwise, false.

Uses the T:System.Object.Equals method to compare the specified object with the objects already in the collection.

This example is based on the . To run the code in this example, you must have already added the AdventureWorks Sales Model to your project and configured your project to use the Entity Framework. To do this, complete the procedures in How to: Manually Configure an Entity Framework Project and How to: Manually Define the Model and Mapping Files.

This example does the following:

  1. Creates two new SalesOrderHeader entities and adds them to the Contact entity.

  2. Gets all related ends from the RelationshipManager that is associated with the Contact entity.

  3. Iterates through the collection of IRelatedEnds.

  4. Gets the EntityCollection<TEntity> for each related end.

  5. Uses the Remove method to remove one of the entities from the collection.

  6. Calls the Contains method to determine whether the object was removed from the collection.

  7. Uses the Add method to add the entity back.

using (AdventureWorksEntities context =
    new AdventureWorksEntities())
    Contact contact = new Contact();

    // Create a new SalesOrderHeader.
    SalesOrderHeader newSalesOrder1 = new SalesOrderHeader();
    // Add SalesOrderHeader to the Contact.

    // Create another SalesOrderHeader.
    SalesOrderHeader newSalesOrder2 = new SalesOrderHeader();
    // Add SalesOrderHeader to the Contact.

    // Get all related ends
    IEnumerable<IRelatedEnd> relEnds =

    foreach (IRelatedEnd relEnd in relEnds)
        // Get Entity Collection from related end
        EntityCollection<SalesOrderHeader> entityCollection =

        Console.WriteLine("EntityCollection count: {0}",
        // Remove the first entity object.

        bool contains = entityCollection.Contains(newSalesOrder1);

        // Write the number of items after one entity has been removed
        Console.WriteLine("EntityCollection count after one entity has been removed: {0}",

        if (contains == false)
            Console.WriteLine("The removed entity is not in in the collection any more.");

        //Use IRelatedEnd to add the entity back.
        Console.WriteLine("EntityCollection count after an entity has been added again: {0}",

.NET Framework
Available since 3.5
Return to top