Consulta de datos

Overview

Entity Framework Core le permite trabajar con datos en su aplicación sin ejecutar comandos de base de datos explícitamente. Para consultar sus datos, utilice la sintaxis de consulta integrada en el lenguaje (LINQ). LINQ permite escribir consultas fuertemente tipadas mediante palabras clave y operadores específicos de C#. Al ejecutar la aplicación, el proveedor de EF Core traduce automáticamente las consultas LINQ y las ejecuta en la base de datos mediante la API de consultas de MongoDB.

En esta guía puede ver ejemplos de operaciones de consulta comunes en una aplicación configurada para usar EF Core Provider.

Buscar entidades

Encuentre una sola entidad utilizando el FirstOrDefault() método, o busque múltiples entidades utilizando el 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);
}

Ordenar entidades

Utilice el método OrderBy() para especificar un orden en el que devolver las entidades de una consulta. OrderBy() ordena los elementos en orden ascendente según un criterio de clasificación especificado.

El siguiente código utiliza el método OrderBy() para buscar todos los planetas y ordenarlos según el valor del campo orderFromSun en orden ascendente. Luego, imprime los resultados en la consola.

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

Puede realizar una ordenación secundaria en su consulta mediante el método ThenBy(). El método ThenBy() ordena los resultados del método OrderBy() en orden ascendente según un criterio de ordenación específico. El método ThenBy() debe estar encadenado al método OrderBy().

El siguiente código utiliza los métodos OrderBy() y ThenBy() para encontrar todos los planetas y ordenarlos por el campo hasRings(), con una ordenación secundaria en el 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

Agregaciones escalares

El proveedor principal de EF admite los siguientes métodos de agregación escalar:

• Count(): Devuelve el número de elementos de una colección o el número de documentos que coinciden con un predicado

• LongCount(): Devuelve el número de elementos en una colección como long o el número de documentos que coinciden con un predicado

• Any(): Devuelve true si algún elemento de una colección coincide con el predicado

• Max(): Devuelve el valor máximo de un campo especificado en una colección

• Min(): Devuelve el valor mínimo de un campo especificado en una colección

• Sum(): Devuelve la suma de los valores de un campo especificado en una colección

• Average(): Devuelve el promedio de los valores de un campo especificado en una colección

Las siguientes secciones muestran ejemplos de cada uno de los 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);

Información Adicional

Para obtener más información sobre las agregaciones en MongoDB, consulte Guía deoperaciones de agregación en el manual del servidor MongoDB.

Para obtener más información sobre los métodos analizados en esta guía, consulte los siguientes enlaces de documentación de la API de .NET:

• FirstOrDefault()

• Dónde()

• OrdenarPor()

• OrderByDescending()

• EntoncesPor()

• LuegoDescendiendo()