SaveChanges básico

DbContext.SaveChanges() es una de las dos técnicas para guardar los cambios en la base de datos con EF. Con este método, se realizan uno o varios cambios supervisados (agregar, actualizar, eliminar) y, a continuación, aplicar esos cambios llamando al método SaveChanges. Como alternativa, ExecuteUpdate y ExecuteDelete se pueden usar sin implicar al rastreador de cambios. Para una comparación introductoria de estas dos técnicas, consulte la página de información general sobre cómo guardar datos.

Sugerencia

Puede ver un ejemplo de este artículo en GitHub.

Agregar datos

Use el método DbSet<TEntity>.Add para agregar nuevas instancias de las clases de entidad. Los datos se insertarán en la base de datos cuando llame a DbContext.SaveChanges():

using (var context = new BloggingContext())
{
    var blog = new Blog { Url = "http://example.com" };
    context.Blogs.Add(blog);
    context.SaveChanges();
}

Sugerencia

Los métodos Add, Attach y Update funcionan en el gráfico completo de entidades que se les han pasado, tal como se describe en la sección de datos relacionados. También puede usar la propiedad EntityEntry.State para establecer el estado de una sola unidad. Por ejemplo, context.Entry(blog).State = EntityState.Modified.

Actualización de datos

EF detecta automáticamente los cambios hechos en una entidad existente de la que hace seguimiento el contexto. Esto incluye entidades que se cargan o consultan desde la base de datos y las entidades que se agregaron y guardaron anteriormente en la base de datos.

Solo debe modificar los valores asignados a las propiedades y llamar a SaveChanges:

using (var context = new BloggingContext())
{
    var blog = context.Blogs.Single(b => b.Url == "http://example.com");
    blog.Url = "http://example.com/blog";
    context.SaveChanges();
}

Eliminar datos

Use el método DbSet<TEntity>.Remove para eliminar instancias de las clases de entidad:

using (var context = new BloggingContext())
{
    var blog = context.Blogs.Single(b => b.Url == "http://example.com/blog");
    context.Blogs.Remove(blog);
    context.SaveChanges();
}

Si la entidad ya existe en la base de datos, se eliminará durante SaveChanges. Si la entidad aún no se ha guardado en la base de datos (es decir, se realiza un seguimiento como agregado), se quitará del contexto y ya no se insertará cuando se llame a SaveChanges.

Varias operaciones en una única llamada a SaveChanges

Puede combinar varias operaciones Add, Update y Remove en una sola llamada a SaveChanges:

using (var context = new BloggingContext())
{
    // seeding database
    context.Blogs.Add(new Blog { Url = "http://example.com/blog" });
    context.Blogs.Add(new Blog { Url = "http://example.com/another_blog" });
    context.SaveChanges();
}

using (var context = new BloggingContext())
{
    // add
    context.Blogs.Add(new Blog { Url = "http://example.com/blog_one" });
    context.Blogs.Add(new Blog { Url = "http://example.com/blog_two" });

    // update
    var firstBlog = context.Blogs.First();
    firstBlog.Url = "";

    // remove
    var lastBlog = context.Blogs.OrderBy(e => e.BlogId).Last();
    context.Blogs.Remove(lastBlog);

    context.SaveChanges();
}

Nota:

Para la mayoría de los proveedores de bases de datos, SaveChanges es transaccional. Esto significa que todas las operaciones se realizan correctamente o presentan un error y que nunca se aplicarán de manera parcial.