EntityFrameworkQueryableExtensions.Include Metode

Definisi

Ruang nama:

Microsoft.EntityFrameworkCore

Rakitan:

Microsoft.EntityFrameworkCore.dll

Paket:

Microsoft.EntityFrameworkCore v8.0.0

Overload

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

Menentukan entitas terkait untuk disertakan dalam hasil kueri. Properti navigasi yang akan disertakan ditentukan dimulai dengan jenis entitas yang dikueri (TEntity). Jika Anda ingin menyertakan jenis tambahan berdasarkan properti navigasi jenis yang disertakan, maka sambungkan panggilan ke ThenInclude<TEntity,TPreviousProperty,TProperty>(IIncludableQueryable<TEntity, IEnumerable<TPreviousProperty>>, Expression<Func<TPreviousProperty, TProperty>>) setelah panggilan ini.

Include<TEntity>(IQueryable<TEntity>, String)

Menentukan entitas terkait untuk disertakan dalam hasil kueri. Properti navigasi yang akan disertakan ditentukan dimulai dengan jenis entitas yang dikueri (TEntity). Properti navigasi lebih lanjut yang akan disertakan dapat ditambahkan, dipisahkan oleh karakter '.'.

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

Menentukan entitas terkait untuk disertakan dalam hasil kueri. Properti navigasi yang akan disertakan ditentukan dimulai dengan jenis entitas yang dikueri (TEntity). Jika Anda ingin menyertakan jenis tambahan berdasarkan properti navigasi jenis yang disertakan, maka sambungkan panggilan ke ThenInclude<TEntity,TPreviousProperty,TProperty>(IIncludableQueryable<TEntity, IEnumerable<TPreviousProperty>>, Expression<Func<TPreviousProperty, TProperty>>) setelah panggilan ini.

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)

Jenis parameter

TEntity

Jenis entitas yang sedang dikueri.

TProperty

Jenis entitas terkait yang akan disertakan.

Parameter

source

IQueryable<TEntity>

Kueri sumber.

navigationPropertyPath

Expression<Func<TEntity,TProperty>>

Ekspresi lambda yang mewakili properti navigasi yang akan disertakan (t => t.Property1).

Mengembalikan

IIncludableQueryable<TEntity,TProperty>

Kueri baru dengan data terkait disertakan.

Pengecualian

ArgumentNullException

source atau navigationPropertyPath adalah null.

Contoh

Kueri berikut ini memperlihatkan termasuk satu tingkat entitas terkait:

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

Kueri berikut ini memperlihatkan termasuk dua tingkat entitas pada cabang yang sama:

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

Kueri berikut ini memperlihatkan termasuk beberapa tingkat dan cabang data terkait:

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

Kueri berikut ini memperlihatkan termasuk satu tingkat entitas terkait pada jenis turunan menggunakan transmisi:

context.Blogs.Include(blog => ((SpecialBlog)blog).SpecialPosts)

Kueri berikut ini memperlihatkan termasuk satu tingkat entitas terkait pada jenis turunan menggunakan operator 'sebagai':

context.Blogs.Include(blog => (blog as SpecialBlog).SpecialPosts)

Keterangan

Lihat Memuat entitas terkait untuk informasi dan contoh selengkapnya.

Include<TEntity>(IQueryable<TEntity>, String)

Menentukan entitas terkait untuk disertakan dalam hasil kueri. Properti navigasi yang akan disertakan ditentukan dimulai dengan jenis entitas yang dikueri (TEntity). Properti navigasi lebih lanjut yang akan disertakan dapat ditambahkan, dipisahkan oleh karakter '.'.

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)

Jenis parameter

TEntity

Jenis entitas yang sedang dikueri.

Parameter

source

IQueryable<TEntity>

Kueri sumber.

navigationPropertyPath

String

String nama properti navigasi yang dipisahkan '.' akan disertakan.

Mengembalikan

IQueryable<TEntity>

Kueri baru dengan data terkait disertakan.

Pengecualian

ArgumentNullException

source atau navigationPropertyPath adalah null.

ArgumentException

navigationPropertyPath kosong atau spasi kosong.

Contoh

Kueri berikut ini memperlihatkan termasuk satu tingkat entitas terkait:

context.Blogs.Include("Posts")

Kueri berikut ini memperlihatkan termasuk dua tingkat entitas pada cabang yang sama:

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

Kueri berikut ini memperlihatkan termasuk beberapa tingkat dan cabang data terkait:

context.Blogs
   .Include("Posts.Tags.TagInfo')
   .Include("Contributors")

Keterangan

Lihat Memuat entitas terkait untuk informasi dan contoh selengkapnya.