EntityFrameworkQueryableExtensions.Include Método

Definição

Namespace:

Microsoft.EntityFrameworkCore

Assembly:

Microsoft.EntityFrameworkCore.dll

Pacote:

Microsoft.EntityFrameworkCore v8.0.0

Sobrecargas

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

Especifica entidades relacionadas a serem incluídas nos resultados da consulta. A propriedade de navegação a ser incluída é especificada começando com o tipo de entidade que está sendo consultada (TEntity). Se você quiser incluir tipos adicionais com base nas propriedades de navegação do tipo que está sendo incluído, encadeie uma chamada para ThenInclude<TEntity,TPreviousProperty,TProperty>(IIncludableQueryable<TEntity, IEnumerable<TPreviousProperty>>, Expression<Func<TPreviousProperty, TProperty>>) após essa chamada.

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

Especifica entidades relacionadas a serem incluídas nos resultados da consulta. A propriedade de navegação a ser incluída é especificada começando com o tipo de entidade que está sendo consultada (TEntity). Outras propriedades de navegação a serem incluídas podem ser acrescentadas, separadas pelo caractere '.'.

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

Especifica entidades relacionadas a serem incluídas nos resultados da consulta. A propriedade de navegação a ser incluída é especificada começando com o tipo de entidade que está sendo consultada (TEntity). Se você quiser incluir tipos adicionais com base nas propriedades de navegação do tipo que está sendo incluído, encadeie uma chamada para ThenInclude<TEntity,TPreviousProperty,TProperty>(IIncludableQueryable<TEntity, IEnumerable<TPreviousProperty>>, Expression<Func<TPreviousProperty, TProperty>>) após essa chamada.

public static Microsoft.EntityFrameworkCore.Query.IIncludableQueryable<TEntity,TProperty> Include<TEntity,TProperty> (this System.Linq.IQueryable<TEntity> source, System.Linq.Expressions.Expression<Func<TEntity,TProperty>> navigationPropertyPath) where TEntity : class;

static member Include : System.Linq.IQueryable<'Entity (requires 'Entity : null)> * System.Linq.Expressions.Expression<Func<'Entity, 'Property>> -> Microsoft.EntityFrameworkCore.Query.IIncludableQueryable<'Entity, 'Property (requires 'Entity : null)> (requires 'Entity : null)

<Extension()>
Public Function Include(Of TEntity As Class, TProperty As Class) (source As IQueryable(Of TEntity), navigationPropertyPath As Expression(Of Func(Of TEntity, TProperty))) As IIncludableQueryable(Of TEntity, TProperty)

Parâmetros de tipo

TEntity

O tipo de entidade que está sendo consultada.

TProperty

O tipo da entidade relacionada a ser incluída.

Parâmetros

source

IQueryable<TEntity>

Consulta de fonte.

navigationPropertyPath

Expression<Func<TEntity,TProperty>>

Uma expressão lambda que representa a propriedade de navegação a ser incluída (t => t.Property1).

Retornos

IIncludableQueryable<TEntity,TProperty>

Uma nova consulta com os dados relacionados incluídos.

Exceções

ArgumentNullException

source ou navigationPropertyPath é null.

Exemplos

A consulta a seguir mostra a inclusão de um único nível de entidades relacionadas:

context.Blogs.Include(blog => blog.Posts)

A consulta a seguir mostra a inclusão de dois níveis de entidades no mesmo branch:

context.Blogs
   .Include(blog => blog.Posts).ThenInclude(post => post.Tags)

A consulta a seguir mostra a inclusão de vários níveis e branches de dados relacionados:

context.Blogs
   .Include(blog => blog.Posts).ThenInclude(post => post.Tags).ThenInclude(tag => tag.TagInfo)
   .Include(blog => blog.Contributors)

A consulta a seguir mostra a inclusão de um único nível de entidades relacionadas em um tipo derivado usando a conversão:

context.Blogs.Include(blog => ((SpecialBlog)blog).SpecialPosts)

A consulta a seguir mostra a inclusão de um único nível de entidades relacionadas em um tipo derivado usando o operador 'as':

context.Blogs.Include(blog => (blog as SpecialBlog).SpecialPosts)

Comentários

Consulte Carregando entidades relacionadas para obter mais informações e exemplos.

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

Especifica entidades relacionadas a serem incluídas nos resultados da consulta. A propriedade de navegação a ser incluída é especificada começando com o tipo de entidade que está sendo consultada (TEntity). Outras propriedades de navegação a serem incluídas podem ser acrescentadas, separadas pelo caractere '.'.

public static System.Linq.IQueryable<TEntity> Include<TEntity> (this System.Linq.IQueryable<TEntity> source, string navigationPropertyPath) where TEntity : class;

static member Include : System.Linq.IQueryable<'Entity (requires 'Entity : null)> * string -> System.Linq.IQueryable<'Entity (requires 'Entity : null)> (requires 'Entity : null)

<Extension()>
Public Function Include(Of TEntity As Class) (source As IQueryable(Of TEntity), navigationPropertyPath As String) As IQueryable(Of TEntity)

Parâmetros de tipo

TEntity

O tipo de entidade que está sendo consultada.

Parâmetros

source

IQueryable<TEntity>

Consulta de fonte.

navigationPropertyPath

String

Uma cadeia de caracteres de nomes de propriedade de navegação separados '.' a serem incluídos.

Retornos

IQueryable<TEntity>

Uma nova consulta com os dados relacionados incluídos.

Exceções

ArgumentNullException

source ou navigationPropertyPath é null.

ArgumentException

navigationPropertyPath está vazio ou espaço em branco.

Exemplos

A consulta a seguir mostra a inclusão de um único nível de entidades relacionadas:

context.Blogs.Include("Posts")

A consulta a seguir mostra a inclusão de dois níveis de entidades no mesmo branch:

context.Blogs.Include("Posts.Tags")

A consulta a seguir mostra a inclusão de vários níveis e branches de dados relacionados:

context.Blogs
   .Include("Posts.Tags.TagInfo')
   .Include("Contributors")

Comentários

Consulte Carregando entidades relacionadas para obter mais informações e exemplos.