DbSqlQuery, classe

Article
12/22/2014

[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 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(Type, String, Object[]). Consultez DbSqlQuery<TEntity> pour une version générique de cette classe.

Hiérarchie d'héritage

System.Object
System.Data.Entity.Infrastructure.DbRawSqlQuery
System.Data.Entity.Infrastructure.DbSqlQuery

Espace de noms : System.Data.Entity.Infrastructure
Assembly : EntityFramework (dans EntityFramework.dll)

Syntaxe

'Déclaration
<SuppressMessageAttribute("Microsoft.Design", "CA1010:CollectionsShouldImplementGenericInterface")> _
<SuppressMessageAttribute("Microsoft.Naming", "CA1710:IdentifiersShouldHaveCorrectSuffix")> _
Public Class DbSqlQuery _
    Inherits DbRawSqlQuery
'Utilisation
Dim instance As DbSqlQuery

[SuppressMessageAttribute("Microsoft.Design", "CA1010:CollectionsShouldImplementGenericInterface")]
[SuppressMessageAttribute("Microsoft.Naming", "CA1710:IdentifiersShouldHaveCorrectSuffix")]
public class DbSqlQuery : DbRawSqlQuery

[SuppressMessageAttribute(L"Microsoft.Design", L"CA1010:CollectionsShouldImplementGenericInterface")]
[SuppressMessageAttribute(L"Microsoft.Naming", L"CA1710:IdentifiersShouldHaveCorrectSuffix")]
public ref class DbSqlQuery : public DbRawSqlQuery

[<SuppressMessageAttribute("Microsoft.Design", "CA1010:CollectionsShouldImplementGenericInterface")>]
[<SuppressMessageAttribute("Microsoft.Naming", "CA1710:IdentifiersShouldHaveCorrectSuffix")>]
type DbSqlQuery =  
    class 
        inherit DbRawSqlQuery 
    end

public class DbSqlQuery extends DbRawSqlQuery

Le type DbSqlQuery expose les membres suivants.

Constructeurs

	Nom	Description
	DbSqlQuery	Crée une instance d'un DbSqlQuery lors d'un appel depuis le constructeur d'un type dérivé qui servira à vérifier une deuxième fois SqlQuery(String, 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
	AsNoTracking	Retourne une nouvelle requête où les résultats de la requête ne seront pas suivis par le DbContext associé.
	AsStreaming	Obsolète. Retourne une nouvelle requête qui transmettra en continu les résultats au lieu de les mettre en mémoire tampon.
	Equals	Détermine si l'objet spécifié équivaut à l'instance actuelle. (Substitue DbRawSqlQuery.Equals(Object).)
	Finalize	(Hérité de Object.)
	ForEachAsync(Action<Object>)	É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.)
	ForEachAsync(Action<Object>, 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.)
	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.)
	GetHashCode	Retourne le code de hachage pour l'instance actuelle. (Substitue DbRawSqlQuery.GetHashCode().)
	GetType	Obtient le type associé à la requête.
	MemberwiseClone	(Hérité de Object.)
	ToListAsync()	Crée un List<T> de la requête par énumération asynchrone. (Hérité de DbRawSqlQuery.)
	ToListAsync(CancellationToken)	Crée un List<T> de la requête par énumération asynchrone. (Hérité de DbRawSqlQuery.)
	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 DbRawSqlQuery.ToString().)

Top

Implémentations d'interface explicite

	Nom	Description
	IListSource.ContainsListCollection	Retourne false. (Hérité de DbRawSqlQuery.)
	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.)
	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.)

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

Partager via