EntityCollection<TEntity>.Remove(TEntity) Metod

Definition

Namnområde:
System.Data.Objects.DataClasses
Sammansättning:
System.Data.Entity.dll

Tar bort ett objekt från samlingen och markerar relationen för borttagning.

public:
 virtual bool Remove(TEntity entity);
public bool Remove(TEntity entity);
override this.Remove : 'Entity -> bool
Public Function Remove (entity As TEntity) As Boolean

Parametrar

entity
TEntity

Objektet som ska tas bort från samlingen.

Returer

Boolean

trueom objektet har tagits bort. annars . false

Implementeringar

Remove(T)

Undantag

ArgumentNullException

entity objektet är null.

InvalidOperationException

Objektet entity är inte kopplat till samma objektkontext.

-eller-

Objektet entity har ingen giltig relationshanterare.

Exempel

Det här exemplet baseras på Adventure Works försäljningsmodell. Om du vill köra koden i det här exemplet måste du redan ha lagt till AdventureWorks Sales Model i projektet och konfigurerat projektet för att använda Entity Framework. Det gör du genom att utföra procedurerna i Så här: Konfigurera ett Entity Framework-Project och Så här: Definiera modell- och mappningsfiler manuellt.

I det Remove här exemplet används metoden för att ta bort en av entiteterna från samlingen och anropar Contains sedan metoden för att avgöra om objektet har tagits bort från samlingen.

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

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

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

    // Get all related ends
    IEnumerable<IRelatedEnd> relEnds =
        ((IEntityWithRelationships)contact)
        .RelationshipManager.GetAllRelatedEnds();

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

        Console.WriteLine("EntityCollection count: {0}",
            entityCollection.Count);
        // Remove the first entity object.
        entityCollection.Remove(newSalesOrder1);

        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}",
            entityCollection.Count);

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

        //Use IRelatedEnd to add the entity back.
        relEnd.Add(newSalesOrder1);
        Console.WriteLine("EntityCollection count after an entity has been added again: {0}",
            entityCollection.Count);
    }
}

Kommentarer

Metoden Remove tar också bort relationen mellan källobjektet och objektet som tas bort från samlingen. Om relationen har en referensintegritetsbegränsning markerar anropet Remove av metoden för ett beroende objekt både relationen och det beroende objektet för borttagning. Detta beror på att begränsningen anger att det beroende objektet inte kan finnas utan en relation till det överordnade objektet. Mer information finns i CsDL (ReferentialConstraint Element).

Remove returnerar false när det angivna objektet inte finns i samlingen.

Gäller för