EntityFrameworkQueryableExtensions.Include Metodo

Definizione

Spazio dei nomi:

Microsoft.EntityFrameworkCore

Assembly:

Microsoft.EntityFrameworkCore.dll

Pacchetto:

Microsoft.EntityFrameworkCore v8.0.0

Overload

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

Specifica le entità correlate da includere nei risultati della query. La proprietà di navigazione da includere viene specificata a partire dal tipo di entità su cui viene eseguita la query (TEntity). Se si desidera includere tipi aggiuntivi in base alle proprietà di navigazione del tipo da includere, concatenare una chiamata a ThenInclude<TEntity,TPreviousProperty,TProperty>(IIncludableQueryable<TEntity, IEnumerable<TPreviousProperty>>, Expression<Func<TPreviousProperty, TProperty>>) dopo questa chiamata.

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

Specifica le entità correlate da includere nei risultati della query. La proprietà di navigazione da includere viene specificata a partire dal tipo di entità su cui viene eseguita la query (TEntity). È possibile aggiungere altre proprietà di navigazione, separate dal carattere '.'.

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

Specifica le entità correlate da includere nei risultati della query. La proprietà di navigazione da includere viene specificata a partire dal tipo di entità su cui viene eseguita la query (TEntity). Se si desidera includere tipi aggiuntivi in base alle proprietà di navigazione del tipo da includere, concatenare una chiamata a ThenInclude<TEntity,TPreviousProperty,TProperty>(IIncludableQueryable<TEntity, IEnumerable<TPreviousProperty>>, Expression<Func<TPreviousProperty, TProperty>>) dopo questa chiamata.

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)

Parametri di tipo

TEntity

Tipo di entità su cui viene eseguito la query.

TProperty

Tipo dell'entità correlata da includere.

Parametri

source

IQueryable<TEntity>

Query di origine.

navigationPropertyPath

Expression<Func<TEntity,TProperty>>

Espressione lambda che rappresenta la proprietà di navigazione da includere (t => t.Property1).

Restituisce

IIncludableQueryable<TEntity,TProperty>

Nuova query con i dati correlati inclusi.

Eccezioni

ArgumentNullException

source o navigationPropertyPath è null.

Esempio

La query seguente mostra l'inclusione di un singolo livello di entità correlate:

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

La query seguente illustra l'inclusione di due livelli di entità nello stesso ramo:

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

La query seguente illustra l'inclusione di più livelli e rami di dati correlati:

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

La query seguente mostra l'inclusione di un singolo livello di entità correlate in un tipo derivato usando il cast:

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

La query seguente mostra l'inclusione di un singolo livello di entità correlate in un tipo derivato usando l'operatore 'as':

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

Commenti

Per altre informazioni ed esempi, vedere Caricamento di entità correlate .

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

Specifica le entità correlate da includere nei risultati della query. La proprietà di navigazione da includere viene specificata a partire dal tipo di entità su cui viene eseguita la query (TEntity). È possibile aggiungere altre proprietà di navigazione, separate dal carattere '.'.

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)

Parametri di tipo

TEntity

Tipo di entità su cui viene eseguito la query.

Parametri

source

IQueryable<TEntity>

Query di origine.

navigationPropertyPath

String

Stringa di nomi di proprietà di navigazione separati da includere.

Restituisce

IQueryable<TEntity>

Nuova query con i dati correlati inclusi.

Eccezioni

ArgumentNullException

source o navigationPropertyPath è null.

ArgumentException

navigationPropertyPath è vuoto o vuoto.

Esempio

La query seguente mostra l'inclusione di un singolo livello di entità correlate:

context.Blogs.Include("Posts")

La query seguente illustra l'inclusione di due livelli di entità nello stesso ramo:

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

La query seguente illustra l'inclusione di più livelli e rami di dati correlati:

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

Commenti

Per altre informazioni ed esempi, vedere Caricamento di entità correlate .