Partager via


Fonctions canoniques

Cette section décrit les fonctions canoniques qui sont prises en charge par tous les fournisseurs de données et qui peuvent être utilisée par toutes les technologies de requête. Les fonctions canoniques ne peuvent pas être étendues par un fournisseur.

Ces fonctions canoniques seront traduites en fonctionnalités de source de données correspondantes pour le fournisseur. De ce fait, les appels de fonction peuvent être exprimés sous une forme commune dans toutes les sources de données.

Ces fonctions canoniques étant indépendantes des sources de données, les types d'arguments et de retour des fonctions canoniques sont définis par rapport aux types du modèle conceptuel. Toutefois, il est possible que certaines sources de données ne puissent pas prendre en charge tous les types du modèle conceptuel.

Lorsque des fonctions canoniques sont utilisées dans une requête Entity SQL, la fonction appropriée est appelée au niveau de la source de données.

Le comportement en cas d'entrée null et les conditions d'erreurs sont explicitement spécifiées pour toutes les fonctions canoniques. Les fournisseurs de magasins doivent respecter ce comportement, mais Entity Framework ne l’applique pas de force.

Dans le cas des scénarios LINQ, les requêtes exécutées sur Entity Framework impliquent un mappage entre les méthodes CLR et les méthodes de la source de données sous-jacente. Les méthodes CLR sont mappées aux fonctions canoniques, ce qui garantit qu'un ensemble spécifique de méthodes sera correctement mappé, quelle que soit la source de données.

Espace de noms des fonctions canoniques

L'espace de noms des fonctions canoniques est System.Data.Metadata.Edm. L'espace de noms System.Data.Metadata.Edm est automatiquement inclus dans toutes les requêtes. Toutefois, si un autre espace de noms est importé et que celui-ci contient une fonction de même nom qu'une fonction canonique (dans l'espace de noms System.Data.Metadata.Edm), vous devez spécifier l'espace de noms.

Dans cette section

Fonctions canoniques d’agrégation Décrit les fonctions canoniques Entity SQL d’agrégation.

Fonctions canoniques mathématiques Décrit les fonctions canoniques de l’entité mathématique SQL.

Fonctions canoniques de chaîne Décrit les fonctions canoniques Entity SQL de chaîne.

Fonctions canoniques de date et d’heure Décrit les fonctions canoniques Entity SQL de date et d’heure.

Fonctions canoniques au niveau du bit Décrit les fonctions canoniques Entity SQL au niveau du bit.

Fonctions spatiales Décrit les fonctions canoniques spatiales Entity SQL.

Autres fonctions canoniques Décrit les fonctions qui ne sont pas considérées comme des fonctions au niveau du bit, des fonctions de date/heure, des fonctions de chaîne, des fonctions mathématiques ni des fonctions d’agrégation.

Voir aussi