Dados da consulta

Visão geral

O Entity Framework Core permite que você trabalhe com dados em seu aplicação sem executar os comandos do banco de dados de dados explicitamente. Para consultar seus dados, use a sintaxe Query integrada da linguagem (LINQ). O LINQ permite que você escreva queries fortemente digitadas usando palavras-chave e operadores específicos do C#. Quando você executa o aplicação, o EF Core Provider traduz automaticamente as queries do LINQ e as executa no banco de banco de dados usando a MongoDB Query API.

Neste guia, você pode ver exemplos de operações de query comuns em um aplicação configurado para usar o EF Core Provider.

Encontrar entidades

Encontre uma única entidade usando o método FirstOrDefault() ou encontre múltiplas entidades usando o método Where() .

var planet = db.Planets.FirstOrDefault(p => p.name == "Mercury");
Console.WriteLine(planet.name);

var planets = db.Planets.Where(p => p.hasRings);
foreach (var p in planets)
{
    Console.WriteLine(p.name);
}

Entidades de classificação

Utilize o método OrderBy() para especificar uma ordem na qual retornar entidades de uma query. OrderBy() classifica os elementos em ordem crescente com base em critérios de classificação especificados.

O código a seguir usa o método OrderBy() para encontrar todos os planetas e classificá-los pelo valor do campo orderFromSun em ordem crescente. Em seguida, ele imprime os resultados no console.

var planetList = db.Planets.OrderBy(p => p.orderFromSun);
foreach (var p in planetList)
{
   Console.WriteLine(p.name);
}

Mercury
Venus
Earth
Mars
Jupiter
Saturn
Uranus
Neptune

Você pode executar uma classificação secundária em sua query usando o método ThenBy() . O método ThenBy() classifica os resultados do método OrderBy() em ordem crescente com base em critérios de classificação especificados. O método ThenBy() deve ser encadeado ao método OrderBy() .

O código a seguir usa os métodos OrderBy() e ThenBy() para encontrar todos os planetas e classificá-los pelo campo hasRings() , com uma classificação secundária no campo name .

var planetList = db.Planets.OrderBy(o => o.hasRings).ThenBy(o => o.name);
foreach (var p in planetList)
{
   Console.WriteLine("Has rings: " + p.hasRings + ", Name: " + p.name);
}

Has rings: False, Name: Earth
Has rings: False, Name: Mars
Has rings: False, Name: Mercury
Has rings: False, Name: Venus
Has rings: True, Name: Jupiter
Has rings: True, Name: Neptune
Has rings: True, Name: Saturn
Has rings: True, Name: Uranus

Agregações escalares

O EF Core Provider oferece suporte aos seguintes métodos de agregação escalar:

• Count(): retorna o número de elementos em uma coleção ou o número de documentos que correspondem a um predicado

• LongCount(): retorna o número de elementos em uma coleção como long ou o número de documentos que correspondem a um predicado

• Any(): retorna true se algum elemento em uma coleção corresponder ao predicado

• Max(): retorna o valor máximo de um campo especificado em uma coleção

• Min(): retorna o valor mínimo de um campo especificado em uma coleção

• Sum(): retorna a soma de valores de um campo especificado em uma coleção

• Average(): retorna a média de valores de um campo especificado em uma coleção

As seções a seguir mostram exemplos de cada um dos métodos anteriores.

var planetCount = db.Planets.Count();
Console.WriteLine("Planet Count: " + planetCount);

var planetCountWithRings = db.Planets.Count(p => p.hasRings);
Console.WriteLine("Planet Count with Rings: " + planetCountWithRings);

var planetCountLong = db.Planets.LongCount();
Console.WriteLine("Long Planet Count: " + longCount);

var planetCountLongWithRings = db.Planets.LongCount(p => p.hasRings);
Console.WriteLine("Long Planet Count with Rings: " + planetCountLongWithRings);

var results = db.Planets.Any(p => p.hasRings);
foreach (var p in results)
{
    Console.WriteLine("Planet with Rings: " + p.name);
}

var furthestPlanet = db.Planets.Max(p => p.orderFromSun);
Console.WriteLine("Furthest Planet: " + furthestPlanet.name);

var closestPlanet = db.Planets.Min(p => p.OrderFromSun);
Console.WriteLine("Closest Planet: " + closestPlanet.Name);

var totalMass = db.Planets.Sum(p => p.mass);
Console.WriteLine("Total Mass of Planets: " + totalMass);

var averageMass = db.Planets.Average(p => p.mass);
Console.WriteLine("Average Mass of Planets: " + averageMass);

Informações adicionais

Para saber mais sobre aggregations no MongoDB, consulte o guia Operações de agregação no manual do MongoDB Server.

Para saber mais sobre os métodos discutidos nesta guia, consulte os seguintes links de documentação da API .NET:

• FirstOrDefault()

• onde ()

• Ordenar por ()

• Ordenar por ordem decrescente()

• EntãoBy()

• Então por ordem descendente ()