QueryableExtensions.Include Método

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

Retornos

Um novo IQueryable com o caminho de 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. ObjectSet<TEntity> DbSet DbQuery Todos ObjectQueryos tipos 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 apenas 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 do IQueryable contexto de 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 para especificar vários caminhos para a 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

Parâmetros

Retornos

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 a Select para compor incluiçõ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 de 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 da consulta só é válido na instância retornada do T> IQueryable<. Outras instâncias de IQueryable<T> e o contexto de 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 T> IQueryable<para especificar vários caminhos para a 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

Parâmetros

Retornos

Um novo IQueryable<T> com o caminho de 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. ObjectSet<TEntity> DbSet<TEntity> DbQuery<TResult> Todos ObjectQuery<T>os tipos 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 apenas 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 do IQueryable<T> contexto de 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.