Appels de méthode CLR et mappage de fonctions
Entity Framework fournit un ensemble de fonctions canoniques chargées d'implémenter des fonctionnalités communes à de nombreux systèmes de base de données, notamment la manipulation de chaînes et les fonctions mathématiques. Cela permet aux développeurs de cibler un large éventail de systèmes de base de données. Lorsqu'elles sont appelées via une technologie de requête comme LINQ to Entities, ces fonctions canoniques sont traduites dans la fonction de magasin correspondante du fournisseur utilisé. Les appels de fonction peuvent ainsi être exprimés sous une forme commune dans toutes les sources de données, ce qui procure une expérience de requête cohérente. Les opérateurs au niveau du bit AND, OR, NOT et XOR sont également mappés à des fonctions canoniques lorsque l'opérande est de type numérique. Dans le cas des opérandes booléens, les opérateurs au niveau du bit AND, OR, NOT et XOR calculent les opérations logiques AND, OR, NOT et XOR de leurs opérandes. Pour plus d'informations, voir Fonctions canoniques (Entity SQL).
Pour les scénarios LINQ, les requêtes exécutées sur Entity Framework impliquent le mappage de certaines méthodes CLR aux méthodes au niveau de la source de données sous-jacente au moyen de fonctions canoniques. Les appels de méthode d'une requête LINQ to Entities qui ne sont pas explicitement mappés à une fonction canonique entraîneront la levée d'une exception d'exécution NotSupportedException. Pour obtenir la liste des méthodes CLR qui sont mappées aux fonctions canoniques, voir Mappage de méthodes CLR à des fonctions canoniques.
Dans l'exemple suivant, la requête vise à extraire les adresses d'Algiers Drive. L'appel de méthode Contains dans la requête est mappé à la fonction canonique IndexOf.
Using AWEntities As New AdventureWorksEntities()
Dim addresses As ObjectQuery(Of Address) = AWEntities.Address
Dim query = _
From address In addresses _
Where address.AddressLine1.Contains("Algiers Dr.") _
Select address
For Each algiersAddress As Address In query
Console.WriteLine("Address 1: " + algiersAddress.AddressLine1)
Next
End Using
using (AdventureWorksEntities AWEntities = new AdventureWorksEntities())
{
ObjectQuery<Address> addresses = AWEntities.Address;
IQueryable<Address> query = from address in addresses
where address.AddressLine1.Contains("Algiers Dr.")
select address;
// Addresses on Algiers Dr.
foreach (Address algiersAddress in query)
{
Console.WriteLine("Address 1: " + algiersAddress.AddressLine1);
}
}
Voir aussi
Concepts
Fonctions canoniques (Entity SQL)