O que Include () faz no LINQ?

Eu tentei fazer muitas pesquisas, mas sou mais um cara de banco de dados - então mesmo a explicação no MSDN não faz nenhum sentido para mim. Alguém pode explicar e fornecer alguns exemplos sobre o que a Include()afirmação faz no termo de SQLconsulta?

Digamos, por exemplo, que você deseja obter uma lista de todos os seus clientes:

var customers = context.Customers.ToList();

E vamos supor que cada Customerobjeto tenha uma referência ao seu conjunto de Orders, e que cada um Ordertenha referências às LineItemsquais também podem fazer referência a a Product.

Como você pode ver, selecionar um objeto de nível superior com muitas entidades relacionadas pode resultar em uma consulta que precisa obter dados de várias fontes. Como medida de desempenho, Include()permite que você indique quais entidades relacionadas devem ser lidas do banco de dados como parte da mesma consulta.

Usando o mesmo exemplo, isso pode trazer todos os cabeçalhos de pedidos relacionados, mas nenhum dos outros registros:

var customersWithOrderDetail = context.Customers.Include("Orders").ToList();

Como ponto final, já que você solicitou o SQL, a primeira instrução sem Include()poderia gerar uma instrução simples:

SELECT * FROM Customers;

A declaração final que chama Include("Orders")pode ser assim:

SELECT *
FROM Customers JOIN Orders ON Customers.Id = Orders.CustomerId;

Só queria acrescentar que "Incluir" faz parte do carregamento antecipado. Ele é descrito no tutorial do Entity Framework 6 da Microsoft. Aqui está o link: https://docs.microsoft.com/en-us/aspnet/mvc/overview/getting-started/getting-started-with-ef-using-mvc/reading-related-data-with-the -entity-framework-in-an-asp-net-mvc-application

Trecho da página vinculada:

Aqui estão várias maneiras que o Entity Framework pode carregar dados relacionados nas propriedades de navegação de uma entidade:

Carregamento lento.Quando a entidade é lida pela primeira vez, os dados relacionados não são recuperados. No entanto, na primeira vez que você tenta acessar uma propriedade de navegação, os dados necessários para essa propriedade de navegação são recuperados automaticamente. Isso resulta em várias consultas enviadas ao banco de dados - uma para a própria entidade e uma cada vez que os dados relacionados para a entidade devem ser recuperados. A classe DbContext permite o carregamento lento por padrão.

Carregamento ansioso. Quando a entidade é lida, os dados relacionados são recuperados junto com ela. Isso normalmente resulta em uma única consulta de junção que recupera todos os dados necessários. Você especifica o carregamento antecipado usando oInclude método.

Carregamento explícito.Isso é semelhante ao carregamento lento, exceto que você recupera explicitamente os dados relacionados no código; isso não acontece automaticamente quando você acessa uma propriedade de navegação. Você carrega dados relacionados manualmente obtendo a entrada do gerenciador de estado do objeto para uma entidade e chamando o método Collection.Load para coleções ou o método Reference.Load para propriedades que contêm uma única entidade. (No exemplo a seguir, se você quiser carregar a propriedade de navegação do Administrador, substitua Collection(x => x.Courses)por Reference(x => x.Administrator).) Normalmente, você usará o carregamento explícito apenas quando tiver desativado o carregamento lento.

Como eles não recuperam imediatamente os valores da propriedade, o carregamento lento e o carregamento explícito também são conhecidos como carregamento adiado.

Pense nisso como uma aplicação do Eager-Loading em um cenário em que seus subitens seriam de carregamento lento.

O Query EF está enviando para o banco de dados irá render um resultado maior a princípio, mas no acesso nenhuma consulta de acompanhamento será feita ao acessar os itens incluídos.

Por outro lado, sem ele, o EF executaria consultas separadas mais tarde, quando você acessasse os subitens pela primeira vez.