DbSqlQuery<TEntity>, classe
[Cette page concerne Entity Framework version 6. La dernière version est disponible sous le nom de package 'Entity Framework' NuGet. Pour plus d'informations sur Entity Framework, consultez msdn.com/data/ef.]
Représente une requête SQL pour les entités créées à partir d'un DbContext qui est exécutée à l'aide de la connexion à partir ce contexte. Les instances de cette classe sont obtenues de l'instance DbSet<TEntity> pour le type d'entité. La requête n'est pas exécutée lorsque cet objet est créé ; elle est exécutée chaque fois qu'elle est énumérée, par exemple en utilisant l'instruction « foreach ». Les requêtes SQL pour les non-entités sont créées à l'aide de SqlQuery<TElement>(String, Object[]). Consultez DbSqlQuery pour une version non générique de cette classe.
Hiérarchie d'héritage
System.Object
System.Data.Entity.Infrastructure.DbRawSqlQuery<TEntity>
System.Data.Entity.Infrastructure.DbSqlQuery<TEntity>
Espace de noms : System.Data.Entity.Infrastructure
Assembly : EntityFramework (dans EntityFramework.dll)
Syntaxe
'Déclaration
<SuppressMessageAttribute("Microsoft.Naming", "CA1710:IdentifiersShouldHaveCorrectSuffix")> _
Public Class DbSqlQuery(Of TEntity As Class) _
Inherits DbRawSqlQuery(Of TEntity)
'Utilisation
Dim instance As DbSqlQuery(Of TEntity)
[SuppressMessageAttribute("Microsoft.Naming", "CA1710:IdentifiersShouldHaveCorrectSuffix")]
public class DbSqlQuery<TEntity> : DbRawSqlQuery<TEntity>
where TEntity : class
[SuppressMessageAttribute(L"Microsoft.Naming", L"CA1710:IdentifiersShouldHaveCorrectSuffix")]
generic<typename TEntity>
where TEntity : ref class
public ref class DbSqlQuery : public DbRawSqlQuery<TEntity>
[<SuppressMessageAttribute("Microsoft.Naming", "CA1710:IdentifiersShouldHaveCorrectSuffix")>]
type DbSqlQuery<'TEntity when 'TEntity : not struct> =
class
inherit DbRawSqlQuery<'TEntity>
end
JScript does not support generic types and methods.
Paramètres de type
- TEntity
Type des entités retournées par la requête.
Le type DbSqlQuery<TEntity> expose les membres suivants.
Constructeurs
| Nom | Description | |
|---|---|---|
.gif "Méthode protégée") |
DbSqlQuery<TEntity> | Crée une instance d'un DbSqlQuery<TEntity> lors d'un appel depuis le constructeur d'un type dérivé qui servira à vérifier une deuxième fois SqlQuery(String, array<Object[]).Les méthodes et les propriétés qui serviront au double test doivent être implémentées par le double test, à l'exception d'AsNoTracking et d'AsStreaming pour lesquels l'implémentation par défaut correspond à une absence d'opération. |
Top
Méthodes
| Nom | Description | |
|---|---|---|
.gif "Méthode publique") |
AllAsync(Func<TElement, Boolean>) | Détermine de façon asynchrone si tous les éléments de la requête remplissent une condition. (Hérité de DbRawSqlQuery<TElement>.) |
|
AllAsync(Func<TElement, Boolean>, CancellationToken) | Détermine de façon asynchrone si tous les éléments de la requête remplissent une condition. (Hérité de DbRawSqlQuery<TElement>.) |
|
AnyAsync() | Détermine de façon asynchrone si la requête contient des éléments. (Hérité de DbRawSqlQuery<TElement>.) |
|
AnyAsync(Func<TElement, Boolean>) | Détermine de façon asynchrone si un élément de la requête remplit une condition. (Hérité de DbRawSqlQuery<TElement>.) |
|
AnyAsync(CancellationToken) | Détermine de façon asynchrone si la requête contient des éléments. (Hérité de DbRawSqlQuery<TElement>.) |
|
AnyAsync(Func<TElement, Boolean>, CancellationToken) | Détermine de façon asynchrone si un élément de la requête remplit une condition. (Hérité de DbRawSqlQuery<TElement>.) |
|
AsNoTracking | Retourne une nouvelle requête où les entités retournées ne seront pas mises en cache dans le DbContext. |
|
AsStreaming | Obsolète. Retourne une nouvelle requête qui transmettra en continu les résultats au lieu de les mettre en mémoire tampon. |
|
ContainsAsync(TElement) | Détermine de façon asynchrone si la requête contient un élément spécifié à l'aide du comparateur d'égalité par défaut. (Hérité de DbRawSqlQuery<TElement>.) |
|
ContainsAsync(TElement, CancellationToken) | Détermine de façon asynchrone si la requête contient un élément spécifié à l'aide du comparateur d'égalité par défaut. (Hérité de DbRawSqlQuery<TElement>.) |
|
CountAsync() | Retourne de façon asynchrone le nombre d'éléments dans la requête. (Hérité de DbRawSqlQuery<TElement>.) |
|
CountAsync(Func<TElement, Boolean>) | Retourne de façon asynchrone le nombre d'éléments dans la requête qui répondent à une condition. (Hérité de DbRawSqlQuery<TElement>.) |
|
CountAsync(CancellationToken) | Retourne de façon asynchrone le nombre d'éléments dans la requête. (Hérité de DbRawSqlQuery<TElement>.) |
|
CountAsync(Func<TElement, Boolean>, CancellationToken) | Retourne de façon asynchrone le nombre d'éléments dans la requête qui répondent à une condition. (Hérité de DbRawSqlQuery<TElement>.) |
|
Equals | Spécifie si cette instance est identique à un objet spécifié. (Substitue DbRawSqlQuery<TElement>.Equals(Object).) |
|
Finalize | (Hérité de Object.) |
|
FirstAsync() | Retourne de façon asynchrone le premier élément de la requête. (Hérité de DbRawSqlQuery<TElement>.) |
|
FirstAsync(Func<TElement, Boolean>) | Retourne de façon asynchrone le premier élément de la requête qui remplit la condition spécifiée. (Hérité de DbRawSqlQuery<TElement>.) |
|
FirstAsync(CancellationToken) | Retourne de façon asynchrone le premier élément de la requête. (Hérité de DbRawSqlQuery<TElement>.) |
|
FirstAsync(Func<TElement, Boolean>, CancellationToken) | Retourne de façon asynchrone le premier élément de la requête qui remplit la condition spécifiée. (Hérité de DbRawSqlQuery<TElement>.) |
|
FirstOrDefaultAsync() | Retourne de façon asynchrone le premier élément de la requête, ou une valeur par défaut si le résultat de la requête ne contient aucun élément. (Hérité de DbRawSqlQuery<TElement>.) |
|
FirstOrDefaultAsync(Func<TElement, Boolean>) | Retourne de façon asynchrone le premier élément de la requête qui satisfait une condition spécifiée ou une valeur par défaut si aucun élément ne correspond. (Hérité de DbRawSqlQuery<TElement>.) |
|
FirstOrDefaultAsync(CancellationToken) | Retourne de façon asynchrone le premier élément de la requête, ou une valeur par défaut si le résultat de la requête ne contient aucun élément. (Hérité de DbRawSqlQuery<TElement>.) |
|
FirstOrDefaultAsync(Func<TElement, Boolean>, CancellationToken) | Retourne de façon asynchrone le premier élément de la requête qui satisfait une condition spécifiée ou une valeur par défaut si aucun élément ne correspond. (Hérité de DbRawSqlQuery<TElement>.) |
|
ForEachAsync(Action<TElement>) | Énumère de façon asynchrone les résultats de la requête et effectue l'action spécifiée sur chaque élément. (Hérité de DbRawSqlQuery<TElement>.) |
|
ForEachAsync(Action<TElement>, CancellationToken) | Énumère de façon asynchrone les résultats de la requête et effectue l'action spécifiée sur chaque élément. (Hérité de DbRawSqlQuery<TElement>.) |
|
GetEnumerator | Retourne un IEnumerator<T> qui lorsqu'il est énuméré exécute la requête SQL sur la base de données. (Hérité de DbRawSqlQuery<TElement>.) |
|
GetHashCode | Obtient le code de hachage associé à cette instance. (Substitue DbRawSqlQuery<TElement>.GetHashCode().) |
|
GetType | Obtient le type associé à cette instance. |
|
LongCountAsync() | Retourne de façon asynchrone un Int64 qui représente le nombre total d'éléments dans la requête. (Hérité de DbRawSqlQuery<TElement>.) |
|
LongCountAsync(Func<TElement, Boolean>) | Retourne de façon asynchrone un Int64 qui représente le nombre d'éléments dans la requête qui répondent à une condition. (Hérité de DbRawSqlQuery<TElement>.) |
|
LongCountAsync(CancellationToken) | Retourne de façon asynchrone un Int64 qui représente le nombre total d'éléments dans la requête. (Hérité de DbRawSqlQuery<TElement>.) |
|
LongCountAsync(Func<TElement, Boolean>, CancellationToken) | Retourne de façon asynchrone un Int64 qui représente le nombre d'éléments dans la requête qui répondent à une condition. (Hérité de DbRawSqlQuery<TElement>.) |
|
MaxAsync() | Retourne de façon asynchrone la valeur maximale de la requête. (Hérité de DbRawSqlQuery<TElement>.) |
|
MaxAsync(CancellationToken) | Retourne de façon asynchrone la valeur maximale de la requête. (Hérité de DbRawSqlQuery<TElement>.) |
|
MemberwiseClone | (Hérité de Object.) |
|
MinAsync() | Retourne de façon asynchrone la valeur minimale de la requête. (Hérité de DbRawSqlQuery<TElement>.) |
|
MinAsync(CancellationToken) | Retourne de façon asynchrone la valeur minimale de la requête. (Hérité de DbRawSqlQuery<TElement>.) |
|
SingleAsync() | Retourne de façon asynchrone l'élément unique de la requête et lève une exception, si cette séquence ne contient pas exactement un élément. (Hérité de DbRawSqlQuery<TElement>.) |
|
SingleAsync(Func<TElement, Boolean>) | Retourne de façon asynchrone le seul élément de la requête qui satisfait une condition spécifiée ou lève une exception, s'il existe plusieurs éléments de ce type. (Hérité de DbRawSqlQuery<TElement>.) |
|
SingleAsync(CancellationToken) | Retourne de façon asynchrone l'élément unique de la requête et lève une exception, si cette séquence ne contient pas exactement un élément. (Hérité de DbRawSqlQuery<TElement>.) |
|
SingleAsync(Func<TElement, Boolean>, CancellationToken) | Retourne de façon asynchrone le seul élément de la requête qui satisfait une condition spécifiée ou lève une exception, s'il existe plusieurs éléments de ce type. (Hérité de DbRawSqlQuery<TElement>.) |
|
SingleOrDefaultAsync() | Retourne de façon asynchrone l'élément unique d'une séquence ou une valeur par défaut si la séquence est vide. Cette méthode lève une exception si cette séquence contient plusieurs éléments. (Hérité de DbRawSqlQuery<TElement>.) |
|
SingleOrDefaultAsync(Func<TElement, Boolean>) | Retourne de façon asynchrone l'élément unique de la requête ou une valeur par défaut si cette séquence ne contient pas d'élément respectant cette condition. Cette méthode lève une exception si cette séquence contient plusieurs éléments satisfaisant cette condition. (Hérité de DbRawSqlQuery<TElement>.) |
|
SingleOrDefaultAsync(CancellationToken) | Retourne de façon asynchrone l'élément unique d'une séquence ou une valeur par défaut si la séquence est vide. Cette méthode lève une exception si cette séquence contient plusieurs éléments. (Hérité de DbRawSqlQuery<TElement>.) |
|
SingleOrDefaultAsync(Func<TElement, Boolean>, CancellationToken) | Retourne de façon asynchrone l'élément unique de la requête ou une valeur par défaut si cette séquence ne contient pas d'élément respectant cette condition. Cette méthode lève une exception si cette séquence contient plusieurs éléments satisfaisant cette condition. (Hérité de DbRawSqlQuery<TElement>.) |
|
ToArrayAsync() | Crée un tableau de la requête par énumération asynchrone. (Hérité de DbRawSqlQuery<TElement>.) |
|
ToArrayAsync(CancellationToken) | Crée un tableau de la requête par énumération asynchrone. (Hérité de DbRawSqlQuery<TElement>.) |
|
ToDictionaryAsync<TKey>(Func<TElement, TKey>) | Crée un Dictionary<TKey, TValue> de la requête par énumération asynchrone selon une fonction de sélection de clé spécifiée. (Hérité de DbRawSqlQuery<TElement>.) |
|
ToDictionaryAsync<TKey>(Func<TElement, TKey>, IEqualityComparer<TKey>) | Crée un Dictionary<TKey, TValue> de la requête par énumération asynchrone selon une fonction de sélection de clé et un comparateur spécifiés. (Hérité de DbRawSqlQuery<TElement>.) |
|
ToDictionaryAsync<TKey>(Func<TElement, TKey>, CancellationToken) | Crée un Dictionary<TKey, TValue> de la requête par énumération asynchrone selon une fonction de sélection de clé spécifiée. (Hérité de DbRawSqlQuery<TElement>.) |
|
ToDictionaryAsync<TKey>(Func<TElement, TKey>, IEqualityComparer<TKey>, CancellationToken) | Crée un Dictionary<TKey, TValue> de la requête par énumération asynchrone selon une fonction de sélection de clé et un comparateur spécifiés. (Hérité de DbRawSqlQuery<TElement>.) |
|
ToDictionaryAsync<TKey, TResult>(Func<TElement, TKey>, Func<TElement, TResult>) | Crée un Dictionary<TKey, TValue> de la requête par énumération asynchrone selon une fonction de sélection de clé et une fonction de sélection d'élément spécifiées. (Hérité de DbRawSqlQuery<TElement>.) |
|
ToDictionaryAsync<TKey, TResult>(Func<TElement, TKey>, Func<TElement, TResult>, IEqualityComparer<TKey>) | Crée un Dictionary<TKey, TValue> de la requête par énumération asynchrone selon une fonction de sélection de clé, un comparateur et une fonction de sélection d'élément spécifiés. (Hérité de DbRawSqlQuery<TElement>.) |
|
ToDictionaryAsync<TKey, TResult>(Func<TElement, TKey>, Func<TElement, TResult>, CancellationToken) | Crée un Dictionary<TKey, TValue> de la requête par énumération asynchrone selon une fonction de sélection de clé et une fonction de sélection d'élément spécifiées. (Hérité de DbRawSqlQuery<TElement>.) |
|
ToDictionaryAsync<TKey, TResult>(Func<TElement, TKey>, Func<TElement, TResult>, IEqualityComparer<TKey>, CancellationToken) | Crée un Dictionary<TKey, TValue> de la requête par énumération asynchrone selon une fonction de sélection de clé, un comparateur et une fonction de sélection d'élément spécifiés. (Hérité de DbRawSqlQuery<TElement>.) |
|
ToListAsync() | Crée un List<T> de la requête par énumération asynchrone. (Hérité de DbRawSqlQuery<TElement>.) |
|
ToListAsync(CancellationToken) | Crée un List<T> de la requête par énumération asynchrone. (Hérité de DbRawSqlQuery<TElement>.) |
|
ToString | Retourne une représentation sous forme de chaîne de cette instance. (Substitue DbRawSqlQuery<TElement>.ToString().) |
Top
Implémentations d'interface explicite
| Nom | Description | |
|---|---|---|
.gif "Implémentation d'interface explicite") .gif "Propriété privée") |
IListSource.ContainsListCollection | Retourne false. (Hérité de DbRawSqlQuery<TElement>.) |
.gif "Méthode privée") |
IEnumerable.GetEnumerator | Retourne un IEnumerator qui lorsqu'il est énuméré exécute la requête SQL sur la base de données. (Hérité de DbRawSqlQuery<TElement>.) |
|
IListSource.GetList | Lève une exception qui indique que la liaison directe à une requête de magasin n'est pas prise en charge. (Hérité de DbRawSqlQuery<TElement>.) |
|
IDbAsyncEnumerable.GetAsyncEnumerator | Retourne un IDbAsyncEnumerable qui lorsqu'il est énuméré exécute la requête SQL sur la base de données. (Hérité de DbRawSqlQuery<TElement>.) |
|
IDbAsyncEnumerable<TElement>.GetAsyncEnumerator | Retourne IDbAsyncEnumerator<T> qui lorsqu'il est énuméré exécute la requête SQL sur la base de données. (Hérité de DbRawSqlQuery<TElement>.) |
Top
Sécurité des threads
Tous les membres static (Shared en Visual Basic) publics de ce type sont thread-safe. Tous les membres de l'instance ne sont pas garantis comme étant thread-safe.