Docs Menu
Docs Home
/
Languages
/
C#/.NET
/
C#/.NET
/
Usage Examples

Update a Document

On this page

  • Example
  • Expected Result
  • More Information
  • API Documentation

You can update a single document using the UpdateOne() method on a MongoCollection object. This method requires a query filter, which specifies which document to update, and an update statement, which specifies the changes the driver should make to the first document matching the query filter.

Note

The UpdateOne() method updates only the first document that matches the filter. To update more than one document, use the UpdateMany() method.

Tip

You can pass an instance of UpdateOptions to the UpdateOne() method in order to customize its behavior.

Example

The following example uses Builders to update the name of the first document named "Bagels N Buns" in the restaurants collection to "2 Bagels 2 Buns".

Select the Asynchronous or Synchronous tab to see the corresponding code.

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

For a fully runnable example of the UpdateOneAsync() operation, see the UpdateOneAsync Example.

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

For a fully runnable example of the UpdateOneAsync() operation, see the UpdateOne Example.

Expected Result

After running either of the preceding full examples, each call to UpdateOne() writes the following to the console:

Updated documents: 1

Tip

UpdateOne() returns an UpdateResult object.

More Information

To learn more about updating documents, see the Modify Documents guide.

To learn more about using builders, see Operations with Builders.

API Documentation

Back

Insert Multiple Documents