ObjectQuery, 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.]
Cette classe implémente des requêtes non typées au niveau de la couche objet.
Hiérarchie d'héritage
System.Object
System.Data.Entity.Core.Objects.ObjectQuery
System.Data.Entity.Core.Objects.ObjectQuery<T>
Espace de noms : System.Data.Entity.Core.Objects
Assembly : EntityFramework (dans EntityFramework.dll)
Syntaxe
'Déclaration
<SuppressMessageAttribute("Microsoft.Design", "CA1010:CollectionsShouldImplementGenericInterface")> _
<SuppressMessageAttribute("Microsoft.Naming", "CA1710:IdentifiersShouldHaveCorrectSuffix")> _
Public MustInherit Class ObjectQuery _
Implements IOrderedQueryable, IQueryable, IEnumerable, IListSource, _
IDbAsyncEnumerable
'Utilisation
Dim instance As ObjectQuery
[SuppressMessageAttribute("Microsoft.Design", "CA1010:CollectionsShouldImplementGenericInterface")]
[SuppressMessageAttribute("Microsoft.Naming", "CA1710:IdentifiersShouldHaveCorrectSuffix")]
public abstract class ObjectQuery : IOrderedQueryable,
IQueryable, IEnumerable, IListSource, IDbAsyncEnumerable
[SuppressMessageAttribute(L"Microsoft.Design", L"CA1010:CollectionsShouldImplementGenericInterface")]
[SuppressMessageAttribute(L"Microsoft.Naming", L"CA1710:IdentifiersShouldHaveCorrectSuffix")]
public ref class ObjectQuery abstract : IOrderedQueryable,
IQueryable, IEnumerable, IListSource, IDbAsyncEnumerable
[<AbstractClassAttribute>]
[<SuppressMessageAttribute("Microsoft.Design", "CA1010:CollectionsShouldImplementGenericInterface")>]
[<SuppressMessageAttribute("Microsoft.Naming", "CA1710:IdentifiersShouldHaveCorrectSuffix")>]
type ObjectQuery =
class
interface IOrderedQueryable
interface IQueryable
interface IEnumerable
interface IListSource
interface IDbAsyncEnumerable
end
public abstract class ObjectQuery implements IOrderedQueryable, IQueryable, IEnumerable, IListSource, IDbAsyncEnumerable
Le type ObjectQuery expose les membres suivants.
Propriétés
Nom | Description | |
---|---|---|
CommandText | Retourne le texte de commande de la requête. | |
Context | Obtient l'objet de contexte associé à cette requête d'objet. | |
EnablePlanCaching | Obtient ou définit une valeur qui indique si le plan de requête doit être mis en cache. | |
MergeOption | Obtient ou définit la manière dont les objets retournés par une requête sont ajoutés au contexte de l'objet. | |
Parameters | Obtient la collection de paramètres pour cette requête d'objet. | |
Streaming | Détermine si la requête est diffusée en continu ou mise en mémoire tampon. |
Top
Méthodes
Nom | Description | |
---|---|---|
Equals | (Hérité de Object.) | |
Execute | Exécute la requête d'objet non typé avec l'option de fusion spécifiée. | |
ExecuteAsync(MergeOption) | Exécute la requête d'objet non typé de manière asynchrone avec l'option de fusion spécifiée. | |
ExecuteAsync(MergeOption, CancellationToken) | Exécute la requête d'objet non typé de manière asynchrone avec l'option de fusion spécifiée. | |
Finalize | (Hérité de Object.) | |
GetHashCode | (Hérité de Object.) | |
GetResultType | Retourne des informations sur le type de résultat de la requête. | |
GetType | (Hérité de Object.) | |
MemberwiseClone | (Hérité de Object.) | |
ToString | (Hérité de Object.) | |
ToTraceString | Retourne les commandes à exécuter sur la source de données. |
Top
Méthodes d'extension
Nom | Description | |
---|---|---|
AsNoTracking | Retourne une nouvelle requête où les entités retournées ne seront pas mises en cache dans le DbContext ou ObjectContext.Cette méthode fonctionne en appelant la méthode AsNoTracking de l'objet de requête sous-jacent.Si l'objet de requête sous-jacent n'a pas de méthode AsNoTracking, l'appel de cette méthode n'a aucun effet. (Défini par QueryableExtensions.) | |
AsStreaming | Retourne une nouvelle requête qui transmettra en continu les résultats au lieu de les mettre en mémoire tampon.Cette méthode fonctionne en appelant la méthode AsStreaming de l'objet de requête sous-jacent.Si l'objet de requête sous-jacent n'a pas de méthode AsStreaming, l'appel de cette méthode n'a aucun effet. (Défini par QueryableExtensions.) | |
ForEachAsync(Action<Object>) | Surchargé. Énumère de façon asynchrone les résultats de la requête et effectue l'action spécifiée sur chaque élément. (Défini par QueryableExtensions.) | |
ForEachAsync(Action<Object>, CancellationToken) | Surchargé. Énumère de façon asynchrone les résultats de la requête et effectue l'action spécifiée sur chaque élément. (Défini par QueryableExtensions.) | |
Include | Spécifie les objets connexes à inclure dans les résultats de la requête. (Défini par QueryableExtensions.) | |
Load | Énumère la requête de sorte que pour les requêtes de serveur, notamment celles de DbSet<TEntity>, ObjectSet<TEntity>, ObjectQuery<T> et autres, les résultats de la requête seront chargés dans le DbContext, ObjectContext associé ou dans l'autre cache sur le client.Ceci équivaut à appeler ToList, puis à rejeter la liste sans la surcharge liée à la création de la liste proprement dite. (Défini par QueryableExtensions.) | |
LoadAsync() | Surchargé. Énumère de façon asynchrone la requête de sorte que pour les requêtes de serveur, notamment celles de DbSet<TEntity>, ObjectSet<TEntity>, ObjectQuery<T> et autres, les résultats de la requête seront chargés dans le DbContext, ObjectContext associé ou dans l'autre cache sur le client.Ceci équivaut à appeler ToList, puis à rejeter la liste sans la surcharge liée à la création de la liste proprement dite. (Défini par QueryableExtensions.) | |
LoadAsync(CancellationToken) | Surchargé. Énumère de façon asynchrone la requête de sorte que pour les requêtes de serveur, notamment celles de DbSet<TEntity>, ObjectSet<TEntity>, ObjectQuery<T> et autres, les résultats de la requête seront chargés dans le DbContext, ObjectContext associé ou dans l'autre cache sur le client.Ceci équivaut à appeler ToList, puis à rejeter la liste sans la surcharge liée à la création de la liste proprement dite. (Défini par QueryableExtensions.) | |
ToListAsync() | Surchargé. Crée un List<T> à partir d'un IQueryable par énumération asynchrone. (Défini par QueryableExtensions.) | |
ToListAsync(CancellationToken) | Surchargé. Crée un List<T> à partir d'un IQueryable par énumération asynchrone. (Défini par QueryableExtensions.) |
Top
Implémentations d'interface explicite
Nom | Description | |
---|---|---|
IListSource.ContainsListCollection | Obtient une valeur qui indique si la requête contient une collection d'objets de requête. | |
IQueryable.ElementType | Obtient le type d'élément de résultat pour cette instance de requête. | |
IQueryable.Expression | Obtient l'expression décrivant cette requête.Pour les requêtes générées à l'aide de modèles de générateurs LINQ, cela retourne une arborescence d'expressions LINQ complète ; sinon, retourne une expression constante qui encapsule cette requête.Notez que l'expression par défaut n'est pas mise en cache.Cela permet de différencier les requêtes LINQ et Entity SQL. | |
IEnumerable.GetEnumerator | Retourne un énumérateur qui itère au sein d'une collection. | |
IListSource.GetList | Retourne la collection sous la forme d'un objet IList utilisé pour la liaison de données. | |
IQueryable.Provider | Obtient l'objet IQueryProvider associé à cette instance de requête. | |
IDbAsyncEnumerable.GetAsyncEnumerator | Retourne un IDbAsyncEnumerator qui lorsqu'il est énuméré exécute la requête SQL spécifiée 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.