EntityFrameworkQueryableExtensions.Include Metoda

Definice

Obor názvů:

Microsoft.EntityFrameworkCore

Sestavení:

Microsoft.EntityFrameworkCore.dll

Balíček:

Microsoft.EntityFrameworkCore v8.0.0

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 (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í.

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 ..

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

IIncludableQueryable<TEntity,TProperty>

Nový dotaz se souvisejícími daty.

Výjimky

ArgumentNullException

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 .

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

IQueryable<TEntity>

Nový dotaz se souvisejícími daty.

Výjimky

ArgumentNullException

source nebo navigationPropertyPath je null.

ArgumentException

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 .