Partager via


IIncludableQueryable<TEntity,TProperty> Interface

Définition

Prend en charge les opérateurs de chaînage Include/ThenInclude interrogeables.

public interface IIncludableQueryable<out TEntity,out TProperty> : System.Collections.Generic.IEnumerable<out TEntity>, System.Linq.IQueryable<out TEntity>
type IIncludableQueryable<'Entity, 'Property> = interface
    interface IQueryable<'Entity>
    interface seq<'Entity>
    interface IEnumerable
    interface IQueryable
Public Interface IIncludableQueryable(Of Out TEntity, Out TProperty)
Implements IEnumerable(Of Out TEntity), IQueryable(Of Out TEntity)

Paramètres de type

TEntity

Type d'entité.

Ce paramètre de type est covariant. Cela signifie que vous pouvez utiliser le type spécifié ou tout type plus dérivé. Pour plus d’informations sur la covariance et la contravariance, consultez Covariance et contravariance dans les génériques.
TProperty

Type de propriété.

Ce paramètre de type est covariant. Cela signifie que vous pouvez utiliser le type spécifié ou tout type plus dérivé. Pour plus d’informations sur la covariance et la contravariance, consultez Covariance et contravariance dans les génériques.
Implémente

Remarques

Pour plus d’informations et d’exemples, consultez Implémentation des fournisseurs et extensions de base de données et Fonctionnement des requêtes EF Core .

Méthodes d’extension

WithPartitionKey<TEntity>(IQueryable<TEntity>, String)

Spécifiez la clé de partition pour la partition utilisée pour la requête. Obligatoire lors de l’utilisation d’un jeton de ressource qui fournit une autorisation basée sur une clé de partition pour l’authentification,

AllAsync<TSource>(IQueryable<TSource>, Expression<Func<TSource,Boolean>>, CancellationToken)

Détermine de manière asynchrone si tous les éléments d’une séquence satisfont à une condition.

AnyAsync<TSource>(IQueryable<TSource>, Expression<Func<TSource,Boolean>>, CancellationToken)

Détermine de manière asynchrone si un élément d’une séquence satisfait à une condition.

AnyAsync<TSource>(IQueryable<TSource>, CancellationToken)

Détermine de manière asynchrone si une séquence contient des éléments.

AsAsyncEnumerable<TSource>(IQueryable<TSource>)

Retourne un IAsyncEnumerable<T> qui peut être énuméré de manière asynchrone.

AsNoTracking<TEntity>(IQueryable<TEntity>)

Le suivi des modifications ne suit aucune des entités retournées à partir d’une requête LINQ. Si les instances d’entité sont modifiées, cela ne sera pas détecté par le suivi des modifications et SaveChanges() ne conservera pas ces modifications dans la base de données.

AsNoTrackingWithIdentityResolution<TEntity>(IQueryable<TEntity>)

Le suivi des modifications ne suit aucune des entités retournées à partir d’une requête LINQ. Si les instances d’entité sont modifiées, cela ne sera pas détecté par le suivi des modifications et SaveChanges() ne conservera pas ces modifications dans la base de données.

AsTracking<TEntity>(IQueryable<TEntity>)

Retourne une nouvelle requête dans laquelle le suivi des modifications effectue le suivi des modifications pour toutes les entités retournées. Toute modification apportée aux instances d’entité sera détectée et conservée dans la base de données pendant SaveChanges().

AsTracking<TEntity>(IQueryable<TEntity>, QueryTrackingBehavior)

Retourne une nouvelle requête dans laquelle le suivi des modifications effectue le suivi des modifications ou non pour toutes les entités retournées, en fonction de la valeur du paramètre « track ». Lors du suivi, toute modification apportée aux instances d’entité est détectée et conservée dans la base de données pendant SaveChanges(). En cas de non suivi, si les instances d’entité sont modifiées, cela ne sera pas détecté par le suivi des modifications et SaveChanges() ne conservera pas ces modifications dans la base de données.

AverageAsync<TSource>(IQueryable<TSource>, Expression<Func<TSource,Decimal>>, CancellationToken)

Calcule de manière asynchrone la moyenne d’une séquence de valeurs obtenue en appelant une fonction de projection sur chaque élément de la séquence d’entrée.

AverageAsync<TSource>(IQueryable<TSource>, Expression<Func<TSource,Double>>, CancellationToken)

Calcule de manière asynchrone la moyenne d’une séquence de valeurs obtenue en appelant une fonction de projection sur chaque élément de la séquence d’entrée.

AverageAsync<TSource>(IQueryable<TSource>, Expression<Func<TSource,Int32>>, CancellationToken)

Calcule de manière asynchrone la moyenne d’une séquence de valeurs obtenue en appelant une fonction de projection sur chaque élément de la séquence d’entrée.

AverageAsync<TSource>(IQueryable<TSource>, Expression<Func<TSource,Int64>>, CancellationToken)

Calcule de manière asynchrone la moyenne d’une séquence de valeurs obtenue en appelant une fonction de projection sur chaque élément de la séquence d’entrée.

AverageAsync<TSource>(IQueryable<TSource>, Expression<Func<TSource,Nullable<Decimal>>>, CancellationToken)

Calcule de manière asynchrone la moyenne d’une séquence de valeurs obtenue en appelant une fonction de projection sur chaque élément de la séquence d’entrée.

AverageAsync<TSource>(IQueryable<TSource>, Expression<Func<TSource,Nullable<Double>>>, CancellationToken)

Calcule de manière asynchrone la moyenne d’une séquence de valeurs obtenue en appelant une fonction de projection sur chaque élément de la séquence d’entrée.

AverageAsync<TSource>(IQueryable<TSource>, Expression<Func<TSource,Nullable<Int32>>>, CancellationToken)

Calcule de manière asynchrone la moyenne d’une séquence de valeurs obtenue en appelant une fonction de projection sur chaque élément de la séquence d’entrée.

AverageAsync<TSource>(IQueryable<TSource>, Expression<Func<TSource,Nullable<Int64>>>, CancellationToken)

Calcule de manière asynchrone la moyenne d’une séquence de valeurs obtenue en appelant une fonction de projection sur chaque élément de la séquence d’entrée.

AverageAsync<TSource>(IQueryable<TSource>, Expression<Func<TSource,Nullable<Single>>>, CancellationToken)

Calcule de manière asynchrone la moyenne d’une séquence de valeurs obtenue en appelant une fonction de projection sur chaque élément de la séquence d’entrée.

AverageAsync<TSource>(IQueryable<TSource>, Expression<Func<TSource,Single>>, CancellationToken)

Calcule de manière asynchrone la moyenne d’une séquence de valeurs obtenue en appelant une fonction de projection sur chaque élément de la séquence d’entrée.

ContainsAsync<TSource>(IQueryable<TSource>, TSource, CancellationToken)

Détermine de manière asynchrone si une séquence contient un élément spécifié à l’aide du comparateur d’égalité par défaut.

CountAsync<TSource>(IQueryable<TSource>, Expression<Func<TSource,Boolean>>, CancellationToken)

Retourne de manière asynchrone le nombre d’éléments d’une séquence qui répondent à une condition.

CountAsync<TSource>(IQueryable<TSource>, CancellationToken)

Retourne de manière asynchrone le nombre d’éléments dans une séquence.

ElementAtAsync<TSource>(IQueryable<TSource>, Int32, CancellationToken)

Retourne de manière asynchrone l’élément à un index spécifié dans une séquence.

ElementAtOrDefaultAsync<TSource>(IQueryable<TSource>, Int32, CancellationToken)

Retourne de manière asynchrone l’élément à un index spécifié dans une séquence, ou une valeur par défaut si l’index est hors plage.

FirstAsync<TSource>(IQueryable<TSource>, Expression<Func<TSource,Boolean>>, CancellationToken)

Retourne de manière asynchrone le premier élément d’une séquence qui satisfait à une condition spécifiée.

FirstAsync<TSource>(IQueryable<TSource>, CancellationToken)

Retourne de manière asynchrone le premier élément d’une séquence.

FirstOrDefaultAsync<TSource>(IQueryable<TSource>, Expression<Func<TSource,Boolean>>, CancellationToken)

Retourne de manière asynchrone le premier élément d’une séquence qui satisfait à une condition spécifiée ou à une valeur par défaut si aucun élément de ce type n’est trouvé.

FirstOrDefaultAsync<TSource>(IQueryable<TSource>, CancellationToken)

Retourne de manière asynchrone le premier élément d’une séquence, ou une valeur par défaut si la séquence ne contient aucun élément.

ForEachAsync<T>(IQueryable<T>, Action<T>, CancellationToken)

Énumère de manière asynchrone les résultats de la requête et effectue l’action spécifiée sur chaque élément.

IgnoreAutoIncludes<TEntity>(IQueryable<TEntity>)

Spécifie que les navigations chargées au niveau du modèle ne doivent pas être appliquées à la requête LINQ d’Entity Framework actuelle.

IgnoreQueryFilters<TEntity>(IQueryable<TEntity>)

Spécifie que les filtres de requête d’entité au niveau du modèle ne doivent pas être appliqués à la requête LINQ d’Entity Framework actuelle.

Include<TEntity>(IQueryable<TEntity>, String)

Spécifie les entités associées à inclure dans les résultats de la requête. La propriété de navigation à inclure est spécifiée en commençant par le type d’entité interrogée (TEntity). D’autres propriétés de navigation à inclure peuvent être ajoutées, séparées par le caractère « . ».

Include<TEntity,TProperty>(IQueryable<TEntity>, Expression<Func<TEntity,TProperty>>)

Spécifie les entités associées à inclure dans les résultats de la requête. La propriété de navigation à inclure est spécifiée en commençant par le type d’entité interrogée (TEntity). Si vous souhaitez inclure des types supplémentaires en fonction des propriétés de navigation du type inclus, chaînez un appel à ThenInclude<TEntity,TPreviousProperty,TProperty>(IIncludableQueryable<TEntity, IEnumerable<TPreviousProperty>>, Expression<Func<TPreviousProperty, TProperty>>) après cet appel.

LastAsync<TSource>(IQueryable<TSource>, Expression<Func<TSource,Boolean>>, CancellationToken)

Retourne de manière asynchrone le dernier élément d’une séquence qui satisfait à une condition spécifiée.

LastAsync<TSource>(IQueryable<TSource>, CancellationToken)

Retourne de manière asynchrone le dernier élément d’une séquence.

LastOrDefaultAsync<TSource>(IQueryable<TSource>, Expression<Func<TSource,Boolean>>, CancellationToken)

Retourne de manière asynchrone le dernier élément d’une séquence qui satisfait à une condition spécifiée ou à une valeur par défaut si aucun élément de ce type n’est trouvé.

LastOrDefaultAsync<TSource>(IQueryable<TSource>, CancellationToken)

Retourne de façon asynchrone le dernier élément d’une séquence, ou une valeur par défaut si la séquence ne contient aucun élément.

Load<TSource>(IQueryable<TSource>)

Énumère la requête. Lors de l’utilisation d’Entity Framework, les résultats de la requête sont chargés dans le contexte associé. Cela équivaut à appeler ToList, puis à jeter la liste (sans la surcharge liée à la création de la liste).

LoadAsync<TSource>(IQueryable<TSource>, CancellationToken)

Énumère de manière asynchrone la requête. Lors de l’utilisation d’Entity Framework, les résultats de la requête sont chargés dans le contexte associé. Cela équivaut à appeler ToList, puis à jeter la liste (sans la surcharge liée à la création de la liste).

LongCountAsync<TSource>(IQueryable<TSource>, Expression<Func<TSource,Boolean>>, CancellationToken)

Retourne de manière asynchrone un Int64 qui représente le nombre d’éléments d’une séquence qui répondent à une condition.

LongCountAsync<TSource>(IQueryable<TSource>, CancellationToken)

Retourne de manière asynchrone un Int64 qui représente le nombre total d’éléments dans une séquence.

MaxAsync<TSource>(IQueryable<TSource>, CancellationToken)

Retourne de manière asynchrone la valeur maximale d’une séquence.

MaxAsync<TSource,TResult>(IQueryable<TSource>, Expression<Func<TSource,TResult>>, CancellationToken)

Appelle de manière asynchrone une fonction de projection sur chaque élément d’une séquence et retourne la valeur maximale résultante.

MinAsync<TSource>(IQueryable<TSource>, CancellationToken)

Retourne de manière asynchrone la valeur minimale d’une séquence.

MinAsync<TSource,TResult>(IQueryable<TSource>, Expression<Func<TSource,TResult>>, CancellationToken)

Appelle de manière asynchrone une fonction de projection sur chaque élément d’une séquence et retourne la valeur minimale résultante.

SingleAsync<TSource>(IQueryable<TSource>, Expression<Func<TSource,Boolean>>, CancellationToken)

Retourne de manière asynchrone le seul élément d’une séquence qui satisfait à une condition spécifiée et lève une exception si plusieurs éléments de ce type existent.

SingleAsync<TSource>(IQueryable<TSource>, CancellationToken)

Retourne de façon asynchrone le seul élément d’une séquence et lève une exception s’il n’y a pas exactement un élément dans la séquence.

SingleOrDefaultAsync<TSource>(IQueryable<TSource>, Expression<Func<TSource,Boolean>>, CancellationToken)

Retourne de manière asynchrone le seul élément d’une séquence qui satisfait à une condition spécifiée ou à une valeur par défaut si aucun élément de ce type n’existe ; cette méthode lève une exception si plusieurs éléments satisfont à la condition.

SingleOrDefaultAsync<TSource>(IQueryable<TSource>, CancellationToken)

Retourne de manière asynchrone le seul élément d’une séquence, ou une valeur par défaut si la séquence est vide ; cette méthode lève une exception s’il existe plusieurs éléments dans la séquence.

SumAsync<TSource>(IQueryable<TSource>, Expression<Func<TSource,Decimal>>, CancellationToken)

Calcule de manière asynchrone la somme de la séquence de valeurs obtenue en appelant une fonction de projection sur chaque élément de la séquence d’entrée.

SumAsync<TSource>(IQueryable<TSource>, Expression<Func<TSource,Double>>, CancellationToken)

Calcule de manière asynchrone la somme de la séquence de valeurs obtenue en appelant une fonction de projection sur chaque élément de la séquence d’entrée.

SumAsync<TSource>(IQueryable<TSource>, Expression<Func<TSource,Int32>>, CancellationToken)

Calcule de manière asynchrone la somme de la séquence de valeurs obtenue en appelant une fonction de projection sur chaque élément de la séquence d’entrée.

SumAsync<TSource>(IQueryable<TSource>, Expression<Func<TSource,Int64>>, CancellationToken)

Calcule de manière asynchrone la somme de la séquence de valeurs obtenue en appelant une fonction de projection sur chaque élément de la séquence d’entrée.

SumAsync<TSource>(IQueryable<TSource>, Expression<Func<TSource,Nullable<Decimal>>>, CancellationToken)

Calcule de manière asynchrone la somme de la séquence de valeurs obtenue en appelant une fonction de projection sur chaque élément de la séquence d’entrée.

SumAsync<TSource>(IQueryable<TSource>, Expression<Func<TSource,Nullable<Double>>>, CancellationToken)

Calcule de manière asynchrone la somme de la séquence de valeurs obtenue en appelant une fonction de projection sur chaque élément de la séquence d’entrée.

SumAsync<TSource>(IQueryable<TSource>, Expression<Func<TSource,Nullable<Int32>>>, CancellationToken)

Calcule de manière asynchrone la somme de la séquence de valeurs obtenue en appelant une fonction de projection sur chaque élément de la séquence d’entrée.

SumAsync<TSource>(IQueryable<TSource>, Expression<Func<TSource,Nullable<Int64>>>, CancellationToken)

Calcule de manière asynchrone la somme de la séquence de valeurs obtenue en appelant une fonction de projection sur chaque élément de la séquence d’entrée.

SumAsync<TSource>(IQueryable<TSource>, Expression<Func<TSource,Nullable<Single>>>, CancellationToken)

Calcule de manière asynchrone la somme de la séquence de valeurs obtenue en appelant une fonction de projection sur chaque élément de la séquence d’entrée.

SumAsync<TSource>(IQueryable<TSource>, Expression<Func<TSource,Single>>, CancellationToken)

Calcule de manière asynchrone la somme de la séquence de valeurs obtenue en appelant une fonction de projection sur chaque élément de la séquence d’entrée.

TagWith<T>(IQueryable<T>, String)

Ajoute une balise à la collection de balises associées à une requête EF LINQ. Les balises sont des annotations de requête qui peuvent fournir des informations de suivi contextuelles à différents points du pipeline de requête.

TagWithCallSite<T>(IQueryable<T>, String, Int32)

Ajoute une balise à la collection de balises associées à une requête EF LINQ avec le nom de fichier source et la ligne où la méthode a été appelée, ce qui peut fournir des informations de suivi contextuel à différents points du pipeline de requête.

ThenInclude<TEntity,TPreviousProperty,TProperty>(IIncludableQueryable<TEntity,TPreviousProperty>, Expression<Func<TPreviousProperty,TProperty>>)

Spécifie des données connexes supplémentaires à inclure davantage en fonction d’un type associé qui vient d’être inclus.

ToArrayAsync<TSource>(IQueryable<TSource>, CancellationToken)

Crée de manière asynchrone un tableau à partir d’un IQueryable<T> en l’énumérant de manière asynchrone.

ToDictionaryAsync<TSource,TKey>(IQueryable<TSource>, Func<TSource,TKey>, IEqualityComparer<TKey>, CancellationToken)

Crée un Dictionary<TKey,TValue> à partir d’un IQueryable<T> en l’énumérant de manière asynchrone en fonction d’une fonction de sélecteur de clé spécifiée et d’un comparateur.

ToDictionaryAsync<TSource,TKey>(IQueryable<TSource>, Func<TSource,TKey>, CancellationToken)

Crée un Dictionary<TKey,TValue> à partir d’un IQueryable<T> en l’énumérant de manière asynchrone en fonction d’une fonction de sélecteur de clé spécifiée.

ToDictionaryAsync<TSource,TKey,TElement>(IQueryable<TSource>, Func<TSource,TKey>, Func<TSource,TElement>, IEqualityComparer<TKey>, CancellationToken)

Crée un Dictionary<TKey,TValue> à partir d’un IQueryable<T> en l’énumérant de manière asynchrone en fonction d’une fonction de sélecteur de clé spécifiée, d’un comparateur et d’une fonction de sélecteur d’élément spécifiée.

ToDictionaryAsync<TSource,TKey,TElement>(IQueryable<TSource>, Func<TSource,TKey>, Func<TSource,TElement>, CancellationToken)

Crée un Dictionary<TKey,TValue> à partir d’un IQueryable<T> en l’énumérant de manière asynchrone en fonction d’un sélecteur de clé spécifié et d’une fonction de sélecteur d’élément.

ToListAsync<TSource>(IQueryable<TSource>, CancellationToken)

Crée de manière asynchrone un à partir d’un List<T>IQueryable<T> en l’énumérant de manière asynchrone.

AsSingleQuery<TEntity>(IQueryable<TEntity>)

Retourne une nouvelle requête qui est configurée pour charger les collections dans la requête aboutit à une requête de base de données unique.

AsSplitQuery<TEntity>(IQueryable<TEntity>)

Retourne une nouvelle requête qui est configurée pour charger les collections dans les résultats de la requête via des requêtes de base de données distinctes.

ExecuteDelete<TSource>(IQueryable<TSource>)

Supprime toutes les lignes de base de données pour les instances d’entité qui correspondent à la requête LINQ de la base de données.

ExecuteDeleteAsync<TSource>(IQueryable<TSource>, CancellationToken)

Supprime de manière asynchrone les lignes de base de données pour les instances d’entité qui correspondent à la requête LINQ de la base de données.

ExecuteUpdate<TSource>(IQueryable<TSource>, Expression<Func<SetPropertyCalls<TSource>,SetPropertyCalls<TSource>>>)

Mises à jour toutes les lignes de base de données pour les instances d’entité qui correspondent à la requête LINQ de la base de données.

ExecuteUpdateAsync<TSource>(IQueryable<TSource>, Expression<Func<SetPropertyCalls<TSource>,SetPropertyCalls<TSource>>>, CancellationToken)

Met à jour de manière asynchrone les lignes de base de données pour les instances d’entité qui correspondent à la requête LINQ de la base de données.

FromSql<TEntity>(IQueryable<TEntity>, RawSqlString, Object[])
Obsolète..

Crée une requête LINQ basée sur une requête SQL brute.

Si le fournisseur de base de données prend en charge la composition sur le SQL fourni, vous pouvez composer par-dessus la requête SQL brute à l’aide d’opérateurs LINQ - context.Blogs.FromSql("SELECT * FROM dbo.Blogs").OrderBy(b => b.Name).

Comme pour toute API qui accepte SQL, il est important de paramétrer toute entrée utilisateur pour vous protéger contre une attaque par injection SQL. Vous pouvez inclure des espaces réservés de paramètres dans la chaîne de requête SQL, puis fournir des valeurs de paramètre en tant qu’arguments supplémentaires. Toutes les valeurs de paramètre que vous fournissez sont automatiquement converties en DbParameter - context.Blogs.FromSql("SELECT * FROM [dbo].[SearchBlogs]({0})", userSuppliedSearchTerm).

Cette surcharge accepte également les instances DbParameter comme valeurs de paramètre. Cela vous permet d’utiliser des paramètres nommés dans la chaîne de requête SQL : context.Blogs.FromSql("SELECT * FROM [dbo].[SearchBlogs]({@searchTerm})", new SqlParameter("@searchTerm", userSuppliedSearchTerm))

FromSql<TEntity>(IQueryable<TEntity>, FormattableString)
Obsolète..

Crée une requête LINQ basée sur une chaîne interpolée représentant une requête SQL.

Si le fournisseur de base de données prend en charge la composition sur le SQL fourni, vous pouvez composer par-dessus la requête SQL brute à l’aide d’opérateurs LINQ - context.Blogs.FromSql("SELECT * FROM dbo.Blogs").OrderBy(b => b.Name).

Comme pour toute API qui accepte SQL, il est important de paramétrer toute entrée utilisateur pour vous protéger contre une attaque par injection de code SQL. Vous pouvez inclure des espaces réservés de paramètres interpolés dans la chaîne de requête SQL. Toutes les valeurs de paramètre interpolées que vous fournissez sont automatiquement converties en DbParameter - context.Blogs.FromSql($"SELECT * FROM [dbo].[SearchBlogs]({userSuppliedSearchTerm})").

FromSql<TEntity>(IQueryable<TEntity>, String, Object[])

Crée une requête LINQ basée sur une requête SQL brute.

Si le fournisseur de base de données prend en charge la composition sur le SQL fourni, vous pouvez composer par-dessus la requête SQL brute à l’aide d’opérateurs LINQ - context.Blogs.FromSql("SELECT * FROM dbo.Blogs").OrderBy(b => b.Name).

Comme pour toute API qui accepte SQL, il est important de paramétrer toute entrée utilisateur pour vous protéger contre une attaque par injection de code SQL. Vous pouvez inclure des espaces réservés de paramètres dans la chaîne de requête SQL, puis fournir des valeurs de paramètre en tant qu’arguments supplémentaires. Toutes les valeurs de paramètre que vous fournissez sont automatiquement converties en DbParameter - context.Blogs.FromSql("SELECT * FROM [dbo].[SearchBlogs]({0})", userSuppliedSearchTerm).

Vous pouvez également construire un DbParameter et le fournir en tant que valeur de paramètre. Cela vous permet d’utiliser des paramètres nommés dans la chaîne de requête SQL : context.Blogs.FromSql("SELECT * FROM [dbo].[SearchBlogs]({@searchTerm})", new SqlParameter("@searchTerm", userSuppliedSearchTerm))

S’applique à