LINQ to Entities

Article
05/10/2023

LINQ to Entities assure une prise en charge de la technologie LINQ (Language Integrated Query), ce qui permet aux développeurs d'écrire des requêtes par rapport au modèle conceptuel Entity Framework à l'aide du langage Visual Basic ou Visual C#. Les requêtes exécutées avec Entity Framework sont représentées par des requêtes d'arborescence de commandes, lesquelles s'exécutent par rapport au contexte de l'objet. LINQ to Entities convertit les requêtes LINQ (Language-Integrated Query) en requêtes d'arborescence de commandes, exécute les requêtes avec Entity Framework, puis retourne les objets qui peuvent être utilisés aussi bien par Entity Framework que par LINQ. Voici le processus de création et d'exécution d'une requête LINQ to Entities :

Construisez une instance de l'objet ObjectQuery<T> à partir de l'objet ObjectContext.
Composez une requête LINQ to Entities en C# ou en Visual Basic en utilisant l'instance de l'objet ObjectQuery<T>.
Convertissez les expressions et opérateurs de requête standard LINQ en arborescences de commandes.
Exécutez la requête dans l'arborescence des commandes sur la source de données. Toutes les exceptions levées sur la source de données pendant l'exécution sont passées directement au client.
Retournez les résultats de la requête au client.

Construction d'une instance d'ObjectQuery

La classe générique ObjectQuery<T> représente une requête qui retourne une collection de zéro ou plusieurs entités typées. Une requête d'objet est généralement construite à partir d'un contexte d'objet existant, au lieu d'être construite manuellement, et appartient toujours à ce contexte d'objet. Ce contexte fournit les informations relatives à la connexion et aux métadonnées qui sont requises pour composer et exécuter la requête. La classe générique ObjectQuery<T> implémente l'interface générique IQueryable<T>, dont les méthodes de générateur permettent la construction incrémentielle de requêtes LINQ. Vous pouvez également permettre au compilateur de déduire le type des entités à l'aide du mot clé C# var (Dim en Visual Basic, avec l'inférence de type local activée).

Composition des requêtes

Les instances de la classe générique ObjectQuery<T>, laquelle implémente l'interface générique IQueryable<T>, servent de source de données pour les requêtes LINQ to Entities. Dans une requête, vous spécifiez exactement les informations que vous voulez récupérer à partir de la source de données. Une requête peut également spécifier la manière dont ces informations doivent être triées, regroupées et mises en forme avant d'être retournées. Dans LINQ, une requête est stockée dans une variable. Cette variable de requête n'effectue aucune action et ne retourne aucune donnée ; elle stocke uniquement les informations de requête. Une fois que vous avez créé une requête, vous devez l'exécuter pour extraire des données.

Les requêtes LINQ to Entities peuvent être composées dans deux syntaxes différentes : la syntaxe d'expression de requête et la syntaxe de requête fondée sur une méthode. La syntaxe d'expression de requête et la syntaxe de requête fondée sur une méthode sont nouvelles dans C# 3.0 et dans Visual Basic 9.0.

Pour plus d’informations, consultez Requêtes dans LINQ to Entities.

Conversion de requête

Pour exécuter une requête LINQ to Entities avec Entity Framework, cette requête doit être convertie en représentation arborescente des commandes qui peut être exécutée avec Entity Framework.

Les requêtes LINQ to Entities sont constituées d’opérateurs de requête standard LINQ (tels que Select, Where et GroupBy) et d’expressions (x > 10, Contact.LastName, etc.). Les opérateurs LINQ ne sont pas définis par une classe ; ce sont des méthodes sur une classe. Dans LINQ, les expressions peuvent contenir tout ce que les types de l’espace de noms System.Linq.Expressions autorisent et, par extension, tout ce qui peut être représenté dans une fonction lambda. Il s’agit d’un sur-ensemble des expressions qui sont autorisées par Entity Framework, lesquelles sont, par définition, limitées aux opérations autorisées sur la base de données et prises en charge par l’objet ObjectQuery<T>.

Dans Entity Framework, les opérateurs et les expressions sont représentés par une seule hiérarchie des types, qui sont ensuite placés dans une arborescence de commandes. L'arborescence de commandes est utilisée par Entity Framework pour exécuter la requête. Si la requête LINQ ne peut pas être exprimée sous la forme d’une arborescence de commandes, une exception est levée au moment de la conversion de la requête. La conversion de requêtes LINQ to Entities implique deux sous-conversions : la conversion des opérateurs de requête standard et la conversion des expressions.

Plusieurs opérateurs de requête standard LINQ n'ont pas de traduction valide dans LINQ to Entities. Les tentatives d'utilisation de ces opérateurs provoquent une exception au moment de la traduction de la requête. Pour obtenir la liste des opérateurs LINQ to Entities pris en charge, consultez Méthodes LINQ prises en charge et non prises en charge (LINQ to Entities).

Pour plus d’informations sur l’utilisation des opérateurs de requête standard dans LINQ to Entities, consultez Opérateurs de requête standard dans les requêtes LINQ to Entities.

En règle générale, les expressions dans LINQ to Entities sont évaluées sur le serveur. Par conséquent, le comportement de l'expression n'est pas censé suivre la sémantique CLR. Pour plus d’informations, consultez Expressions dans les requêtes LINQ to Entities.

Pour plus d’informations sur la façon dont les appels de méthode CLR sont mappés à des fonctions canoniques dans la source de données, consultez Mappage de la méthode CLR aux fonctions canoniques.

Pour plus d’informations sur l’appel de fonctions canoniques, de base de données et personnalisées à partir de requêtes LINQ to Entities, consultez Appel de fonctions dans les requêtes LINQ to Entities.

Exécution des requêtes

Une fois la requête LINQ créée par l’utilisateur, elle est convertie en une représentation compatible avec Entity Framework (sous la forme d’arborescences de commandes), qui est ensuite exécutée sur la source de données. Au moment de l'exécution de la requête, l'ensemble des expressions de requête (ou des composants de la requête) sont évalués sur le client ou sur le serveur. Cela comprend les expressions qui sont utilisées dans la matérialisation des résultats ou les projections d'entités. Pour plus d’informations, consultez Exécution de requête. Pour plus d’informations sur l’amélioration des performances à travers la compilation unique d’une requête et l’exécution multiple de celle-ci avec des paramètres différents, consultez Requêtes compilées (LINQ to Entities).

Matérialisation

La matérialisation est le processus qui consiste à retourner les résultats d'une requête au client sous forme de types CLR. Dans LINQ to Entities, les enregistrements de données de résultats de requête ne sont jamais retournés ; il y a toujours un type CLR de sauvegarde, défini par l’utilisateur ou par Entity Framework, ou généré par le compilateur (types anonymes). Toute matérialisation d’objets est effectuée par Entity Framework. Toute erreur qui résulte d’une impossibilité d’effectuer un mappage entre Entity Framework et le CLR lève une exception à lever pendant la matérialisation d’objets.

Les résultats de la requête sont généralement retournés sous l'une des formes suivantes :

une collection de zéro, un ou plusieurs objets entité typés ou une projection de types complexes définis dans le modèle conceptuel ;
Types CLR pris en charge par Entity Framework.
Collections inline.
Types anonymes.

Pour plus d’informations, consultez Résultats des requêtes.