Para agentes de IA: um índice de documentação está disponível em https://www.mongodb.com/pt-br/docs/llms.txt — as versões de markdown de todas as páginas estão disponíveis anexando .md a qualquer caminho de URL.
Menu Docs

Encontrar um documento

Você pode recuperar um documento usando o método Find() em um objeto de coleção.

O exemplo a seguir usa Builders para localizar um documento na collection restaurants que possui um campo name com o valor "Bagels N Buns".

Selecione a aba Asynchronous ou Synchronous para ver o código correspondente.

// Creates a filter for all documents that have a "name" value of "Bagels N Buns"
var filter = Builders<Restaurant>.Filter
.Eq(r => r.Name, "Bagels N Buns");
// Asynchronously retrieves the first document that matches the filter
return await _restaurantsCollection.Find(filter).FirstOrDefaultAsync();

Para conferir um exemplo totalmente funcional de uso do método Find() para encontrar um documento de forma assíncrona, consulte este exemplo para encontrar um de forma assíncrona.

// Creates a filter for all documents that have a "name" value of "Bagels N Buns"
var filter = Builders<Restaurant>.Filter
.Eq(r => r.Name, "Bagels N Buns");
// Retrieves the first document that matches the filter
var restaurant = _restaurantsCollection.Find(filter).FirstOrDefault();

Para obter um exemplo totalmente executável do uso do método Find() para encontrar um documento de forma síncrona, consulte o Exemplo de encontrar um documento síncrono.

O exemplo a seguir usa LINQ para localizar um documento na coleção restaurants que possui um campo name com o valor "Bagels N Buns".

Selecione a aba Asynchronous ou Synchronous para ver o código correspondente.

return await _restaurantsCollection.AsQueryable()
.Where(r => r.Name == "Bagels N Buns").FirstOrDefaultAsync();

Para conferir um exemplo totalmente funcional de uso do método Find() para encontrar um documento de forma assíncrona, consulte este exemplo para encontrar um de forma assíncrona.

var query = _restaurantsCollection.AsQueryable()
.Where(r => r.Name == "Bagels N Buns").FirstOrDefault();

Para obter um exemplo totalmente executável do uso do método Find() para encontrar um documento de forma síncrona, consulte o Exemplo de encontrar um documento síncrono.

A execução de qualquer um dos exemplos completos anteriores imprime resultados semelhantes aos seguintes:

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

Para saber mais sobre como recuperar documentos, consulte o guia Recuperar dados.

Para saber mais sobre como usar construtores, consulte Operações com construtores.

Para saber como encontrar um documento usando LINQ, consulte Sintaxe LINQ para operações de agregação.