Escribe datos en MongoDB

Overview

Entity Framework Core le permite trabajar con datos en su aplicación sin ejecutar comandos de base de datos explícitamente. Puede insertar, actualizar o eliminar datos dentro de su aplicación y conservar esos cambios en MongoDB mediante... SaveChanges() o método SaveChangesAsync().

Cuando llama al método SaveChanges() o SaveChangesAsync(), el proveedor principal de EF detecta automáticamente cualquier cambio realizado en sus datos y ejecuta los comandos necesarios para actualizar la base de datos mediante la API de consulta de MongoDB.

En esta guía, puede ver ejemplos de cómo realizar operaciones de escritura comunes en una aplicación configurada para usar EF Core Provider.

Operaciones de escritura transaccional

Los métodos SaveChanges() y SaveChangesAsync() son transaccionales por defecto. Esto significa que, si se produce un error durante una operación, el proveedor revierte cualquier cambio realizado en la base de datos. Por ello, su aplicación debe estar conectada a una implementación del servidor MongoDB con capacidad para transacciones, como un conjunto de réplicas.

Puede deshabilitar las transacciones automáticas en los métodos SaveChanges() y SaveChangesAsync() configurando la propiedad AutoTransactionBehavior en AutoTransaction.Never en su subclase DbContext durante la configuración de la aplicación. Sin embargo, no recomendamos deshabilitar esta función, ya que cualquier cambio de concurrencia o fallo operativo durante la operación de guardado dejará la base de datos en un estado inconsistente.

El siguiente ejemplo muestra cómo deshabilitar las transacciones automáticas en los métodos SaveChanges() y SaveChangesAsync():

dbContext.Database.AutoTransactionBehavior = AutoTransactionBehavior.Never;

Insert

Puede utilizar el método Add() para insertar una sola entidad en su colección, o puede utilizar el método AddRange() para insertar varias entidades a la vez.

db.Planets.Add(new Planet()
{
    name = "Pluto",
    hasRings = false,
    orderFromSun = 9
});
db.SaveChanges();

var planets = new[]
{
    new Planet()
    {
        _id = ObjectId.GenerateNewId(),
        name = "Pluto",
        hasRings = false,
        orderFromSun = 9
    },
    new Planet()
    {
        _id = ObjectId.GenerateNewId(),
        name = "Scadrial",
        hasRings = false,
        orderFromSun = 10
    }
};
db.Planets.AddRange(planets);
db.SaveChanges();

Update

Para actualizar una entidad, primero recupere la entidad que desea actualizar. A continuación, realice los cambios en ella. El proveedor registra cualquier cambio realizado en la entidad, como la configuración de propiedades o la adición y eliminación de elementos de campos con valores de lista. Para guardar la actualización en MongoDB, llame al método SaveChanges(). El proveedor de EF Core compara la entidad actualizada con una instantánea de la entidad antes del cambio y actualiza automáticamente la colección mediante la API de consultas de MongoDB.

El siguiente código recupera una entidad cuyo valor name es "Mercury" y actualiza el campo name. A continuación, llama al método SaveChanges() para conservar ese cambio en la colección.

var planet = db.Planets.FirstOrDefault(p => p.name == "Mercury");
planet.name = "Mercury the first planet";
db.SaveChanges();

Borrar

Puede utilizar el método Remove() para eliminar una sola entidad de su colección, o el método RemoveRange() para eliminar varias entidades a la vez.

var planet = db.Planets.FirstOrDefault(p => p.name == "Pluto");
db.Planets.Remove(planet);
db.SaveChanges();

var pluto = db.Planets.FirstOrDefault(p => p.name == "Pluto");
var scadrial = db.Planets.FirstOrDefault(p => p.name == "Scadrial");
var planets = new[] { pluto, scadrial };
db.Planets.RemoveRange(planets);
db.SaveChanges();

Información Adicional

Para obtener más información sobre los métodos analizados en esta guía, consulte los siguientes enlaces de documentación de la API de .NET:

• Guardar cambios()

• Add()

• AddRange()

• Eliminar()

• RemoveRange()