QueryableExtensions.Include Método

Definição

Namespace:

System.Data.Entity

Assembly:

EntityFramework.dll

Sobrecargas

Include(IQueryable, String)	Especifica os objetos relacionados para inclusão nos resultados da consulta.
Include<T,TProperty>(IQueryable<T>, Expression<Func<T,TProperty>>)	Especifica os objetos relacionados para inclusão nos resultados da consulta.
Include<T>(IQueryable<T>, String)	Especifica os objetos relacionados para inclusão nos resultados da consulta.

Include(IQueryable, String)

Especifica os objetos relacionados para inclusão nos resultados da consulta.

public static System.Linq.IQueryable Include (this System.Linq.IQueryable source, string path);

static member Include : System.Linq.IQueryable * string -> System.Linq.IQueryable

<Extension()>
Public Function Include (source As IQueryable, path As String) As IQueryable

Parâmetros

source

IQueryable

A origem IQueryable na qual chamar Include.

path

String

A lista separada por ponto de objetos relacionados a serem retornados nos resultados da consulta.

Retornos

IQueryable

Um novo IQueryable com o caminho da consulta definido.

Comentários

Esse método de extensão chama o método Include(String) do objeto de origem IQueryable , se esse método existir. Se a origem IQueryable não tiver um método correspondente, esse método não fará nada. Todos ObjectQueryos tipos , ObjectSet<TEntity>e DbQueryDbSet têm um método Include apropriado para chamar. Os caminhos são all-inclusive. Por exemplo, se uma chamada de inclusão indicar Include("Orders.OrderLines"), não só OrderLines será incluído, mas também Pedidos. Quando você chama o método Include, o caminho da consulta só é válido na instância retornada do IQueryable. Outras instâncias de IQueryable e o próprio contexto de objeto não são afetados. Como o método Include retorna o objeto de consulta, você pode chamar esse método várias vezes em um IQueryable para especificar vários caminhos para a consulta.

Include<T,TProperty>(IQueryable<T>, Expression<Func<T,TProperty>>)

Especifica os objetos relacionados para inclusão nos resultados da consulta.

[System.Diagnostics.CodeAnalysis.SuppressMessage("Microsoft.Design", "CA1006:DoNotNestGenericTypesInMemberSignatures")]
[System.Diagnostics.CodeAnalysis.SuppressMessage("Microsoft.Design", "CA1011:ConsiderPassingBaseTypesAsParameters")]
public static System.Linq.IQueryable<T> Include<T,TProperty> (this System.Linq.IQueryable<T> source, System.Linq.Expressions.Expression<Func<T,TProperty>> path);

static member Include : System.Linq.IQueryable<'T> * System.Linq.Expressions.Expression<Func<'T, 'Property>> -> System.Linq.IQueryable<'T>

<Extension()>
Public Function Include(Of T, TProperty) (source As IQueryable(Of T), path As Expression(Of Func(Of T, TProperty))) As IQueryable(Of T)

Parâmetros de tipo

T

O tipo de entidade que está sendo consultada.

TProperty

O tipo de propriedade de navegação que está sendo incluída.

Parâmetros

source

IQueryable<T>

O IQueryable de origem no qual chamar Include.

path

Expression<Func<T,TProperty>>

Uma expressão lambda que representa o caminho a ser incluído.

Retornos

IQueryable<T>

Um novo IQueryable<T> com o caminho de consulta definido.

Atributos

SuppressMessageAttribute

Comentários

A expressão de caminho deve ser composta por expressões de acesso de propriedade simples, juntamente com chamadas para Selecionar para redigir inclusões adicionais depois de incluir uma proprty de coleção. Exemplos de possíveis caminhos de inclusão são: para incluir uma única referência: consulta. Include(e => e.Level1Reference) Para incluir uma única coleção: consulta. Include(e => e.Level1Collection) Para incluir uma referência e, em seguida, uma referência um nível abaixo: consulta. Include(e => e.Level1Reference.Level2Reference) Para incluir uma referência e, em seguida, uma coleção um nível abaixo: consulta. Include(e => e.Level1Reference.Level2Collection) Para incluir uma coleção e, em seguida, uma referência de um nível abaixo: consulta. Include(e => e.Level1Collection.Select(l1 => l1. Level2Reference)) Para incluir uma coleção e, em seguida, uma coleção um nível abaixo: consulta. Include(e => e.Level1Collection.Select(l1 => l1. Level2Collection)) Para incluir uma coleção e, em seguida, uma referência de um nível abaixo: consulta. Include(e => e.Level1Collection.Select(l1 => l1. Level2Reference)) Para incluir uma coleção e, em seguida, uma coleção um nível abaixo: consulta. Include(e => e.Level1Collection.Select(l1 => l1. Level2Collection)) Para incluir uma coleção, uma referência e uma referência dois níveis abaixo: consulta. Include(e => e.Level1Collection.Select(l1 => l1. Level2Reference.Level3Reference)) Para incluir uma coleção, uma coleção e uma referência dois níveis abaixo: consulta. Include(e => e.Level1Collection.Select(l1 => l1. Level2Collection.Select(l2 => l2. Level3Reference))) Esse método de extensão chama o método Include(String) do objeto IQueryable de origem, se esse método existir. Se o IQueryable de origem não tiver um método correspondente, esse método não fará nada. Os tipos Entity Framework ObjectQuery, ObjectSet, DbQuery e DbSet têm um método Include apropriado para chamar. Quando você chama o método Include, o caminho de consulta só é válido na instância retornada do T IQueryable<>. Outras instâncias de IQueryable<T> e o contexto do objeto em si não são afetadas. Como o método Include retorna o objeto de consulta, você pode chamar esse método várias vezes em um IQueryable<T> para especificar vários caminhos para a consulta.

Include<T>(IQueryable<T>, String)

Especifica os objetos relacionados para inclusão nos resultados da consulta.

public static System.Linq.IQueryable<T> Include<T> (this System.Linq.IQueryable<T> source, string path);

static member Include : System.Linq.IQueryable<'T> * string -> System.Linq.IQueryable<'T>

<Extension()>
Public Function Include(Of T) (source As IQueryable(Of T), path As String) As IQueryable(Of T)

Parâmetros de tipo

T

O tipo de entidade que está sendo consultada.

Parâmetros

source

IQueryable<T>

A origem IQueryable<T> na qual chamar Include.

path

String

A lista separada por ponto de objetos relacionados a serem retornados nos resultados da consulta.

Retornos

IQueryable<T>

Um novo IQueryable<T> com o caminho da consulta definido.

Comentários

Esse método de extensão chama o método Include(String) do objeto de origem IQueryable<T> , se esse método existir. Se a origem IQueryable<T> não tiver um método correspondente, esse método não fará nada. Todos ObjectQuery<T>os tipos , ObjectSet<TEntity>e DbQuery<TResult>DbSet<TEntity> têm um método Include apropriado para chamar. Os caminhos são all-inclusive. Por exemplo, se uma chamada de inclusão indicar Include("Orders.OrderLines"), não só OrderLines será incluído, mas também Pedidos. Quando você chama o método Include, o caminho da consulta só é válido na instância retornada do IQueryable<T>. Outras instâncias de IQueryable<T> e o próprio contexto de objeto não são afetados. Como o método Include retorna o objeto de consulta, você pode chamar esse método várias vezes em um IQueryable<T> para especificar vários caminhos para a consulta.