EntityCollection<TEntity>.Add(TEntity) Método

Definição

Namespace:

System.Data.Objects.DataClasses

Assembly:

System.Data.Entity.dll

Adiciona um objeto à coleção.

public:
 virtual void Add(TEntity entity);

public void Add (TEntity entity);

override this.Add : 'Entity -> unit

Public Sub Add (entity As TEntity)

Parâmetros

entity

TEntity

Um objeto a ser adicionado à coleção. O entity deve implementar IEntityWithRelationships.

Implementações

Add(T)

Exceções

ArgumentNullException

entity é null.

Exemplos

Este exemplo é baseado no Modelo de Vendas da Adventure Works. Para executar o código neste exemplo, você já deve ter adicionado o Modelo de Vendas AdventureWorks ao seu projeto e configurado seu projeto para usar o Entity Framework. Para fazer isso, conclua os procedimentos em Como configurar manualmente um projeto do Entity Framework e Como definir manualmente os arquivos de modelo e mapeamento.

Este exemplo cria duas novas SalesOrderHeader entidades, adiciona-as Contact à entidade e, depois de remover um objeto, usa o Add método para adicionar o objeto de volta à coleção.

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 == false)
            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);
    }
}

Comentários

O Add método adiciona um objeto a um EntityCollection<TEntity> e cria uma relação entre os dois objetos. Quando o objeto de origem é anexado a uma ObjectContext instância, o Add método também adiciona o objeto ao ObjectContext. Essa operação é convertida em uma operação de inserção na fonte de dados quando SaveChanges é chamada. Para obter mais informações, consulte Criando, adicionando, modificando e excluindo objetos.

O Add método pode ser chamado várias vezes na mesma instância de objeto.