TREAT (Entity SQL)

Trata um objeto de um tipo base específico como um objeto do tipo derivado especificado.

Sintaxe

TREAT ( expression as type)

Argumentos

expression Qualquer expressão de consulta válida que retorna uma entidade.

type Um tipo de entidade. O tipo deve ser qualificado por um namespace.

Valor de retorno

Um valor do tipo de dados especificado.

Observações

O TREAT é usado para executar o upcasting entre classes relacionadas. Por exemplo, se Employee deriva de Person e p é do tipo Person, TREAT(p AS NamespaceName.Employee) upcasts uma instância genérica Person para Employee; ou seja, permite que você trate p como Employee.

O TREAT é usado em cenários de herança em que você pode fazer uma consulta como a seguinte:

SELECT TREAT(p AS NamespaceName.Employee)
FROM ContainerName.Person AS p
WHERE p IS OF (NamespaceName.Employee)

Essa consulta upcasts entidades Person para o Employee tipo. Se o valor de p não for realmente do tipo Employee, a expressão produzirá o valor null.

A tabela a seguir mostra o comportamento de tratamento sobre alguns padrões típicos e alguns padrões menos comuns. Todas as exceções são geradas do lado do cliente antes que o provedor seja invocado:

Exemplo

A consulta SQL de entidade a seguir usa o operador TREAT para converter um objeto do tipo Course em uma coleção de objetos do tipo OnsiteCourse. A consulta é baseada no modelo de escola.

SELECT VALUE TREAT (course AS SchoolModel.OnsiteCourse) 
   FROM SchoolEntities.Courses AS course
   WHERE course IS OF( SchoolModel.OnsiteCourse)

Consulte também

• Referência de Entity SQL
• Tipos estruturados anuláveis