EntityFrameworkQueryableExtensions.Include Yöntem

Tanım

Aşırı Yüklemeler

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

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

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

Sorgu sonuçlarına dahil edilecek ilgili varlıkları belirtir. Dahil edilecek gezinti özelliği, sorgulanan varlık türü () ile başlayarak belirtilmiştir TEntity . Dahil edilecek daha fazla gezinti özelliği, '. ' karakteriyle ayrılarak eklenebilir.

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

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

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ık 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

IIncludableQueryable<TEntity,TProperty>

İlgili veriler dahil yeni bir sorgu.

Özel durumlar

source ya navigationPropertyPath da null .

Örnekler

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

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

Aşağıdaki sorgu, aynı dalda iki varlık düzeyi dahil göstermektedir:

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

Aşağıdaki sorgu, ilgili verilerin birden çok düzeyini ve dalını dahil göstermektedir:

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

Aşağıdaki sorgu, atama kullanılarak türetilmiş bir tür üzerinde tek düzeyli ilgili varlıkların dahil olduğunu gösterir:

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

Aşağıdaki sorgu, ' As ' işleci kullanılarak türetilmiş bir tür üzerinde tek düzeyli ilgili varlıkların dahil olduğunu gösterir:

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

Açıklamalar

Daha fazla bilgi için bkz. ilgili varlıkları yükleme .

Şunlara uygulanır

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

Sorgu sonuçlarına dahil edilecek ilgili varlıkları belirtir. Dahil edilecek gezinti özelliği, sorgulanan varlık türü () ile başlayarak belirtilmiştir TEntity . Dahil edilecek daha fazla gezinti özelliği, '. ' 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ık türü.

Parametreler

source
IQueryable<TEntity>

Kaynak sorgu.

navigationPropertyPath
String

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

Döndürülenler

IQueryable<TEntity>

İlgili veriler dahil yeni bir sorgu.

Özel durumlar

source ya navigationPropertyPath da null .

navigationPropertyPath boş veya boşluk.

Örnekler

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

context.Blogs.Include("Posts")

Aşağıdaki sorgu, aynı dalda iki varlık düzeyi dahil göstermektedir:

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

Aşağıdaki sorgu, ilgili verilerin birden çok düzeyini ve dalını dahil göstermektedir:

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

Açıklamalar

Daha fazla bilgi için bkz. ilgili varlıkları yükleme .

Şunlara uygulanır