Entity Framework Tutorial Les filtres

Définition

Les filtres vous permettent de définir un filtre paramétré au moment de la configuration. Au moment de l'exécution, vous activez le filtre et appliquez des paramètres. Chaque requête de cette entité inclut le filtre.

Les filtres permettent de définir un prédicat qui sera appliqué à chaque entité d'un DbContext, sans que le développeur ait besoin de penser à l'inclure pour chaque requête. Les applications courantes incluent:

• Sécurité
• Locations multiples
• Partitionnement logique des données
• Suppressions douces
• Enregistrements actifs / inactifs

Configuration

FilterInterceptor doit être inscrit auprès de Entity Framework, via une classe DbConfiguration:

public class ExampleConfiguration : DbConfiguration
{
    public ExampleConfiguration()
    {
        AddInterceptor(new FilterInterceptor());
    }
}

Ou par la méthode OnModelCreating:

protected override void OnModelCreating(DbModelBuilder modelBuilder)
{
    DbInterception.Add(new FilterInterceptor());
}

Définir les filtres

Entité unique

Les filtres sont d'abord définis, puis configurés. Vous définissez le filtre sur une seule entité:

modelBuilder.Entity<Listing>()
    .Filter("ActiveListings", c => c.Condition<ListingStatus>(
        listing => listing.Status == ListingStatus.Active));

Ensemble d'entités

Les filtres sont également définis par rapport à un ensemble d'entités correspondant à un type (interface ou classe de base):

modelBuilder.Conventions.Add(
    FilterConvention.Create<IAgencyEntity, int>("Agency", (e, agencyId) => e.AgencyId == agencyId);

Activer les filtres

Les filtres sont ensuite activés et les valeurs de paramètre renseignées sur une base DbContext:

dbContext.EnableFilter("ActiveListings");
dbContext.EnableFilter("Agency")
    .SetParameter("agencyId", _userContext.CurrentUser.AgencyId);

Désactiver les filtres

Les filtres sont désactivés par défaut et vous pouvez les désactiver sélectivement après avoir activé:

dbContext.DisableFilter("ActiveListings");

Les noms de filtre doivent être uniques et les noms de paramètre de filtre correspondent au nom de paramètre fourni à l'expression de la définition de filtre.

Exigences

Version du framework d'entité

• Entity Framework 6.

Limites

• Pas d'accès au contexte pour les jointures complexes
• Propriétés de collection non disponibles

Apprendre encore plus