Você pode atualizar um único documento usando o método UpdateOne() em um objeto MongoCollection. Esse método exige um filtro de consulta, 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.
// 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 obter um exemplo totalmente executável da operação UpdateOneAsync(), consulte o exemplo 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 um exemplo completamente executável da operação UpdateOneAsync(), 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 objeto UpdateResult.
MAIS INFORMAÇÕES
Para aprender mais sobre como atualizar documentos, consulte o guia Update One.
Para saber mais sobre como usar construtores, consulte Operações com construtores.