EntityFrameworkQueryableExtensions.Include Metoda
Definice
Důležité
Některé informace platí pro předběžně vydaný produkt, který se může zásadně změnit, než ho výrobce nebo autor vydá. Microsoft neposkytuje žádné záruky, výslovné ani předpokládané, týkající se zde uváděných informací.
Přetížení
| Include<TEntity,TProperty>(IQueryable<TEntity>, Expression<Func<TEntity,TProperty>>) |
Určuje související entity, které se mají zahrnout do výsledků dotazu. Vlastnost navigace, která má být zahrnuta, je určena počínaje typem dotazované entity ( |
| Include<TEntity>(IQueryable<TEntity>, String) |
Určuje související entity, které se mají zahrnout do výsledků dotazu. Vlastnost navigace, která má být zahrnuta, je určena počínaje typem dotazované entity ( |
Include<TEntity,TProperty>(IQueryable<TEntity>, Expression<Func<TEntity,TProperty>>)
Určuje související entity, které se mají zahrnout do výsledků dotazu. Vlastnost navigace, která má být zahrnuta, je určena počínaje typem dotazované entity (TEntity). Pokud chcete zahrnout další typy založené na navigačních vlastnostech zahrnutého typu, zřetězte ThenInclude<TEntity,TPreviousProperty,TProperty>(IIncludableQueryable<TEntity,
IEnumerable<TPreviousProperty>>, Expression<Func<TPreviousProperty,
TProperty>>) volání po tomto volání.
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)Parametry typu
- TEntity
Typ dotazované entity.
- TProperty
Typ související entity, která se má zahrnout.
Parametry
- source
- IQueryable<TEntity>
Zdrojový dotaz.
- navigationPropertyPath
- Expression<Func<TEntity,TProperty>>
Výraz lambda představující vlastnost navigace, která se má zahrnout (t => t.Property1).
Návraty
Nový dotaz se souvisejícími daty.
Výjimky
source nebo navigationPropertyPath je null.
Příklady
Následující dotaz ukazuje, že obsahuje jednu úroveň souvisejících entit:
context.Blogs.Include(blog => blog.Posts)
Následující dotaz ukazuje dvě úrovně entit ve stejné větvi:
context.Blogs
.Include(blog => blog.Posts).ThenInclude(post => post.Tags)
Následující dotaz ukazuje, včetně několika úrovní a větví souvisejících dat:
context.Blogs
.Include(blog => blog.Posts).ThenInclude(post => post.Tags).ThenInclude(tag => tag.TagInfo)
.Include(blog => blog.Contributors)
Následující dotaz ukazuje zahrnutí jedné úrovně souvisejících entit na odvozený typ pomocí přetypování:
context.Blogs.Include(blog => ((SpecialBlog)blog).SpecialPosts)
Následující dotaz ukazuje zahrnutí jedné úrovně souvisejících entit na odvozený typ pomocí operátoru as:
context.Blogs.Include(blog => (blog as SpecialBlog).SpecialPosts)
Poznámky
Další informace a příklady najdete v tématu Načítání souvisejících entit .
Platí pro
Include<TEntity>(IQueryable<TEntity>, String)
Určuje související entity, které se mají zahrnout do výsledků dotazu. Vlastnost navigace, která má být zahrnuta, je určena počínaje typem dotazované entity (TEntity). Další navigační vlastnosti, které se mají zahrnout, lze připojit a oddělit je znakem ..
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)Parametry typu
- TEntity
Typ dotazované entity.
Parametry
- source
- IQueryable<TEntity>
Zdrojový dotaz.
- navigationPropertyPath
- String
Řetězec "." oddělených názvů navigačních vlastností, které mají být zahrnuty.
Návraty
Nový dotaz se souvisejícími daty.
Výjimky
source nebo navigationPropertyPath je null.
navigationPropertyPath je prázdný nebo prázdný.
Příklady
Následující dotaz ukazuje, že obsahuje jednu úroveň souvisejících entit:
context.Blogs.Include("Posts")
Následující dotaz ukazuje dvě úrovně entit ve stejné větvi:
context.Blogs.Include("Posts.Tags")
Následující dotaz ukazuje, včetně několika úrovní a větví souvisejících dat:
context.Blogs
.Include("Posts.Tags.TagInfo')
.Include("Contributors")
Poznámky
Další informace a příklady najdete v tématu Načítání souvisejících entit .
Platí pro
Entity Framework