EntityFrameworkQueryableExtensions.ThenInclude メソッド

  • リファレンス

定義

名前空間:
Microsoft.EntityFrameworkCore
アセンブリ:
Microsoft.EntityFrameworkCore.dll
パッケージ:
Microsoft.EntityFrameworkCore v1.0.6
パッケージ:
Microsoft.EntityFrameworkCore v1.1.6
パッケージ:
Microsoft.EntityFrameworkCore v2.0.3
パッケージ:
Microsoft.EntityFrameworkCore v2.1.11
パッケージ:
Microsoft.EntityFrameworkCore v2.2.6
パッケージ:
Microsoft.EntityFrameworkCore v3.0.0
パッケージ:
Microsoft.EntityFrameworkCore v3.1.0
パッケージ:
Microsoft.EntityFrameworkCore v5.0.0
パッケージ:
Microsoft.EntityFrameworkCore v6.0.0
パッケージ:
Microsoft.EntityFrameworkCore v7.0.0
パッケージ:
Microsoft.EntityFrameworkCore v8.0.0

オーバーロード

ThenInclude<TEntity,TPreviousProperty,TProperty>(IIncludableQueryable<TEntity,TPreviousProperty>, Expression<Func<TPreviousProperty,TProperty>>)

含めたばかりの関連する型に基づいて、さらに含める追加の関連データを指定します。
ThenInclude<TEntity,TPreviousProperty,TProperty>(IIncludableQueryable<TEntity, IEnumerable<TPreviousProperty>>, Expression<Func<TPreviousProperty, TProperty>>)

含めたばかりの関連する型に基づいて、さらに含める追加の関連データを指定します。
ThenInclude<TEntity,TPreviousProperty,TProperty>(IIncludableQueryable<TEntity, ICollection<TPreviousProperty>>, Expression<Func<TPreviousProperty, TProperty>>)

含めたばかりの関連する型に基づいて、さらに含める追加の関連データを指定します。

ThenInclude<TEntity,TPreviousProperty,TProperty>(IIncludableQueryable<TEntity,TPreviousProperty>, Expression<Func<TPreviousProperty,TProperty>>)

含めたばかりの関連する型に基づいて、さらに含める追加の関連データを指定します。

public static Microsoft.EntityFrameworkCore.Query.IIncludableQueryable<TEntity,TProperty> ThenInclude<TEntity,TPreviousProperty,TProperty> (this Microsoft.EntityFrameworkCore.Query.IIncludableQueryable<TEntity,TPreviousProperty> source, System.Linq.Expressions.Expression<Func<TPreviousProperty,TProperty>> navigationPropertyPath) where TEntity : class;
static member ThenInclude : Microsoft.EntityFrameworkCore.Query.IIncludableQueryable<'Entity, 'PreviousProperty (requires 'Entity : null)> * System.Linq.Expressions.Expression<Func<'PreviousProperty, 'Property>> -> Microsoft.EntityFrameworkCore.Query.IIncludableQueryable<'Entity, 'Property (requires 'Entity : null)> (requires 'Entity : null)
<Extension()>
Public Function ThenInclude(Of TEntity As Class, TPreviousProperty As Class, TProperty As Class) (source As IIncludableQueryable(Of TEntity, TPreviousProperty), navigationPropertyPath As Expression(Of Func(Of TPreviousProperty, TProperty))) As IIncludableQueryable(Of TEntity, TProperty)

型パラメーター

TEntity

クエリ対象のエンティティの種類。

TPreviousProperty

含めたばかりのエンティティの型。

TProperty

含める関連エンティティの型。

パラメーター

source
IIncludableQueryable<TEntity,TPreviousProperty>

ソース クエリです。

navigationPropertyPath
Expression<Func<TPreviousProperty,TProperty>>

含めるナビゲーション プロパティを表すラムダ式 (t => t.Property1)。

戻り値

IIncludableQueryable<TEntity,TProperty>

関連データを含む新しいクエリ。

例

次のクエリは、1 つのレベルの関連エンティティを含めて示しています。

context.Blogs.Include(blog => blog.Posts)

次のクエリは、同じブランチに 2 つのレベルのエンティティを含めて示しています。

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

次のクエリは、関連データの複数のレベルとブランチを含むを示しています。

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

次のクエリは、2 つのレベルのエンティティを同じブランチに含め、2 つ目は派生型に存在するエンティティを示しています。

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

次のクエリは、同じブランチ上の 2 つのレベルのエンティティを含み、2 つ目は代替メソッドを使用して派生型上にあることを示しています。

context.Blogs.Include(blog => blog.Posts).ThenInclude(post => (post as SpecialPost).SpecialTags)

注釈

詳細と例については、「 関連エンティティの読み込み 」を参照してください。

適用対象

ThenInclude<TEntity,TPreviousProperty,TProperty>(IIncludableQueryable<TEntity, IEnumerable<TPreviousProperty>>, Expression<Func<TPreviousProperty, TProperty>>)

含めたばかりの関連する型に基づいて、さらに含める追加の関連データを指定します。

public static Microsoft.EntityFrameworkCore.Query.IIncludableQueryable<TEntity,TProperty> ThenInclude<TEntity,TPreviousProperty,TProperty> (this Microsoft.EntityFrameworkCore.Query.IIncludableQueryable<TEntity,System.Collections.Generic.IEnumerable<TPreviousProperty>> source, System.Linq.Expressions.Expression<Func<TPreviousProperty,TProperty>> navigationPropertyPath) where TEntity : class;
static member ThenInclude : Microsoft.EntityFrameworkCore.Query.IIncludableQueryable<'Entity, seq<'PreviousProperty> (requires 'Entity : null)> * System.Linq.Expressions.Expression<Func<'PreviousProperty, 'Property>> -> Microsoft.EntityFrameworkCore.Query.IIncludableQueryable<'Entity, 'Property (requires 'Entity : null)> (requires 'Entity : null)
<Extension()>
Public Function ThenInclude(Of TEntity As Class, TPreviousProperty As Class, TProperty As Class) (source As IIncludableQueryable(Of TEntity, IEnumerable(Of TPreviousProperty)), navigationPropertyPath As Expression(Of Func(Of TPreviousProperty, TProperty))) As IIncludableQueryable(Of TEntity, TProperty)

型パラメーター

TEntity

クエリ対象のエンティティの種類。

TPreviousProperty

含めたばかりのエンティティの型。

TProperty

含める関連エンティティの型。

パラメーター

source
IIncludableQueryable<TEntity,IEnumerable<TPreviousProperty>>

ソース クエリです。

navigationPropertyPath
Expression<Func<TPreviousProperty,TProperty>>

含めるナビゲーション プロパティを表すラムダ式 (t => t.Property1)。

戻り値

IIncludableQueryable<TEntity,TProperty>

関連データを含む新しいクエリ。

例

次のクエリは、1 つのレベルの関連エンティティを含めて示しています。

context.Blogs.Include(blog => blog.Posts)

次のクエリは、同じブランチに 2 つのレベルのエンティティを含めて示しています。

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

次のクエリは、関連データの複数のレベルとブランチを含むを示しています。

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

次のクエリは、同じブランチ上の 2 つのレベルのエンティティを含み、2 つ目はキャストを使用して派生型に存在するエンティティを示しています。

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

次のクエリは、2 つのレベルのエンティティを同じブランチに含め、2 つ目は 演算子を使用して as 派生型上にあることを示しています。

context.Blogs.Include(blog => blog.Posts).ThenInclude(post => (post as SpecialPost).SpecialTags)

注釈

詳細と例については、「 関連エンティティの読み込み 」を参照してください。

適用対象

ThenInclude<TEntity,TPreviousProperty,TProperty>(IIncludableQueryable<TEntity, ICollection<TPreviousProperty>>, Expression<Func<TPreviousProperty, TProperty>>)

含めたばかりの関連する型に基づいて、さらに含める追加の関連データを指定します。

public static Microsoft.EntityFrameworkCore.Query.IIncludableQueryable<TEntity,TProperty> ThenInclude<TEntity,TPreviousProperty,TProperty> (this Microsoft.EntityFrameworkCore.Query.IIncludableQueryable<TEntity,System.Collections.Generic.ICollection<TPreviousProperty>> source, System.Linq.Expressions.Expression<Func<TPreviousProperty,TProperty>> navigationPropertyPath) where TEntity : class;
static member ThenInclude : Microsoft.EntityFrameworkCore.Query.IIncludableQueryable<'Entity, System.Collections.Generic.ICollection<'PreviousProperty> (requires 'Entity : null)> * System.Linq.Expressions.Expression<Func<'PreviousProperty, 'Property>> -> Microsoft.EntityFrameworkCore.Query.IIncludableQueryable<'Entity, 'Property (requires 'Entity : null)> (requires 'Entity : null)
<Extension()>
Public Function ThenInclude(Of TEntity As Class, TPreviousProperty As Class, TProperty As Class) (source As IIncludableQueryable(Of TEntity, ICollection(Of TPreviousProperty)), navigationPropertyPath As Expression(Of Func(Of TPreviousProperty, TProperty))) As IIncludableQueryable(Of TEntity, TProperty)

型パラメーター

TEntity

クエリ対象のエンティティの種類。

TPreviousProperty

含めたばかりのエンティティの型。

TProperty

含める関連エンティティの型。

パラメーター

source
IIncludableQueryable<TEntity,ICollection<TPreviousProperty>>

ソース クエリです。

navigationPropertyPath
Expression<Func<TPreviousProperty,TProperty>>

含めるナビゲーション プロパティを表すラムダ式 (t => t.Property1)。

戻り値

IIncludableQueryable<TEntity,TProperty>

関連データを含む新しいクエリ。

例

次のクエリは、1 つのレベルの関連エンティティを含めて示しています。 

context.Blogs.Include(blog => blog.Posts);

次のクエリは、同じブランチに 2 つのレベルのエンティティを含めて示しています。 

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

次のクエリは、関連データの複数のレベルとブランチを含む方法を示しています。 

context.Blogs
    .Include(blog => blog.Posts).ThenInclude(post => post.Tags).ThenInclude(tag => tag.TagInfo)
    .Include(blog => blog.Contributors);

適用対象