EntityFrameworkQueryableExtensions.Include Metodo
Definizione
Importante
Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.
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 ( |
| 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 ( |
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
Nuova query con i dati correlati inclusi.
Eccezioni
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 .
Si applica a
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
Nuova query con i dati correlati inclusi.
Eccezioni
source o navigationPropertyPath è null.
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 .
