REF (Entity SQL)

Retorna uma referência a uma instância de entidade.

Sintaxe

REF( expression )

Argumentos

expression
Qualquer expressão válida que produz uma instância de um tipo de entidade.

Valor de retorno

Uma referência à instância de entidade especificada.

Observações

Uma referência de entidade consiste na chave de entidade e em um nome de conjunto de entidades. Como conjuntos de entidades diferentes podem ser baseados no mesmo tipo de entidade, uma chave de entidade específica pode aparecer em vários conjuntos de entidades. No entanto, uma referência de entidade é sempre exclusiva. Se a expressão de entrada representar uma entidade persistente, uma referência a essa entidade será retornada. Se a expressão de entrada não for uma entidade persistente, uma referência nula será retornada.

Se o operador de extração de propriedade (.) for usado para acessar uma propriedade de uma entidade, a referência será automaticamente desreferenciada.

Exemplo

A consulta SQL de entidade a seguir usa o operador REF para retornar a referência de um argumento de entidade de entrada. A mesma consulta desreferencia a referência porque estamos usando uma operação de extração de propriedade (.) para acessar uma propriedade da entidade Product. A consulta é baseada no Modelo de Vendas adventureworks. Para compilar e executar essa consulta, siga estas etapas:

1. Siga o procedimento em How to: Execute a Query that Returns PrimitiveType Results.

2. Passe a consulta a seguir como um argumento para o ExecutePrimitiveTypeQuery método:

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

Consulte também

• DEREF
• CREATEREF
• KEY
• Referência de Entity SQL
• Definições de tipo