Partager via


REF (Entity SQL)

Retourne une référence à une instance d'entité.

REF( expression ) 

Arguments

  • expression
    Toute expression valide qui produit une instance d'un type d'entité.

Valeur de retour

Référence à l'instance d'entité spécifiée.

Notes

Une référence d'entité se compose de la clé d'entité et d'un nom de jeu d'entités. Des jeux d'entités différents pouvant être basés sur le même type d'entité, une clé d'entité particulière peut apparaître dans plusieurs jeux d'entités. Toutefois, une référence d'entité est toujours unique. Si l'expression d'entrée représente une entité rendue persistante, une référence à cette entité est retournée. Si l'expression d'entrée n'est pas une entité rendue persistante, une référence Null à cette entité est retournée.

Si l'opérateur d'extraction de propriété (.) est utilisé pour accéder à une propriété d'une entité, la référence est automatiquement supprimée.

Exemple

La requête Entity SQL suivante utilise l'opérateur REF pour retourner la référence d'un argument d'entité d'entrée. La même requête supprime la référence car nous utilisons une opération d'extraction de propriété (.) pour accéder à une propriété de l'entité Product. Cette requête est basée sur le modèle de vente AdventureWorks Sales Model. Pour la compiler et l'exécuter, procédez comme suit :

  1. Suivez la procédure indiquée dans Procédure : exécuter une requête qui retourne des résultats PrimitiveType (EntityClient).

  2. Passez à la méthode ExecutePrimitiveTypeQuery la requête suivante en tant qu'argument :

SELECT VALUE REF(p).Name FROM AdventureWorksEntities.Products as p

Voir aussi

Référence

DEREF (Entity SQL)
CREATEREF (Entity SQL)
KEY (Entity SQL)

Concepts

Référence Entity SQL
Définitions de type (Entity SQL)