El propósito principal del método (de extensión) #Include
es hacer queries con profundidad de relaciones {N:M}, {N:1}, ...
Voy a simplificar tu escenario para poder hacer un pequeño ejemplo. Supongamos estas dos entidades
public class Product
{
public int Id { get; set; }
public string Name { get; set; }
public string Description { get; set; }
// 1:N relationship
public Category Category { get; set; }
public int CategoryId { get; set; }
}
public class Category
{
public int Id { get; set; }
public string Name { get; set; }
public string Description { get; set; }
// N:1 relationship
public IList<Product> Products { get; set; }
}
Product
tiene una referencia a Category
y también añade el campo CategoryId
, que lo necesitará Entity Framework para crear la foreign key.
El nombre de la propiedad es importante que sea exactamente CategoryId
, hace referencia a la propiedad Category
y al campo Id
(de la categoría). Si necesitamos que tenga otro nombre, deberemos especificarlo a la hora de diseñar el DbContext
.
Ahora, para diseñar las relaciones, necesitamos sobreescribir el método #OnModelCreating
de la clase DbContext
.
Creamos una clase nuestra que herede de DbContext
y lo sobreescribimos.
public class SampleContext : DbContext
{
public SampleContext(DbContextOptions<SampleContext> options) : base(options) { }
public DbSet<Product> Products { get; set; }
public DbSet<Category> Categories { get; set; }
protected override void OnModelCreating(ModelBuilder builder)
{
builder.Entity<Product>(entity =>
{
entity.HasKey(p => p.Id);
entity.HasOne(p => p.Category)
.WithMany(c => c.Products);
});
builder.Entity<Category>(entity =>
{
entity.HasKey(c => c.Id);
});
}
}
Haciendo uso del builder
que nos da la API de Entity Framework, describimos las entidades y las relaciones entre ellas.
En mi caso, indico qué propiedad del modelo es la clave primaria, el Id
y las relaciones.
Indico que Product
tiene una (y sólo una) Category
y, a su vez, Category
tiene varios Product
. El método #HasOne<Product>
ya me devuelve un objeto ReferenceNavigationBuilder<T1, T2>
donde T1
es Product
y T2
es Category
porque es la propiedad que he descrito en el Func<>
que paso por parámetro, de modo que podemos usar programación fluent para definir la relación inversa.
Cuando definimos la entidad Category
no hace falta volver a indicar la relación, ya está indicada.
Para hacer efectivo este diseño a la base de datos hace falta crear una migración con el comando Add-Migration MigrationName
o dotnet migrations add MigrationName
y después volcar las migraciones a la base de datos.
Personalmente, el volcado a la base de datos lo hago directamente en mi código cada vez que arranca el servicio del siguiente modo
builder.RegisterBuildCallback(scope =>
{
var context = scope.Resolve<SampleContext>();
var db = context.Database;
// Applies migration
// Performs as the Update-Database command
db.Migrate();
});
Usando Autofac, registro una callback que se ejecuta una vez se construye el contenedor de dependencias principal. En ese momento ya puedo resolver el SampleContext
.
En caso de no usar ningún framework de inyección de dependencias, deberás proveerle al contexto la conexión a la base de datos y luego llamar al método #Update
de la DatabaseFacade
del contexto.
A la hora de hacer las queries, no tendremos más que aplicar el método #Include
e indicar qué propiedad incluir en la query.
var products = await _context.Products
.Include(product => product.Category)
.ToListAsync();
Con el namespace de EntityFrameworkCore también viene el método de extensión #ThenInclude
, que sirve para bajar un nivel de profundidad más en las relaciones.
Supongamos este escenario
public class Product
{
// ...
public IList<Provider> Providers { get; set; }
}
public class Provider
{
public int Id { get; set; }
public string Name { get; set; }
public Manufacturer Manufacturer { get; set; }
public int ManufacturerId { get; set; }
}
public class Manufacturer
{
public int Id { get; set; }
public string Name { get; set; }
}
Ahora, Product
tiene también una relación {N:1} con la tabla Providers
y, a su vez, cada Provider
tiene asociado un Manufacturer
.
Cuando hagamos la query a la base de datos, podremos traer todas las tablas relacionadas en profundidad usando los métodos #ThenInclude
e #Include
var products = await _context.Products
.Include(product => product.Category)
.Include(product => product.Providers)
.ThenInclude(provider => provider.Manufacturer)
.ToListAsync();
Si quisieramos construir un objeto con los datos procesados para no tener que tratar con las entidades puras, se puede hacer uso del método #Select
de Linq.
class ProductDto
{
public string Name { get; set; }
public string Description { get; set; }
public string CategoryName { get; set; }
public string CategoryDescription { get; set; }
}
Teniendo este DTO (Data Tranfer Object), podríamos mapearlo de la forma
IList<ProductDto> products = _context.Products
.Include(product => product.Category)
.Select<Product, ProductDto>(product =>
new ProductDto
{
Name = product.Name,
Description = product.Description,
CategoryName = product.Category.Name,
CategoryDescription = product.Category.Description
}
).ToList();
Lo importante a ver es que ya podemos acceder a la propiedad Category
de nuestro producto, ya que Entity Framework lo ha inicializado por nosotros.
Aunque siempre es mejor hacer esta operación en un segundo paso, una vez hemos salido de la capa de acceso a datos.
Espero que sirva.