Docs Menu

Docs HomeC#/.NET

Find a Document

On this page

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

You can retrieve a document by using the Find() method on a collection object.

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 find a document in the restaurants collection that has a name field with a value of "Bagels N Buns".

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

The following example uses LINQ to find a document in the restaurants collection that has a name field with a value of "Bagels N Buns".

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

Running any of the preceding full examples prints results similar to the following:

{
"_id" : ObjectId("5eb3d668b31de5d588f42950"),
"name" : "Bagels N Buns",
"restaurant_id" : "40363427",
"cuisine" : "Delicatessen",
"address" : {...},
"borough" : "Staten Island",
"grades" : [...]
}

To learn more about retrieving documents, see the Retrieve Data guide.

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

To learn how to find a document using LINQ, see LINQ.

  • Find()

  • FirstOrDefault()

  • FirstOrDefaultAsync()

←  Usage ExamplesFind Multiple Documents →
Share Feedback
© 2023 MongoDB, Inc.

About

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