Atualizar um documento
Você pode atualizar um único documento usando o UpdateOne() método em um MongoCollection
objeto . 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.
const string oldValue = "Bagels N Buns"; const string newValue = "2 Bagels 2 Buns"; var filter = Builders<Restaurant>.Filter .Eq(restaurant => restaurant.Name, oldValue); var update = Builders<Restaurant>.Update .Set(restaurant => restaurant.Name, newValue); return await _restaurantsCollection.UpdateOneAsync(filter, update);
Para obter um exemplo totalmente executável da operação UpdateOneAsync()
, consulte o exemplo UpdateOneAsync.
const string oldValue = "Bagels N Buns"; const string newValue = "2 Bagels 2 Buns"; var filter = Builders<Restaurant>.Filter .Eq(restaurant => restaurant.Name, oldValue); var update = Builders<Restaurant>.Update .Set(restaurant => restaurant.Name, newValue); return _restaurantsCollection.UpdateOne(filter, update);
Para obter um exemplo totalmente 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 saber mais sobre como atualizar documentos, consulte o guia Modificar documentos .
Para saber mais sobre como usar construtores, consulte Operações com construtores.