Docs Menu

Docs HomeC#/.NET

Delete a Document

On this page

  • Examples
  • Delete a Document Using Builders
  • Expected Result
  • Additional Information
  • API Documentation

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.

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; }
[BsonElement("restaurant_id")]
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; }
[BsonElement("coord")]
public double[] Coordinates { get; set; }
public string Street { get; set; }
[BsonElement("zipcode")]
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.

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.

Running either of the preceding full examples prints the following results:

Deleting a document with builders...
Deleted documents: 1

To learn more about deleting documents, see the Delete Documents guide.

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

←  Replace a DocumentDelete Many Documents →
Share Feedback
© 2023 MongoDB, Inc.

About

  • Careers
  • Investor Relations
  • Legal Notices
  • Privacy Notices
  • Security Information
  • Trust Center
© 2023 MongoDB, Inc.