LINQ to Entities

Artigo
05/10/2023

O LINQ to Entities fornece suporte a LINQ (Consulta Integrada à Linguagem) que permite aos desenvolvedores escreverem consultas no modelo conceitual do Entity Framework usando Visual Basic ou Visual C#. As consultas no Entity Framework são representadas por consultas de árvore de comando, que são executadas no contexto de objeto. O LINQ to Entities converte consultas do LINQ (Consulta Integrada à Linguagem) para consultas de árvore de comando, executa as consultas no Entity Framework e retorna os objetos que podem ser usados pelo Entity Framework e pelo LINQ. Veja a seguir o processo para criar e executar uma consulta LINQ to Entities:

Construa uma instância ObjectQuery<T> do ObjectContext.
Componha uma consulta LINQ to Entities no C# ou Visual Basic usando a instância ObjectQuery<T>.
Converta operadores e expressões padrão de consulta LINQ para árvores de comando.
Execute a consulta, na representação da árvore de comando, na fonte de dados. Todas as exceções geradas na fonte de dados durante a execução são passadas diretamente até o cliente.
Retorne os resultados da consulta de volta para o cliente.

Construindo uma instância de ObjectQuery

A classe genérica ObjectQuery<T> representa uma consulta que retorna uma coleção de zero ou mais entidades tipadas. Uma consulta de objeto é construída normalmente de um contexto de objeto existente, em vez de ser construído manualmente, e sempre pertence ao contexto de objeto. Esse contexto fornece a conexão e as informações de metadados necessárias para compor e executar a consulta. A classe genérica ObjectQuery<T> implementa a interface genérica IQueryable<T>, cujos métodos de construtor habilitam as consultas LINQ para serem criadas incrementalmente. Você também pode permitir que o compilador infira o tipo de entidade usando a palavra-chave var do C# (Dim no Visual Basic, com inferência de tipo de local habilitada).

Compondo as consultas

As instâncias da classe genérica ObjectQuery<T>, que implementa a interface de IQueryable<T>, funcionam como a fonte de dados para consultas LINQ to Entities. Em uma consulta, você especifica exatamente as informações que deseja recuperar da fonte de dados. Uma consulta também pode especificar como essas informações devem ser classificadas, agrupadas e moldadas antes de serem retornadas. No LINQ, uma consulta é armazenada em uma variável. Essa variável de consulta não toma nenhuma ação e não retorna nenhum dado, ela apenas armazena as informações da consulta. Depois de criar uma consulta, você deve executá-la para recuperar todos os dados.

As consultas LINQ to Entities podem ser compostas de duas sintaxes diferentes: sintaxe de expressão de consulta e sintaxe de consulta baseada em método. A sintaxe da expressão de consulta e a sintaxe da consulta com base em método são novidades no C# 3.0 e no Visual Basic 9.0.

Para obter mais informações, veja Consultas no LINQ to Entities.

Conversão de consulta

Para executar uma consulta LINQ to Entities no Entity Framework, a consulta LINQ deve ser convertida em uma representação de árvore de comando que pode ser executada no Entity Framework.

As consultas LINQ to Entities são compostas de operadores padrão de consulta LINQ (como Select, Where e GroupBy) e expressões (x > 10, Contact.LastName, e assim por diante). Os operadores LINQ não são definidos por uma classe, mas são métodos em uma classe. No LINQ, as expressões podem conter tudo o que é permitido por tipos dentro do namespace System.Linq.Expressions e, por extensão, tudo o que pode ser representado em uma função lambda. Este é um superconjunto de expressões que são permitidas pelo Entity Framework, que são restritas por definição para as operações permitidas no banco de dados, e têm suporte pelo ObjectQuery<T>.

No Entity Framework, os operadores e as expressões são representados por uma única hierarquia de tipo, que são colocadas em uma árvore de comando. A árvore de comando é usada pelo Entity Framework para executar a consulta. Se a consulta LINQ não puder ser expressada como uma árvore de comando, uma exceção será gerada quando a consulta estiver sendo convertida. A conversão de consultas LINQ to Entities envolve duas subconversões: a conversão dos operadores de consulta padrão e a conversão das expressões.

Há um número de operadores padrão de consulta LINQ que não têm uma tradução válida no LINQ to Entities. As tentativas de usar esses operadores resultarão em uma exceção em tempo de tradução de consulta. Para obter uma lista de operadores de LINQ to Entities com suporte, consulte Métodos LINQ com suporte e sem suporte (LINQ to Entities).

Para obter mais informações sobre como usar os operadores de consulta padrão no LINQ to Entities, consulte Operadores de Consulta Padrão em consultas LINQ to Entities.

Em geral, as expressões no LINQ to Entities são avaliadas no servidor. Portanto, não se deve esperar que o comportamento da expressão siga a semântica de CLR. Para obter mais informações, consulte Expressões em consultas LINQ to Entities.

Para obter informações sobre como as chamadas de método CLR são mapeados para funções canônicas na fonte de dados, consulte Método CLR ao mapeamento canônico de função.

Para obter informações sobre como chamar funções canônicas, de banco de dados e personalizadas de dentro de consultas LINQ to Entities, consulte Funções de chamada em consultas LINQ to Entities.

Execução da consulta

Depois que a consulta LINQ é criada pelo usuário, ela é convertida para uma representação que está compatível com o Entity Framework (na forma de árvores de comando), que é, em seguida, executado na fonte de dados. No tempo de execução de consulta, todas as expressões de consulta (ou componentes da consulta) são avaliados no cliente ou no servidor. Isso inclui as expressões que são usadas na materialização de resultados ou projeções de entidade. Para obter mais informações, consulte Execução de consulta. Para obter informações sobre como melhorar o desempenho criando uma consulta uma vez e, em seguida, executá-la várias vezes com parâmetros diferentes, consulte Consultas compiladas (LINQ to Entities).

Materialização

A materialização é o processo de retornar resultados de consulta de volta para o cliente como tipos CLR. No LINQ to Entities, os registros de dados dos resultados da consulta nunca são retornados; há sempre um tipo CLR de suporte, definido pelo usuário ou pelo Entity Framework, ou gerado pelo compilador (tipos anônimos). Qualquer materialização de objeto é executada pelo Entity Framework. Todos os erros que resultarem de uma incapacidade de mapear entre o Entity Framework e o CLR gerarão exceções durante a materialização do objeto.

Os resultados da consulta são geralmente retornados como um dos seguintes:

Uma coleção de zero ou mais objetos de entidade tipados ou uma projeção de tipos complexos definidos no modelo conceitual.
Tipos CLR compatíveis com o Entity Framework.
Coleções internas.
Tipos anônimos.

Para obter mais informações, consulte Resultados de consulta.