Atualizar um documento
Você pode atualizar um único documento utilizando o método UpdateOne() em um objeto MongoCollection. Esse método exige um filtro de query, que especifica qual documento atualizar e uma declaração de atualização, que especifica as alterações que o driver deve fazer no primeiro documento que corresponde ao filtro de query.
Observação
O método UpdateOne() atualiza somente o primeiro documento que corresponde ao filtro. Para atualizar mais de um documento, use o método UpdateMany().
Dica
Você pode passar uma instância de UpdateOptions para o método UpdateOne() para personalizar seu comportamento.
Exemplo
O exemplo a seguir usa Builders para atualizar os name do primeiro documento chamado "Bagels N Buns" na coleção restaurants para "2 Bagels 2 Buns".
Selecione a aba Asynchronous ou Synchronous para ver o código correspondente.
const string oldValue = "Bagels N Buns"; const string newValue = "2 Bagels 2 Buns"; // Creates a filter for all documents with a "name" of "Bagels N Buns" var filter = Builders<Restaurant>.Filter .Eq(restaurant => restaurant.Name, oldValue); // Creates instructions to update the "name" field of the first document // that matches the filter var update = Builders<Restaurant>.Update .Set(restaurant => restaurant.Name, newValue); // Updates the first document that has a "name" value of "Bagels N Buns" return await _restaurantsCollection.UpdateOneAsync(filter, update);
Para obter um exemplo totalmente executável da UpdateOneAsync() operação , consulte o exemplo UpdateOneAsync.
const string oldValue = "Bagels N Buns"; const string newValue = "2 Bagels 2 Buns"; // Creates a filter for all documents with a "name" of "Bagels N Buns" var filter = Builders<Restaurant>.Filter .Eq(restaurant => restaurant.Name, oldValue); // Creates instructions to update the "name" field of the first document // that matches the filter var update = Builders<Restaurant>.Update .Set(restaurant => restaurant.Name, newValue); // Updates the first document that has a "name" value of "Bagels N Buns" return _restaurantsCollection.UpdateOne(filter, update);
Para um exemplo completamente executável da UpdateOneAsync() operação , consulte o Exemplo UpdateOne.
Resultado esperado
Depois de executar um dos exemplos completos anteriores, cada chamada para UpdateOne() grava o seguinte no console:
Updated documents: 1
Dica
UpdateOne() retorna um UpdateResult evento.
MAIS INFORMAÇÕES
Para saber mais sobre como atualizar documentos, consulte o guia Modificar documentos .
Para saber mais sobre como usar construtores, consulte Operações com construtores.