EntityFrameworkQueryableExtensions.Include Metoda

Definice

Obor názvů:

Microsoft.EntityFrameworkCore

Sestavení:

Microsoft.EntityFrameworkCore.dll

Balíček:

Microsoft.EntityFrameworkCore v10.0.0

Přetížení

Název	Description
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á se má zahrnout, se zadává počínaje typem dotazované entity (TEntity). Pokud chcete zahrnout další typy založené na navigačních vlastnostech zahrnutého typu, zřetězte volání ThenInclude<TEntity,TPreviousProperty,TProperty>(IIncludableQueryable<TEntity, IEnumerable<TPreviousProperty>>, Expression<Func<TPreviousProperty, TProperty>>) 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á se má zahrnout, se zadává počínaje typem dotazované entity (TEntity). Další vlastnosti navigace, které mají být zahrnuty, lze připojit, oddělené znakem ".".

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

Zdroj:

EntityFrameworkQueryableExtensions.cs

Určuje související entity, které se mají zahrnout do výsledků dotazu. Vlastnost navigace, která se má zahrnout, se zadává počínaje typem dotazované entity (TEntity). Pokud chcete zahrnout další typy založené na navigačních vlastnostech zahrnutého typu, zřetězte volání ThenInclude<TEntity,TPreviousProperty,TProperty>(IIncludableQueryable<TEntity, IEnumerable<TPreviousProperty>>, Expression<Func<TPreviousProperty, TProperty>>) 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í navigační vlastnost, která se má zahrnout (t => t.Property1).

Návraty

IIncludableQueryable<TEntity,TProperty>

Nový dotaz se zahrnutými 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, že ve stejné větvi jsou dvě úrovně entit:

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

Následující dotaz ukazuje, včetně více ú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)

Zdroj:

EntityFrameworkQueryableExtensions.cs

Určuje související entity, které se mají zahrnout do výsledků dotazu. Vlastnost navigace, která se má zahrnout, se zadává počínaje typem dotazované entity (TEntity). Další vlastnosti navigace, které mají být zahrnuty, lze připojit, oddělené 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ázvy navigačních vlastností, které mají být zahrnuty.

Návraty

IQueryable<TEntity>

Nový dotaz se zahrnutými souvisejícími daty.

Výjimky

ArgumentNullException

source nebo navigationPropertyPath je null.

ArgumentException

navigationPropertyPath je prázdné nebo prázdné znaky.

Příklady

Následující dotaz ukazuje, že obsahuje jednu úroveň souvisejících entit:

context.Blogs.Include("Posts")

Následující dotaz ukazuje, že ve stejné větvi jsou dvě úrovně entit:

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

Následující dotaz ukazuje, včetně více ú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 .