DbQuery<TQuery> Classe

Définition

Attention

Use DbSet instead

Un DbQuery<TQuery> peut être utilisé pour interroger des instances de TQuery . Les requêtes LINQ sur un DbQuery<TQuery> seront traduites en requêtes sur la base de données.

Les résultats d’une requête LINQ sur un DbQuery<TQuery> contiennent les résultats retournés par la base de données et peuvent ne pas refléter les modifications apportées dans le contexte qui n’ont pas été rendues persistantes dans la base de données. Par exemple, les résultats ne contiennent pas de vues nouvellement ajoutées et peuvent toujours contenir des vues marquées pour suppression.

Selon la base de données utilisée, certaines parties d’une requête LINQ sur une DbQuery<TQuery> peuvent être évaluées en mémoire au lieu d’être traduites en une requête de base de données.

DbQuery<TQuery> les objets sont généralement obtenus à partir d’une DbQuery<TQuery> propriété sur un dérivé DbContext ou à partir de la Query<TQuery>() méthode.

public abstract class DbQuery<TQuery> : Microsoft.EntityFrameworkCore.Infrastructure.IInfrastructure<IServiceProvider>, Microsoft.EntityFrameworkCore.Query.Internal.IAsyncEnumerableAccessor<TQuery>, System.Collections.Generic.IEnumerable<TQuery>, System.Linq.IQueryable<TQuery> where TQuery : class
[System.Obsolete("Use DbSet<T> instead")]
public abstract class DbQuery<TQuery> : Microsoft.EntityFrameworkCore.DbSet<TQuery> where TQuery : class
type DbQuery<'Query (requires 'Query : null)> = class
    interface IQueryable<'Query (requires 'Query : null)>
    interface seq<'Query (requires 'Query : null)>
    interface IEnumerable
    interface IQueryable
    interface IAsyncEnumerableAccessor<'Query (requires 'Query : null)>
    interface IInfrastructure<IServiceProvider>
[<System.Obsolete("Use DbSet<T> instead")>]
type DbQuery<'Query (requires 'Query : null)> = class
    inherit DbSet<'Query (requires 'Query : null)>
Public MustInherit Class DbQuery(Of TQuery)
Implements IAsyncEnumerableAccessor(Of TQuery), IEnumerable(Of TQuery), IInfrastructure(Of IServiceProvider), IQueryable(Of TQuery)
Public MustInherit Class DbQuery(Of TQuery)
Inherits DbSet(Of TQuery)

Paramètres de type

TQuery

Type de vue en cours d’exploitation par cette vue.

Héritage
DbQuery<TQuery>
Héritage
DbSet<TQuery>
DbQuery<TQuery>
Attributs
Implémente
IInfrastructure<IServiceProvider> Microsoft.EntityFrameworkCore.Query.Internal.IAsyncEnumerableAccessor<TQuery> IEnumerable<T> IEnumerable<TQuery> IEnumerable IQueryable IQueryable<TQuery>

Constructeurs

DbQuery<TQuery>()

Propriétés

EntityType

IEntityTypeMétadonnées associées à cet ensemble.

(Hérité de DbSet<TEntity>)
Local

Obtient un LocalView<TEntity> qui représente une vue locale de toutes les entités ajoutées, inchangées et modifiées dans cet ensemble.

Cette vue locale reste synchronisée lorsque les entités sont ajoutées ou supprimées du contexte. De même, les entités ajoutées à ou supprimées de la vue locale seront ajoutées ou supprimées automatiquement du contexte.

Cette propriété peut être utilisée pour la liaison de données en remplissant le jeu avec des données, par exemple à l’aide de la Load<TSource>(IQueryable<TSource>) méthode d’extension, puis en liant les données locales via cette propriété en appelant ToObservableCollection() pour la liaison WPF, ou ToBindingList() pour WinForms.

(Hérité de DbSet<TEntity>)

Méthodes

Add(TEntity)

Commence le suivi de l’entité donnée et de toutes les autres entités accessibles qui ne sont pas déjà suivies, dans l’État, de Added telle sorte qu’elles sont insérées dans la base de données lorsque SaveChanges() est appelé.

Utilisez State pour définir l’état d’une seule entité.

(Hérité de DbSet<TEntity>)
AddAsync(TEntity, CancellationToken)

Commence le suivi de l’entité donnée et de toutes les autres entités accessibles qui ne sont pas déjà suivies, dans l’État, de Added telle sorte qu’elles sont insérées dans la base de données lorsque SaveChanges() est appelé.

Cette méthode est Async uniquement pour autoriser les générateurs de valeurs spéciaux, tels que celui utilisé par « Microsoft. EntityFrameworkCore. Metadata. SqlServerValueGenerationStrategy. SequenceHiLo », pour accéder à la base de données de façon asynchrone. Pour tous les autres cas, la méthode non Async doit être utilisée.

Utilisez State pour définir l’état d’une seule entité.

(Hérité de DbSet<TEntity>)
AddRange(IEnumerable<TEntity>)

Commence à suivre les entités données et toutes les autres entités accessibles qui ne sont pas déjà suivies, dans l' Added État, de telle sorte qu’elles sont insérées dans la base de données lorsque SaveChanges() est appelé.

(Hérité de DbSet<TEntity>)
AddRange(TEntity[])

Commence à suivre les entités données et toutes les autres entités accessibles qui ne sont pas déjà suivies, dans l' Added État, de telle sorte qu’elles sont insérées dans la base de données lorsque SaveChanges() est appelé.

(Hérité de DbSet<TEntity>)
AddRangeAsync(IEnumerable<TEntity>, CancellationToken)

Commence à suivre les entités données et toutes les autres entités accessibles qui ne sont pas déjà suivies, dans l' Added État, de telle sorte qu’elles sont insérées dans la base de données lorsque SaveChanges() est appelé.

Cette méthode est Async uniquement pour autoriser les générateurs de valeurs spéciaux, tels que celui utilisé par « Microsoft. EntityFrameworkCore. Metadata. SqlServerValueGenerationStrategy. SequenceHiLo », pour accéder à la base de données de façon asynchrone. Pour tous les autres cas, la méthode non Async doit être utilisée.

(Hérité de DbSet<TEntity>)
AddRangeAsync(TEntity[])

Commence à suivre les entités données et toutes les autres entités accessibles qui ne sont pas déjà suivies, dans l' Added État, de telle sorte qu’elles sont insérées dans la base de données lorsque SaveChanges() est appelé.

Cette méthode est Async uniquement pour autoriser les générateurs de valeurs spéciaux, tels que celui utilisé par « Microsoft. EntityFrameworkCore. Metadata. SqlServerValueGenerationStrategy. SequenceHiLo », pour accéder à la base de données de façon asynchrone. Pour tous les autres cas, la méthode non Async doit être utilisée.

(Hérité de DbSet<TEntity>)
AsAsyncEnumerable()

Retourne cet objet de type IAsyncEnumerable<T> .

Il s’agit d’une méthode pratique pour vous aider à lever l’ambiguïté des méthodes d’extension dans le même espace de noms qui étendent les deux interfaces.

(Hérité de DbSet<TEntity>)
AsQueryable()

Retourne cet objet de type IQueryable<T> .

Il s’agit d’une méthode pratique pour vous aider à lever l’ambiguïté des méthodes d’extension dans le même espace de noms qui étendent les deux interfaces.

(Hérité de DbSet<TEntity>)
Attach(TEntity)

Commence le suivi de l’entité donnée et des entrées accessibles à partir de l’entité donnée à l’aide de l' Unchanged État par défaut, mais voir ci-dessous pour les cas où un autre État sera utilisé.

En règle générale, aucune interaction de base de données n’est effectuée tant que SaveChanges() n’est pas appelé.

Une recherche récursive des propriétés de navigation sera effectuée pour rechercher les entités accessibles qui ne font pas déjà l’objet d’un suivi par le contexte. Toutes les entités trouvées feront l’élément d’un suivi par le contexte.

Pour les types d’entité avec des clés générées, si une entité a sa valeur de clé primaire définie, elle est suivie dans l' Unchanged État. Si la valeur de clé primaire n’est pas définie, elle est suivie dans l' Added État. Cela permet de s’assurer que seules les nouvelles entités seront insérées. La valeur de la clé primaire d’une entité est définie si la propriété de clé primaire est définie sur autre chose que la valeur CLR par défaut pour le type de propriété.

Pour les types d’entité sans clés générées, l’ensemble d’États est toujours Unchanged .

Utilisez State pour définir l’état d’une seule entité.

(Hérité de DbSet<TEntity>)
AttachRange(IEnumerable<TEntity>)

Commence à suivre les entités et les entrées données accessibles à partir des entités données à l’aide de l' Unchanged État par défaut, mais voir ci-dessous pour les cas où un autre État sera utilisé.

En règle générale, aucune interaction de base de données n’est effectuée tant que SaveChanges() n’est pas appelé.

Une recherche récursive des propriétés de navigation sera effectuée pour rechercher les entités accessibles qui ne font pas déjà l’objet d’un suivi par le contexte. Toutes les entités trouvées feront l’élément d’un suivi par le contexte.

Pour les types d’entité avec des clés générées, si une entité a sa valeur de clé primaire définie, elle est suivie dans l' Unchanged État. Si la valeur de clé primaire n’est pas définie, elle est suivie dans l' Added État. Cela permet de s’assurer que seules les nouvelles entités seront insérées. La valeur de la clé primaire d’une entité est définie si la propriété de clé primaire est définie sur autre chose que la valeur CLR par défaut pour le type de propriété.

Pour les types d’entité sans clés générées, l’ensemble d’États est toujours Unchanged .

Utilisez State pour définir l’état d’une seule entité.

(Hérité de DbSet<TEntity>)
AttachRange(TEntity[])

Commence à suivre les entités et les entrées données accessibles à partir des entités données à l’aide de l' Unchanged État par défaut, mais voir ci-dessous pour les cas où un autre État sera utilisé.

En règle générale, aucune interaction de base de données n’est effectuée tant que SaveChanges() n’est pas appelé.

Une recherche récursive des propriétés de navigation sera effectuée pour rechercher les entités accessibles qui ne font pas déjà l’objet d’un suivi par le contexte. Toutes les entités trouvées feront l’élément d’un suivi par le contexte.

Pour les types d’entité avec des clés générées, si une entité a sa valeur de clé primaire définie, elle est suivie dans l' Unchanged État. Si la valeur de clé primaire n’est pas définie, elle est suivie dans l' Added État. Cela permet de s’assurer que seules les nouvelles entités seront insérées. La valeur de la clé primaire d’une entité est définie si la propriété de clé primaire est définie sur autre chose que la valeur CLR par défaut pour le type de propriété.

Pour les types d’entité sans clés générées, l’ensemble d’États est toujours Unchanged .

Utilisez State pour définir l’état d’une seule entité.

(Hérité de DbSet<TEntity>)
Find(Object[])

Recherche une entité avec les valeurs de clé primaire données. Si une entité avec les valeurs de clé primaire données est suivie par le contexte, elle est immédiatement retournée sans faire de requête à la base de données. Dans le cas contraire, une requête est effectuée sur la base de données pour une entité avec les valeurs de clé primaire données et cette entité, si elle est trouvée, est attachée au contexte et retournée. Si aucune entité n’est trouvée, la valeur null est retournée.

(Hérité de DbSet<TEntity>)
FindAsync(Object[])

Recherche une entité avec les valeurs de clé primaire données. Si une entité avec les valeurs de clé primaire données est suivie par le contexte, elle est immédiatement retournée sans faire de requête à la base de données. Dans le cas contraire, une requête est effectuée sur la base de données pour une entité avec les valeurs de clé primaire données et cette entité, si elle est trouvée, est attachée au contexte et retournée. Si aucune entité n’est trouvée, la valeur null est retournée.

(Hérité de DbSet<TEntity>)
FindAsync(Object[], CancellationToken)

Recherche une entité avec les valeurs de clé primaire données. Si une entité avec les valeurs de clé primaire données est suivie par le contexte, elle est immédiatement retournée sans faire de requête à la base de données. Dans le cas contraire, une requête est effectuée sur la base de données pour une entité avec les valeurs de clé primaire données et cette entité, si elle est trouvée, est attachée au contexte et retournée. Si aucune entité n’est trouvée, la valeur null est retournée.

(Hérité de DbSet<TEntity>)
Remove(TEntity)

Commence le suivi de l’entité donnée dans l' Deleted État, de telle sorte qu’elle sera supprimée de la base de données lorsque SaveChanges() est appelé.

(Hérité de DbSet<TEntity>)
RemoveRange(IEnumerable<TEntity>)

Commence le suivi des entités données dans l' Deleted État, de telle sorte qu’elles seront supprimées de la base de données lorsque SaveChanges() est appelé.

(Hérité de DbSet<TEntity>)
RemoveRange(TEntity[])

Commence le suivi des entités données dans l' Deleted État, de telle sorte qu’elles seront supprimées de la base de données lorsque SaveChanges() est appelé.

(Hérité de DbSet<TEntity>)
Update(TEntity)

Commence le suivi de l’entité donnée et des entrées accessibles à partir de l’entité donnée à l’aide de l' Modified État par défaut, mais voir ci-dessous pour les cas où un autre État sera utilisé.

En règle générale, aucune interaction de base de données n’est effectuée tant que SaveChanges() n’est pas appelé.

Une recherche récursive des propriétés de navigation sera effectuée pour rechercher les entités accessibles qui ne font pas déjà l’objet d’un suivi par le contexte. Toutes les entités trouvées feront l’élément d’un suivi par le contexte.

Pour les types d’entité avec des clés générées, si une entité a sa valeur de clé primaire définie, elle est suivie dans l' Modified État. Si la valeur de clé primaire n’est pas définie, elle est suivie dans l' Added État. Cela permet de s’assurer que les nouvelles entités seront insérées, tandis que les entités existantes seront mises à jour. La valeur de la clé primaire d’une entité est définie si la propriété de clé primaire est définie sur autre chose que la valeur CLR par défaut pour le type de propriété.

Pour les types d’entité sans clés générées, l’ensemble d’États est toujours Modified .

Utilisez State pour définir l’état d’une seule entité.

(Hérité de DbSet<TEntity>)
UpdateRange(IEnumerable<TEntity>)

Commence à suivre les entités et les entrées données accessibles à partir des entités données à l’aide de l' Modified État par défaut, mais voir ci-dessous pour les cas où un autre État sera utilisé.

En règle générale, aucune interaction de base de données n’est effectuée tant que SaveChanges() n’est pas appelé.

Une recherche récursive des propriétés de navigation sera effectuée pour rechercher les entités accessibles qui ne font pas déjà l’objet d’un suivi par le contexte. Toutes les entités trouvées feront l’élément d’un suivi par le contexte.

Pour les types d’entité avec des clés générées, si une entité a sa valeur de clé primaire définie, elle est suivie dans l' Modified État. Si la valeur de clé primaire n’est pas définie, elle est suivie dans l' Added État. Cela permet de s’assurer que les nouvelles entités seront insérées, tandis que les entités existantes seront mises à jour. La valeur de la clé primaire d’une entité est définie si la propriété de clé primaire est définie sur autre chose que la valeur CLR par défaut pour le type de propriété.

Pour les types d’entité sans clés générées, l’ensemble d’États est toujours Modified .

Utilisez State pour définir l’état d’une seule entité.

(Hérité de DbSet<TEntity>)
UpdateRange(TEntity[])

Commence à suivre les entités et les entrées données accessibles à partir des entités données à l’aide de l' Modified État par défaut, mais voir ci-dessous pour les cas où un autre État sera utilisé.

En règle générale, aucune interaction de base de données n’est effectuée tant que SaveChanges() n’est pas appelé.

Une recherche récursive des propriétés de navigation sera effectuée pour rechercher les entités accessibles qui ne font pas déjà l’objet d’un suivi par le contexte. Toutes les entités trouvées feront l’élément d’un suivi par le contexte.

Pour les types d’entité avec des clés générées, si une entité a sa valeur de clé primaire définie, elle est suivie dans l' Modified État. Si la valeur de clé primaire n’est pas définie, elle est suivie dans l' Added État. Cela permet de s’assurer que les nouvelles entités seront insérées, tandis que les entités existantes seront mises à jour. La valeur de la clé primaire d’une entité est définie si la propriété de clé primaire est définie sur autre chose que la valeur CLR par défaut pour le type de propriété.

Pour les types d’entité sans clés générées, l’ensemble d’États est toujours Modified .

Utilisez State pour définir l’état d’une seule entité.

(Hérité de DbSet<TEntity>)

Implémentations d’interfaces explicites

IAsyncEnumerable<TEntity>.GetAsyncEnumerator(CancellationToken)

Retourne un IAsyncEnumerator<T> qui, lorsqu’il est énuméré, exécute de manière asynchrone une requête sur la base de données.

(Hérité de DbSet<TEntity>)
IAsyncEnumerableAccessor<TEntity>.AsyncEnumerable

Retourne un IAsyncEnumerable<T> qui, lorsqu’il est énuméré, exécute de manière asynchrone la requête sur la base de données.

(Hérité de DbSet<TEntity>)
IAsyncEnumerableAccessor<TQuery>.AsyncEnumerable

Retourne un IAsyncEnumerable<T> qui, lorsqu’il est énuméré, exécute de manière asynchrone la requête sur la base de données.

IEnumerable.GetEnumerator()

Retourne un IEnumerator qui, lorsqu’il est énuméré, exécute une requête sur la base de données pour charger toutes les vues de la base de données.

IEnumerable.GetEnumerator()

Retourne un IEnumerator qui, lorsqu’il est énuméré, exécute une requête sur la base de données pour charger toutes les entités de la base de données.

(Hérité de DbSet<TEntity>)
IEnumerable<TEntity>.GetEnumerator()

Retourne un IEnumerator<T> qui, lorsqu’il est énuméré, exécute une requête sur la base de données pour charger toutes les entités de la base de données.

(Hérité de DbSet<TEntity>)
IEnumerable<TQuery>.GetEnumerator()

Retourne un IEnumerator<T> qui, lorsqu’il est énuméré, exécute une requête sur la base de données pour charger toutes les vues de la base de données.

IInfrastructure<IServiceProvider>.Instance

Obtient le étendu IServiceProvider utilisé pour résoudre les services.

Cette propriété est destinée à être utilisée par les méthodes d’extension qui doivent utiliser des services qui ne sont pas directement exposés dans la surface de l’API publique.

IInfrastructure<IServiceProvider>.Instance

Obtient le étendu IServiceProvider utilisé pour résoudre les services.

Cette propriété est destinée à être utilisée par les méthodes d’extension qui doivent utiliser des services qui ne sont pas directement exposés dans la surface de l’API publique.

(Hérité de DbSet<TEntity>)
IListSource.ContainsListCollection

Obtient une valeur indiquant si la collection est une collection d’objets System. Collections. IList. Retourne toujours false.

(Hérité de DbSet<TEntity>)
IListSource.GetList()

Cette méthode est appelée par les infrastructures de liaison de données lors d’une tentative de liaison directe de données à un DbSet<TEntity> .

Cette implémentation lève toujours une exception, car la liaison directe à un DbSet<TEntity> entraîne l’envoi d’une requête à la base de données chaque fois que l’infrastructure de liaison de données demande le contenu de la collection. Au lieu de cela, chargez les résultats dans le contexte, par exemple à l’aide de la méthode d’extension, puis créez une Load<TSource>(IQueryable<TSource>) liaison avec les données locales via le Local en appelant ToObservableCollection() pour la liaison WPF ou ToBindingList() pour WinForms.

(Hérité de DbSet<TEntity>)
IQueryable.ElementType

Obtient le type d’élément IQueryable.

IQueryable.ElementType

Obtient le type d’élément IQueryable.

(Hérité de DbSet<TEntity>)
IQueryable.Expression

Obtient l’expression LINQ IQueryable.

IQueryable.Expression

Obtient l’expression LINQ IQueryable.

(Hérité de DbSet<TEntity>)
IQueryable.Provider

Obtient le fournisseur IQueryable.

IQueryable.Provider

Obtient le fournisseur IQueryable.

(Hérité de DbSet<TEntity>)

Méthodes d’extension

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 remplit 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 dispositif de 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, elles ne sont pas détectées par le dispositif de suivi des modifications et ne SaveChanges() conservent pas les modifications apportées à la base de données.

La désactivation du suivi des modifications est utile pour les scénarios en lecture seule, car elle évite la surcharge liée à la configuration du suivi des modifications pour chaque instance d’entité. Vous ne devez pas désactiver le suivi des modifications si vous souhaitez manipuler des instances d’entité et conserver ces modifications dans la base de données à l’aide de SaveChanges() .

La résolution de l’identité ne sera pas effectuée. Si une entité avec une clé donnée est dans un résultat différent dans le jeu de résultats, il s’agit d’instances différentes.

Le comportement de suivi par défaut pour les requêtes peut être contrôlé par QueryTrackingBehavior .

AsTracking<TEntity>(IQueryable<TEntity>)

Retourne une nouvelle requête où le dispositif de 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 la SaveChanges() .

Le comportement de suivi par défaut pour les requêtes peut être contrôlé par QueryTrackingBehavior .

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

Retourne une nouvelle requête où le dispositif de 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é sera détectée et conservée dans la base de données pendant la SaveChanges() . En l’absence de suivi, si les instances d’entité sont modifiées, ce n’est pas détecté par le dispositif de suivi des modifications et les SaveChanges() modifications apportées à la base de données ne sont pas conservées.

La désactivation du suivi des modifications est utile pour les scénarios en lecture seule, car elle évite la surcharge liée à la configuration du suivi des modifications pour chaque instance d’entité. Vous ne devez pas désactiver le suivi des modifications si vous souhaitez manipuler des instances d’entité et conserver ces modifications dans la base de données à l’aide de SaveChanges() .

Le comportement de suivi par défaut pour les requêtes peut être contrôlé par QueryTrackingBehavior .

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 satisfont à une condition.

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

Retourne de façon asynchrone le nombre d’éléments d’une séquence.

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

Retourne de façon asynchrone le premier élément d’une séquence qui satisfait à une condition spécifiée.

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

Retourne de façon asynchrone le premier élément d’une séquence.

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

Retourne de façon 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 façon 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 exécute l’action spécifiée sur chaque élément.

IgnoreQueryFilters<TEntity>(IQueryable<TEntity>)

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

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é ( 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é ( TEntity ). Si vous souhaitez inclure d’autres types basés sur les propriétés de navigation du type inclus, puis 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 façon asynchrone le dernier élément d’une séquence qui satisfait à une condition spécifiée.

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

Retourne de façon asynchrone le dernier élément d’une séquence.

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

Retourne de façon 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. Lorsque vous utilisez Entity Framework, cela entraîne le chargement des résultats de la requête dans le contexte associé. Cela équivaut à appeler ToList, puis à lever la liste (sans la surcharge liée à la création réelle de la liste).

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

Énumère de manière asynchrone la requête. Lorsque vous utilisez Entity Framework, cela entraîne le chargement des résultats de la requête dans le contexte associé. Cela équivaut à appeler ToList, puis à lever la liste (sans la surcharge liée à la création réelle de la liste).

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

Retourne de façon asynchrone un Int64 qui représente le nombre d’éléments d’une séquence qui satisfont à une condition.

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

Retourne de façon asynchrone un Int64 qui représente le nombre total d’éléments dans une séquence.

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

Retourne de façon 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 résultante maximale.

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

Retourne de façon 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 résultante minimale.

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

Retourne de façon 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 façon 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 remplissent la condition.

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

Retourne de façon 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 y a plus d’un élément 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 traçage contextuelles à différents points dans le pipeline de requête.

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

Crée de façon 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 d’après une fonction de sélection de clé spécifiée et 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 d’après une fonction de sélection 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 selon une fonction de sélection de clé spécifiée, un comparateur et une fonction de sélection d’élément.

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élection d’élément.

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

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

GetInfrastructure<T>(IInfrastructure<T>)

Obtient la valeur d’une propriété qui est masquée à l’aide de IInfrastructure<T> .

Cette méthode est généralement utilisée par les fournisseurs de base de données (et d’autres extensions). Il n’est généralement pas utilisé dans le code de l’application.

IInfrastructure<T> est utilisé pour masquer les propriétés qui ne sont pas destinées à être utilisées dans le code de l’application, mais qui peuvent être utilisées dans les méthodes d’extension écrites par les fournisseurs de base de données, etc.

CreateProxy<TEntity>(DbSet<TEntity>, Object[])

Crée une instance de proxy pour un type d’entité si la création du proxy a été activée.

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 en haut de la requête SQL brute à l’aide des opérateurs LINQ- context.Blogs.FromSql("SELECT * FROM dbo.Blogs").OrderBy(b => b.Name).

Comme pour toute API acceptant 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ètre 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 seront automatiquement converties en une valeur 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 en haut de la requête SQL brute à l’aide des opérateurs LINQ- context.Blogs.FromSql("SELECT * FROM dbo.Blogs").OrderBy(b => b.Name).

Comme pour toute API acceptant 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ètre 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 une valeur DbParameter- context.Blogs.FromSql($"SELECT * FROM [dbo].[SearchBlogs]({userSuppliedSearchTerm})").

FromSqlInterpolated<TEntity>(DbSet<TEntity>, FormattableString)

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 en haut de la requête SQL brute à l’aide des opérateurs LINQ :

context.Blogs.FromSqlInterpolated($"SELECT * FROM dbo.Blogs").OrderBy(b => b.Name)

Comme pour toute API acceptant 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ètre 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.FromSqlInterpolated($"SELECT * FROM [dbo].[SearchBlogs]({userSuppliedSearchTerm})")
FromSqlRaw<TEntity>(DbSet<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 en haut de la requête SQL brute à l’aide des opérateurs LINQ : Context. Blogs. FromSqlRaw ("SELECT * FROM dbo. Blogs»). OrderBy (b = > b.Name).

Comme pour toute API acceptant 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ètre 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 seront automatiquement converties en DbParameter :

context.Blogs.FromSqlRaw("SELECT * FROM [dbo].[SearchBlogs]({0})", userSuppliedSearchTerm)

Toutefois, ne transmettez jamais une chaîne concaténée ou interpolée ($ "") avec des valeurs non validées fournies par l’utilisateur dans cette méthode. Cela peut exposer votre application à des attaques par injection SQL. Pour utiliser la syntaxe de chaîne interpolée, envisagez FromSqlInterpolated<TEntity>(DbSet<TEntity>, FormattableString) d’utiliser pour créer des paramètres.

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.FromSqlRaw("SELECT * FROM [dbo].[SearchBlogs]({@searchTerm})", new SqlParameter("@searchTerm", userSuppliedSearchTerm))

S’applique à