EntityFrameworkQueryableExtensions.Include Metodo

Definizione

Spazio dei nomi:

Microsoft.EntityFrameworkCore

Assembly:

Microsoft.EntityFrameworkCore.dll

Pacchetto:

Microsoft.EntityFrameworkCore v10.0.0

Overload

Nome	Descrizione
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 una query (TEntity). Se si desidera includere tipi aggiuntivi in base alle proprietà di navigazione del tipo incluso, 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 una query (TEntity). È possibile aggiungere altre proprietà di spostamento, separate dal carattere '.'.

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

Origine:

EntityFrameworkQueryableExtensions.cs

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 una query (TEntity). Se si desidera includere tipi aggiuntivi in base alle proprietà di navigazione del tipo incluso, 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 eseguire una 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).

Valori restituiti

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 mostra due livelli di entità nello stesso ramo:

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

La query seguente mostra 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)

Origine:

EntityFrameworkQueryableExtensions.cs

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 una query (TEntity). È possibile aggiungere altre proprietà di spostamento, 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 eseguire una query.

Parametri

source

IQueryable<TEntity>

Query di origine.

navigationPropertyPath

String

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

Valori restituiti

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 mostra due livelli di entità nello stesso ramo:

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

La query seguente mostra 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 .