EntityFrameworkQueryableExtensions.Include Método
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
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 ( |
| 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 ( |
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
Uma nova consulta com os dados relacionados incluídos.
Exceções
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.
Aplica-se a
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
Uma nova consulta com os dados relacionados incluídos.
Exceções
source ou navigationPropertyPath é null.
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.
Aplica-se a
Entity Framework