EntityFrameworkQueryableExtensions.Include Yöntem

Tanım

Ad Alanı:

Microsoft.EntityFrameworkCore

Bütünleştirilmiş Kod:

Microsoft.EntityFrameworkCore.dll

Paket:

Microsoft.EntityFrameworkCore v8.0.0

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

IIncludableQueryable<TEntity,TProperty>

İlgili verilerin dahil olduğu yeni bir sorgu.

Özel durumlar

ArgumentNullException

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 .

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

ArgumentNullException

source veya navigationPropertyPath şeklindedir null.

ArgumentException

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 .