Overview
Entity Framework Core te permite trabajar con datos en tu aplicación sin ejecutar explícitamente comandos de base de datos. Para consultar sus datos, utilice la sintaxis de query integrada en el lenguaje (LINQ). LINQ te permite guardar queries fuertemente tipadas utilizando palabras clave y operadores específicos de C#. Cuando ejecutas la aplicación, el proveedor de EF Core traduce automáticamente las consultas LINQ y las ejecuta en la base de datos utilizando la API de consultas de MongoDB.
En esta guía, puedes ver ejemplos de operaciones de query comunes en una aplicación configurada para utilizar el proveedor EF Core.
Tip
Para aprender a configurar una aplicación para usar el Proveedor EF Core, consulta Configura el proveedor EF Core.
Datos de muestra
Los ejemplos de esta guía utilizan el planets colección de la base de datos sample_guides. Los documentos en esta colección utilizan la siguiente clase Planet como modelo:
public class Planet { public ObjectId _id { get; set; } public string name { get; set; } = null!; public int orderFromSun { get; set; } public bool hasRings { get; set; } }
Esta colección es de la conjuntos de datos de muestra proporcionados por Atlas. Consulta la guía Inicio rápido para aprender a crear un clúster gratuito de MongoDB y cargar estos datos de muestra.
Buscar entidades
Encuentra una sola entidad usando el método FirstOrDefault(), o encuentra varias entidades usando el método Where().
Encuentra una entidad individual
El método FirstOrDefault() devuelve la primera entidad que encuentra en tu colección que coincide con los criterios de búsqueda y devuelve null si no se encuentran entidades coincidentes.
El siguiente código utiliza el método FirstOrDefault() para encontrar un planeta en el campo name de “Mercurio” a partir de un DBSet llamado Planets e imprime el nombre del planeta en la consola:
var planet = db.Planets.FirstOrDefault(p => p.name == "Mercury"); Console.WriteLine(planet?.name);
Encontrar varios entidades
Puedes utilizar el método Where() para recuperar múltiples entidades de tus colecciones. Where() devuelve todas las entidades que coinciden con los criterios de búsqueda.
El siguiente código usa el método Where() para encontrar todos los planetas que tengan el campo hasRings establecido en true e imprime los nombres de los planetas en la consola.
var planets = db.Planets.Where(p => p.hasRings); foreach (var p in planets) { Console.WriteLine(p.name); }
Query a Shadow Property
Una propiedad en la sombra es una propiedad que no está definida en su clase de entidad .NET, pero que está incluida en el modelo de Entity Framework y está mapeada a campos en la base de datos. Puede utilizar las propiedades ocultas para query o rastrear datos en sus documentos sin exponerlo como una propiedad en su entidad.
Para hacer referencia a una propiedad sombra en una query LINQ, llama al método EF.Property<T>() y pasa el nombre de la propiedad configurada como argumento. El argumento de tipo genérico debe coincidir con el tipo de datos de la propiedad shadow.
Por ejemplo, la clase Planet no define una propiedad para el campo mainAtmosphere. Para configurar este campo como una propiedad sombra, llame al método Property<T>() en el método OnModelCreating() de PlanetDbContext, como se muestra en el siguiente ejemplo:
public class PlanetDbContext : DbContext { public DbSet<Planet> Planets { get; init; } = null!; public static PlanetDbContext Create(IMongoDatabase database) => new(new DbContextOptionsBuilder<PlanetDbContext>() .UseMongoDB(database.Client, database.DatabaseNamespace.DatabaseName) .Options); public PlanetDbContext(DbContextOptions options) : base(options) { } protected override void OnModelCreating(ModelBuilder modelBuilder) { base.OnModelCreating(modelBuilder); modelBuilder.Entity<Planet>().ToCollection("planets"); modelBuilder.Entity<Planet>().Property<string[]>("mainAtmosphere"); } }
La llamada a modelBuilder.Entity<Planet>().Property<string[]>("mainAtmosphere") le indica al framework que incluya mainAtmosphere en el modelo y lo asigne a un campo string[] en MongoDB.
El siguiente código utiliza el método EF.Property<string[]>() para encontrar todos los planetas que tienen una propiedad de sombra mainAtmosphere no vacía y imprime los nombres de los planetas en la consola:
var planets = db.Planets.Where( p => EF.Property<string[]>(p, "mainAtmosphere").Length > 0); foreach (var p in planets) { Console.WriteLine(p.name); }
Ordenar entidades
Usa el método OrderBy() para especificar un orden en el que devolver las entidades de una query. 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 encontrar todos los planetas y ordenarlos por 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
Tip
Ordenar en orden descendente
Puedes ordenar los resultados de una query en orden descendente utilizando el método OrderByDescending().
Puedes realizar una clasificación secundaria en tu query utilizando 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 especificado. El método ThenBy() debe encadenarse al método OrderBy().
Tip
Ordenación secundaria en orden descendente
Puedes realizar una ordenación secundaria en orden descendente utilizando el método ThenByDescending().
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 por 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
Tip
Al ordenar campos con un valor booleano, las entidades con un valor de campo de false se muestran antes que aquellas con un valor de true.
Información Adicional
Para aprender más información sobre los métodos tratados en esta guía, consulte los siguientes enlaces a la documentación de la API de .NET: