Actualiza muchos

Overview

En esta guía, puede aprender a utilizar el controlador MongoDB .NET/C# para actualizar valores en varios documentos.

El controlador .NET/C# proporciona los siguientes métodos para actualizar valores:

• UpdateMany():Actualiza uno o más campos en varios documentos.

• UpdateManyAsync(): la versión asíncrona de UpdateMany().

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; }
}

Métodos y parámetros

Los métodos UpdateMany() y UpdateManyAsync() aceptan los siguientes parámetros:

Actualizar varios valores

Los métodos UpdateMany() y UpdateManyAsync() solo aceptan un objeto UpdateDefinition cada uno. Las siguientes secciones describen cómo actualizar varios valores en una sola llamada al método.

var filter = Builders<Restaurant>.Filter
    .Eq("cuisine", "Pizza");
var combinedUpdate = Builders<Restaurant>.Update.Combine(
    Builders<Restaurant>.Update.Set("cuisine", "French"),
    Builders<Restaurant>.Update.Unset("borough")
);
_restaurantsCollection.UpdateMany(filter, combinedUpdate);

var filter = Builders<Restaurant>.Filter
    .Eq("cuisine", "Pizza");
var combinedUpdate = Builders<Restaurant>.Update.Combine(
    Builders<Restaurant>.Update.Set("cuisine", "French"),
    Builders<Restaurant>.Update.Unset("borough")
);
await _restaurantsCollection.UpdateManyAsync(filter, combinedUpdate);

var filter = Builders<Restaurant>.Filter
    .Eq("cuisine", "Pizza");
var updatePipeline = Builders<Restaurant>.Update.Pipeline(
    PipelineDefinition<Restaurant, Restaurant>.Create(
        new BsonDocument("$set", new BsonDocument("cuisine", "French")),
        new BsonDocument("$unset", "borough")
    )
);
_restaurantsCollection.UpdateMany(filter, updatePipeline);

var filter = Builders<Restaurant>.Filter
    .Eq("cuisine", "Pizza");
var updatePipeline = Builders<Restaurant>.Update.Pipeline(
    PipelineDefinition<Restaurant, Restaurant>.Create(
        new BsonDocument("$set", new BsonDocument("cuisine", "French")),
        new BsonDocument("$unset", "borough")
    )
);
await _restaurantsCollection.UpdateManyAsync(filter, updatePipeline);

Opciones de configuración

Los métodos UpdateMany() y UpdateManyAsync() aceptan opcionalmente un objeto UpdateOptions como parámetro. Puede usar este argumento para configurar la operación de actualización.

La clase UpdateOptions contiene las siguientes propiedades:

Valor de retorno

El método UpdateMany() devuelve un objeto UpdateResult y el método UpdateManyAsync() devuelve un objeto Task<UpdateResult>. La clase UpdateResult contiene las siguientes propiedades:

Información Adicional

Esta página incluye un breve laboratorio interactivo que demuestra cómo modificar datos usando el método UpdateManyAsync(). Puede completar este laboratorio directamente en la ventana de su navegador sin instalar MongoDB o un editor de código.

Para iniciar el laboratorio, haga clic en el Open Interactive Tutorial Botón en la parte superior de la página. Para ampliar el laboratorio a pantalla completa, haga clic en el botón de pantalla completa (⛶) en la esquina superior derecha del panel del laboratorio.

Para ejemplos ejecutables de las operaciones de actualización, consulta la página Actualizar varios documentos.

Para obtener más información sobre cómo crear filtros de consulta, consulte la guía Especificar una consulta.