DbRawSqlQuery<TElement>, 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 non-entités créées à partir d'un DbContext qui est exécuté à l'aide de la connexion de ce contexte. Les instances de cette classe sont obtenues de l'instance Database. 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 entités sont créées à l'aide de SqlQuery(String, Object[]). Consultez DbRawSqlQuery pour une version non générique de cette classe.

Hiérarchie d'héritage

System.Object
  System.Data.Entity.Infrastructure.DbRawSqlQuery<TElement>
    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 DbRawSqlQuery(Of TElement) _
    Implements IEnumerable(Of TElement), IEnumerable,  _
    IListSource, IDbAsyncEnumerable(Of TElement), IDbAsyncEnumerable
'Utilisation
Dim instance As DbRawSqlQuery(Of TElement)

[SuppressMessageAttribute("Microsoft.Naming", "CA1710:IdentifiersShouldHaveCorrectSuffix")]
public class DbRawSqlQuery<TElement> : IEnumerable<TElement>, 
    IEnumerable, IListSource, IDbAsyncEnumerable<TElement>, IDbAsyncEnumerable

[SuppressMessageAttribute(L"Microsoft.Naming", L"CA1710:IdentifiersShouldHaveCorrectSuffix")]
generic<typename TElement>
public ref class DbRawSqlQuery : IEnumerable<TElement>, 
    IEnumerable, IListSource, IDbAsyncEnumerable<TElement>, IDbAsyncEnumerable

[<SuppressMessageAttribute("Microsoft.Naming", "CA1710:IdentifiersShouldHaveCorrectSuffix")>]
type DbRawSqlQuery<'TElement> =  
    class 
        interface IEnumerable<'TElement>
        interface IEnumerable 
        interface IListSource 
        interface IDbAsyncEnumerable<'TElement>
        interface IDbAsyncEnumerable 
    end

JScript does not support generic types and methods.

Paramètres de type

• TElement
  Type des éléments retournés par la requête.

Le type DbRawSqlQuery<TElement> expose les membres suivants.

Méthodes

	Nom	Description
	AllAsync(Func<TElement, Boolean>)	Détermine de façon asynchrone si tous les éléments de la requête remplissent une condition.
	AllAsync(Func<TElement, Boolean>, CancellationToken)	Détermine de façon asynchrone si tous les éléments de la requête remplissent une condition.
	AnyAsync()	Détermine de façon asynchrone si la requête contient des éléments.
	AnyAsync(Func<TElement, Boolean>)	Détermine de façon asynchrone si un élément de la requête remplit une condition.
	AnyAsync(CancellationToken)	Détermine de façon asynchrone si la requête contient des éléments.
	AnyAsync(Func<TElement, Boolean>, CancellationToken)	Détermine de façon asynchrone si un élément de la requête remplit une condition.
	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.
	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.
	CountAsync()	Retourne de façon asynchrone le nombre d'éléments dans la requête.
	CountAsync(Func<TElement, Boolean>)	Retourne de façon asynchrone le nombre d'éléments dans la requête qui répondent à une condition.
	CountAsync(CancellationToken)	Retourne de façon asynchrone le nombre d'éléments dans la requête.
	CountAsync(Func<TElement, Boolean>, CancellationToken)	Retourne de façon asynchrone le nombre d'éléments dans la requête qui répondent à une condition.
	Equals	Détermine si la requête actuelle est égale à la requête spécifiée. (Substitue Object.Equals(Object).)
	Finalize	(Hérité de Object.)
	FirstAsync()	Retourne de façon asynchrone le premier élément de la requête.
	FirstAsync(Func<TElement, Boolean>)	Retourne de façon asynchrone le premier élément de la requête qui remplit la condition spécifiée.
	FirstAsync(CancellationToken)	Retourne de façon asynchrone le premier élément de la requête.
	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.
	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.
	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.
	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.
	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.
	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.
	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.
	GetEnumerator	Retourne un IEnumerator<T> qui lorsqu'il est énuméré exécute la requête SQL sur la base de données.
	GetHashCode	Retourne la fonction de hachage pour cette requête. (Substitue Object.GetHashCode().)
	GetType	Obtient le type de la requête actuelle.
	LongCountAsync()	Retourne de façon asynchrone un Int64 qui représente le nombre total d'éléments dans la requête.
	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.
	LongCountAsync(CancellationToken)	Retourne de façon asynchrone un Int64 qui représente le nombre total d'éléments dans la requête.
	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.
	MaxAsync()	Retourne de façon asynchrone la valeur maximale de la requête.
	MaxAsync(CancellationToken)	Retourne de façon asynchrone la valeur maximale de la requête.
	MemberwiseClone	(Hérité de Object.)
	MinAsync()	Retourne de façon asynchrone la valeur minimale de la requête.
	MinAsync(CancellationToken)	Retourne de façon asynchrone la valeur minimale de la requête.
	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.
	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.
	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.
	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.
	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.
	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.
	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.
	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.
	ToArrayAsync()	Crée un tableau de la requête par énumération asynchrone.
	ToArrayAsync(CancellationToken)	Crée un tableau de la requête par énumération asynchrone.
	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.
	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.
	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.
	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.
	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.
	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.
	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.
	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.
	ToListAsync()	Crée un List<T> de la requête par énumération asynchrone.
	ToListAsync(CancellationToken)	Crée un List<T> de la requête par énumération asynchrone.
	ToString	Retourne un String qui contient la chaîne SQL définie lorsque la requête a été créée.Les paramètres ne sont pas inclus. (Substitue Object.ToString().)

Top

Implémentations d'interface explicite

	Nom	Description
	IListSource.ContainsListCollection	Retourne false.
	IEnumerable.GetEnumerator	Retourne un IEnumerator qui lorsqu'il est énuméré exécute la requête SQL sur la base de données.
	IListSource.GetList	Lève une exception qui indique que la liaison directe à une requête de magasin n'est pas prise en charge.
	IDbAsyncEnumerable.GetAsyncEnumerator	Retourne un IDbAsyncEnumerable qui lorsqu'il est énuméré exécute la requête SQL sur la base de données.
	IDbAsyncEnumerable<TElement>.GetAsyncEnumerator	Retourne IDbAsyncEnumerator<T> qui lorsqu'il est énuméré exécute la requête SQL sur la base de données.

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.

Voir aussi

Référence

Espace de noms System.Data.Entity.Infrastructure