Puede actualizar un único documento utilizando el método UpdateOne() en un MongoCollection objeto. Este método requiere un filtro de consulta, que especifica qué documento actualizar, y una instrucción de actualización, que especifica los cambios que el controlador debe realizar en el primer documento que coincida con el filtro de consulta.
Nota
El método UpdateOne() actualiza solo el primer documento que cumpla con el filtro. Para actualizar más de un documento, utiliza el método UpdateMany().
Tip
Puedes pasar una instancia de UpdateOptions al UpdateOne() método para personalizar su comportamiento.
Ejemplo
El siguiente ejemplo utiliza Builders para actualizar el name del primer documento denominado «Bagels N Buns» en la colección restaurants a «2 Bagels 2 Buns».
Selecciona la pestaña Asynchronous o Synchronous para ver el código correspondiente.
// Creates a filter for all documents with a "name" of "Bagels N Buns" var filter = Builders<Restaurant>.Filter .Eq(restaurant => restaurant.Name, "Bagels N Buns"); // Creates instructions to update the "name" field of the first document // that matches the filter var update = Builders<Restaurant>.Update .Set(restaurant => restaurant.Name, "2 Bagels 2 Buns"); // Updates the first document that has a "name" value of "Bagels N Buns" return await _restaurantsCollection.UpdateOneAsync(filter, update);
Para un ejemplo completamente ejecutable de la operación UpdateOneAsync(), consulta el Ejemplo de UpdateOneAsync.
// Creates a filter for all documents with a "name" of "Bagels N Buns" var filter = Builders<Restaurant>.Filter .Eq(restaurant => restaurant.Name, "Bagels N Buns"); // Creates instructions to update the "name" field of the first document // that matches the filter var update = Builders<Restaurant>.Update .Set(restaurant => restaurant.Name, "2 Bagels 2 Buns"); // Updates the first document that has a "name" value of "Bagels N Buns" return _restaurantsCollection.UpdateOne(filter, update);
Para ver un ejemplo completamente operativo de la operación UpdateOneAsync(), consulta el Ejemplo de UpdateOne.
Resultado esperado
Después de ejecutar cualquiera de los ejemplos completos anteriores, cada llamada a UpdateOne() escribe lo siguiente en la consola:
Updated documents: 1
Tip
UpdateOne() devuelve un objeto UpdateResult.
Más información
Para obtener más información sobre cómo actualizar documentos, consulta la guía Actualiza uno.
Para obtener más información sobre el uso de los desarrolladores, consulta Operaciones con Desarrolladores.