REF (Entity SQL)REF (Entity SQL)

Restituisce un riferimento a un'istanza dell'entità.Returns a reference to an entity instance.

SintassiSyntax

REF( expression )   

ArgomentiArguments

expression
Qualsiasi espressione valida che produce un'istanza di un tipo di entità.Any valid expression that yields an instance of an entity type.

Valore restituitoReturn Value

Riferimento all'istanza dell'entità specificata.A reference to the specified entity instance.

NoteRemarks

Un riferimento all'entità è costituito dalla chiave di entità e dal nome di un set di entità.An entity reference consists of the entity key and an entity set name. Poiché set di entità diversi possono essere basati sullo stesso tipo di entità, una determinata chiave di entità può essere visualizzata in più set di entità.Because different entity sets can be based on the same entity type, a particular entity key can appear in multiple entity sets. Un riferimento all'entità è tuttavia sempre univoco.However, an entity reference is always unique. Se l'espressione di input rappresenta un'entità persistente, verrà restituito un riferimento a tale entità.If the input expression represents a persisted entity, a reference to this entity will be returned. Se l'espressione di input non è un'entità persistente, verrà restituito un riferimento Null.If the input expression is not a persisted entity, a null reference will be returned.

Quando viene usato l'operatore di estrazione delle proprietà (.), il riferimento viene automaticamente dereferenziato.If the property extraction operator (.) is used to access a property of an entity, the reference is automatically dereferenced.

EsempioExample

Nella query Entity SQL seguente viene usato l'operatore REF per restituire il riferimento per un argomento dell'entità di input.The following Entity SQL query uses the REF operator to return the reference for an input entity argument. Nella stessa query il riferimento viene dereferenziato in quanto viene usato l'operatore di estrazione delle proprietà (.) per accedere a una proprietà dell'entità Product.The same query dereferences the reference because we are using a property extraction operation (.) to access a property of the Product entity. La query è basata sul modello Sales di AdventureWorks.The query is based on the AdventureWorks Sales Model. Per compilare ed eseguire questa query, effettuare le operazioni seguenti:To compile and run this query, follow these steps:

  1. Attenersi alla procedura di procedura: eseguire una Query che restituisce risultati di PrimitiveType.Follow the procedure in How to: Execute a Query that Returns PrimitiveType Results.

  2. Passare la query seguente come argomento al metodo ExecutePrimitiveTypeQuery :Pass the following query as an argument to the ExecutePrimitiveTypeQuery method:

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

Vedere ancheSee Also

DEREFDEREF
CREATEREFCREATEREF
KEYKEY
Riferimento a Entity SQLEntity SQL Reference
Definizioni di tipoType Definitions