Actualizar campos en un solo documento

Overview

En esta página, puede aprender a usar el controlador MongoDB .NET/C# para actualizar campos en un documento MongoDB. Esta página describe cómo crear... UpdateDefinition<TDocument> Objetos que especifican las operaciones de actualización que desea realizar en los campos. Puede pasar estos objetos a los métodos de actualización descritos en la Actualizar una página.

El controlador .NET/C# admite los operadores de actualización de campo descritos en Manual del servidor MongoDB. Para especificar una operación de actualización, llame al método correspondiente desde la Builders.Update propiedad. Las siguientes secciones describen estos métodos con más detalle.

public class Restaurant
{
    public ObjectId Id { get; set; }
    public string Name { get; set; }
    [BsonElement("restaurant_id")]
    public string RestaurantId { get; set; }
    public string Cuisine { get; set; }
    public Address Address { get; set; }
    public string Borough { get; set; }
    public List<GradeEntry> Grades { get; set; }
}

public class Address
{
    public string Building { get; set; }
    [BsonElement("coord")]
    public double[] Coordinates { get; set; }
    public string Street { get; set; }
    [BsonElement("zipcode")]
    public string ZipCode { get; set; }
}

public class GradeEntry
{
    public DateTime Date { get; set; }
    public string Grade { get; set; }
    public float? Score { get; set; }
}

Incrementar un valor

Para aumentar el valor de un campo en una cantidad específica, llama al método Builders.Update.Inc(). Este método acepta los siguientes parámetros:

El siguiente ejemplo de código usa el método Inc() para incrementar el valor de Score en 2 en el primer objeto GradeEntry del arreglo de Grades en el documento correspondiente:

var filter = Builders<Restaurant>.Filter.Eq("name", "Casa Bella");
var update = Builders<Restaurant>.Update
    .Inc(restaurant => restaurant.Grades[0].Score, 2);
var result = _restaurantsCollection.UpdateOne(filter, update);

var filter = Builders<Restaurant>.Filter.Eq("name", "Casa Bella");
var update = Builders<Restaurant>.Update
    .Inc(restaurant => restaurant.Grades[0].Score, 2);
var result = await _restaurantsCollection.UpdateOneAsync(filter, update);

Multiplicar un valor

Para multiplicar el valor de un campo por una cantidad específica, se debe llamar al método Builders.Update.Mul(). Este método toma los siguientes parámetros:

El siguiente ejemplo de código usa el método Mul() para multiplicar el valor Score por 1.25 en el primer objeto GradeEntry del arreglo Grades en el documento coincidente:

var filter = Builders<Restaurant>.Filter.Eq("name", "Casa Bella");
var update = Builders<Restaurant>.Update
    .Mul(restaurant => restaurant.Grades[0].Score, 1.25f);
var result = _restaurantsCollection.UpdateOne(filter, update);

var filter = Builders<Restaurant>.Filter.Eq("name", "Casa Bella");
var update = Builders<Restaurant>.Update
    .Mul(restaurant => restaurant.Grades[0].Score, 1.25f);
var result = await _restaurantsCollection.UpdateOneAsync(filter, update);

Renombrar un campo

Para cambiar el nombre de un campo, se debe llamar al método Builders.Update.Rename(). Este método acepta los siguientes parámetros:

En el siguiente ejemplo de código, se utiliza el método Rename() para renombrar el campo Address a location en el documento correspondiente:

var filter = Builders<Restaurant>.Filter.Eq("name", "Casa Bella");
var update = Builders<Restaurant>.Update
    .Rename(restaurant => restaurant.Address, "location");
var result = _restaurantsCollection.UpdateOne(filter, update);

var filter = Builders<Restaurant>.Filter.Eq("name", "Casa Bella");
var update = Builders<Restaurant>.Update
    .Rename(restaurant => restaurant.Address, "location");
var result = await _restaurantsCollection.UpdateOneAsync(filter, update);

Establece un valor

Para establecer el valor de un campo en un valor concreto, llama al método Builders.Update.Set(). Este método acepta los siguientes parámetros:

En el siguiente ejemplo de código, se utiliza el método Set() para renombrar el campo recommended a true en el documento correspondiente:

var filter = Builders<Restaurant>.Filter.Eq("name", "Casa Bella");
var update = Builders<Restaurant>.Update
    .Set("recommended", true);
var result = _restaurantsCollection.UpdateOne(filter, update);

var filter = Builders<Restaurant>.Filter.Eq("name", "Casa Bella");
var update = Builders<Restaurant>.Update
    .Set("recommended", true);
var result = await _restaurantsCollection.UpdateOneAsync(filter, update);

Establecido por comparación

Para actualizar el valor del campo a un valor especificado, pero solo si el valor especificado es mayor que el valor actual del campo, se debe llamar al método Builders.Update.Max(). Este método acepta los siguientes parámetros:

Para actualizar el valor del campo a un valor especificado, pero solo si el valor especificado es menor que el valor actual del campo, se debe llamar al método Builders.Update.Min(). Este método toma los siguientes parámetros:

El siguiente ejemplo de código utiliza el método Max() para establecer el campo Score del primer objeto GradeEntry al mayor de 20 y el valor actual en el documento correspondiente:

var filter = Builders<Restaurant>.Filter.Eq("name", "Casa Bella");
var update = Builders<Restaurant>.Update
    .Max(restaurant => restaurant.Grades[0].Score, 20);
var result = _restaurantsCollection.UpdateOne(filter, update);

var filter = Builders<Restaurant>.Filter.Eq("name", "Casa Bella");
var update = Builders<Restaurant>.Update
    .Max(restaurant => restaurant.Grades[0].Score, 20);
var result = await _restaurantsCollection.UpdateOneAsync(filter, update);

Configurar al insertar

Para establecer el valor de un campo solo si el documento se insertó en la misma operación, llama al método Builders.Update.SetOnInsert(). Este método acepta los siguientes parámetros:

El siguiente ejemplo de código utiliza el método SetOnInsert() para establecer el campo recommended a true en el documento correspondiente:

var filter = Builders<Restaurant>.Filter.Eq("name", "Patty's Pies");
var update = Builders<Restaurant>.Update
    .SetOnInsert("recommended", true);
var result = _restaurantsCollection.UpdateOne(
  filter, update, new UpdateOptions { IsUpsert = true }
);

var filter = Builders<Restaurant>.Filter.Eq("name", "Patty's Pies");
var update = Builders<Restaurant>.Update
    .SetOnInsert("recommended", true);
var result = await _restaurantsCollection.UpdateOneAsync(
  filter, update, new UpdateOptions { IsUpsert = true }
);

Para aprender más sobre cómo insertar o actualizar documentos, consulta Opciones de configuración en la guía Actualiza uno.

Establece la fecha actual

Para establecer el valor de un campo en la fecha y hora actuales, se debe llamar al método Builders.Update.CurrentDate(). Este método acepta los siguientes parámetros:

El siguiente ejemplo de código utiliza el método CurrentDate() para actualizar el campo Date del primer objeto GradeEntry a la fecha actual en el documento correspondiente:

var filter = Builders<Restaurant>.Filter.Eq("name", "Casa Bella");
var update = Builders<Restaurant>.Update
    .CurrentDate(restaurant => restaurant.Grades[0].Date);
var result = _restaurantsCollection.UpdateOne(filter, update);

var filter = Builders<Restaurant>.Filter.Eq("name", "Casa Bella");
var update = Builders<Restaurant>.Update
    .CurrentDate(restaurant => restaurant.Grades[0].Date);
var result = await _restaurantsCollection.UpdateOneAsync(filter, update);

Quita un campo

Para remover un campo de un documento, se debe llamar al método Builders.Update.Unset(). Este método acepta el siguiente parámetro:

El siguiente ejemplo de código usa el método Unset() para remover el campo Cuisine en el documento correspondiente:

var filter = Builders<Restaurant>.Filter.Eq("name", "Casa Bella");
var update = Builders<Restaurant>.Update
    .Unset(restaurant => restaurant.Cuisine);
var result = _restaurantsCollection.UpdateOne(filter, update);

var filter = Builders<Restaurant>.Filter.Eq("name", "Casa Bella");
var update = Builders<Restaurant>.Update
    .Unset(restaurant => restaurant.Cuisine);
var result = await _restaurantsCollection.UpdateOneAsync(filter, update);

Documentación de la API

Para obtener más información sobre cualquiera de los métodos que se analizan en esta guía, se debe consultar la siguiente documentación de la API:

• Builders.Update.Inc()

• Builders.Update.Mul()

• Builders.Update.Rename()

• Builders.Update.Set()

• Builders.Update.Max()

• Builders.Update.Min()

• Builders.Update.SetOnInsert()

• Builders.Update.CurrentDate()

• Builders.Update.Unset()