EntityFrameworkQueryableExtensions.Include Yöntem

Tanım

Aşırı Yüklemeler

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

Sorgu sonuçlarına eklenecek ilgili varlıkları belirtir. Dahil edilecek gezinti özelliği sorgulanan varlığın türüyle (TEntity) başlayarak belirtilir. Dahil edilen türün gezinti özelliklerine göre ek türler eklemek istiyorsanız, bu çağrıdan sonra çağrısı zincirleyin ThenInclude<TEntity,TPreviousProperty,TProperty>(IIncludableQueryable<TEntity, IEnumerable<TPreviousProperty>>, Expression<Func<TPreviousProperty, TProperty>>) .

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

Sorgu sonuçlarına eklenecek ilgili varlıkları belirtir. Dahil edilecek gezinti özelliği sorgulanan varlığın türüyle (TEntity) başlayarak belirtilir. Eklenecek diğer gezinti özellikleri '.' karakteriyle ayrılarak eklenebilir.

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

Sorgu sonuçlarına eklenecek ilgili varlıkları belirtir. Dahil edilecek gezinti özelliği sorgulanan varlığın türüyle (TEntity) başlayarak belirtilir. Dahil edilen türün gezinti özelliklerine göre ek türler eklemek istiyorsanız, bu çağrıdan sonra çağrısı zincirleyin ThenInclude<TEntity,TPreviousProperty,TProperty>(IIncludableQueryable<TEntity, IEnumerable<TPreviousProperty>>, Expression<Func<TPreviousProperty, TProperty>>) .

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)

Tür Parametreleri

TEntity

Sorgulanan varlığın türü.

TProperty

Dahil edilecek ilgili varlığın türü.

Parametreler

source
IQueryable<TEntity>

Kaynak sorgu.

navigationPropertyPath
Expression<Func<TEntity,TProperty>>

Dahil edilecek gezinti özelliğini temsil eden bir lambda ifadesi (t => t.Property1).

Döndürülenler

İlgili verilerin dahil olduğu yeni bir sorgu.

Özel durumlar

source veya navigationPropertyPath şeklindedir null.

Örnekler

Aşağıdaki sorgu, ilgili varlıkların tek bir düzeyinin dahil olduğunu gösterir:

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

Aşağıdaki sorgu, aynı daldaki iki varlık düzeyinin dahil olduğunu gösterir:

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

Aşağıdaki sorgu, ilgili verilerin birden çok düzeyini ve dalını içerir:

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

Aşağıdaki sorgu, türetilmiş bir türdeki ilgili varlıkların tek bir düzeyinin türetilmesi kullanılarak dahil edildiği gösterir:

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

Aşağıdaki sorgu, 'as' işleci kullanılarak türetilmiş bir türdeki tek bir ilişkili varlık düzeyinin dahil olduğunu gösterir:

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

Açıklamalar

Daha fazla bilgi ve örnek için bkz . İlgili varlıkları yükleme .

Şunlara uygulanır

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

Sorgu sonuçlarına eklenecek ilgili varlıkları belirtir. Dahil edilecek gezinti özelliği sorgulanan varlığın türüyle (TEntity) başlayarak belirtilir. Eklenecek diğer gezinti özellikleri '.' karakteriyle ayrılarak eklenebilir.

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)

Tür Parametreleri

TEntity

Sorgulanan varlığın türü.

Parametreler

source
IQueryable<TEntity>

Kaynak sorgu.

navigationPropertyPath
String

Eklenecek '.' ayrılmış gezinti özelliği adlarından oluşan bir dize.

Döndürülenler

IQueryable<TEntity>

İlgili verilerin dahil olduğu yeni bir sorgu.

Özel durumlar

source veya navigationPropertyPath şeklindedir null.

navigationPropertyPath boş veya boşluk.

Örnekler

Aşağıdaki sorgu, ilgili varlıkların tek bir düzeyinin dahil olduğunu gösterir:

context.Blogs.Include("Posts")

Aşağıdaki sorgu, aynı daldaki iki varlık düzeyinin dahil olduğunu gösterir:

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

Aşağıdaki sorgu, ilgili verilerin birden çok düzeyini ve dalını içerir:

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

Açıklamalar

Daha fazla bilgi ve örnek için bkz . İlgili varlıkları yükleme .

Şunlara uygulanır