Delete a Document
On this page
You can delete a document from a collection by using the synchronous
DeleteOne()
method, or the asynchronous DeleteOneAsync()
method.
Note
The DeleteOne()
method deletes only the first document that matches the filter.
To delete more than one document, use the DeleteMany()
method.
To learn more about using DeleteMany()
, see Delete Many Documents.
Examples
The examples on this page use the following Restaurant
, Address
, and GradeEntry
classes as models:
public class Restaurant { public ObjectId Id { get; set; } public string Name { get; set; } [ ] public string RestaurantId { get; set; } public string Cuisine { get; set; } public Address Address { get; set; } public string Borough { get; set; } public List<GradeEntry> Grades { get; set; } }
public class Address { public string Building { get; set; } [ ] public double[] Coordinates { get; set; } public string Street { get; set; } [ ] public string ZipCode { get; set; } }
public class GradeEntry { public DateTime Date { get; set; } public string Grade { get; set; } public float Score { get; set; } }
Note
The documents in the restaurants
collection use the camel-case naming
convention. The examples in this guide use a ConventionPack
to deserialize the fields in the collection into Pascal case and map them to
the properties in the Restaurant
class.
To learn more about custom serialization, see Custom Serialization.
Delete a Document Using Builders
The following example uses Builders
to delete a document in
the restaurants
collection with the name
"Ready Penny Inn".
Select the Asynchronous or Synchronous tab to see the corresponding code.
Expected Result
Running either of the preceding full examples prints the following results:
Deleting a document with builders... Deleted documents: 1
Additional Information
To learn more about deleting documents, see the Delete Documents guide.
To learn more about using builders, see Operations with Builders.