QueryableExtensions.Include Yöntem

Tanım

Ad Alanı:

System.Data.Entity

Bütünleştirilmiş Kod:

EntityFramework.dll

Aşırı Yüklemeler

Include(IQueryable, String)	Sorgu sonuçlarına eklenecek ilgili nesneleri belirtir.
Include<T,TProperty>(IQueryable<T>, Expression<Func<T,TProperty>>)	Sorgu sonuçlarına eklenecek ilgili nesneleri belirtir.
Include<T>(IQueryable<T>, String)	Sorgu sonuçlarına eklenecek ilgili nesneleri belirtir.

Include(IQueryable, String)

Sorgu sonuçlarına eklenecek ilgili nesneleri belirtir.

public static System.Linq.IQueryable Include (this System.Linq.IQueryable source, string path);

static member Include : System.Linq.IQueryable * string -> System.Linq.IQueryable

<Extension()>
Public Function Include (source As IQueryable, path As String) As IQueryable

Parametreler

source

IQueryable

Dahil Et'in çağrıldığı kaynak IQueryable .

path

String

Sorgu sonuçlarında döndürülecek ilgili nesnelerin noktayla ayrılmış listesi.

Döndürülenler

IQueryable

Tanımlı sorgu yolunu içeren yeni IQueryable bir.

Açıklamalar

Bu uzantı yöntemi, böyle bir yöntem varsa kaynak IQueryable nesnenin Include(String) yöntemini çağırır. Kaynağın IQueryable eşleşen bir yöntemi yoksa, bu yöntem hiçbir şey yapmaz. , ObjectSet<TEntity>ve DbSet türlerinin tümünün ObjectQueryDbQuery çağıracak uygun bir Include yöntemi vardır. Yollar her şey dahil. Örneğin, bir dahil etme çağrısı Include("Orders.OrderLines") ifadesini gösteriyorsa, yalnızca OrderLine'lar dahil edilmekle kalmaz, aynı zamanda Siparişler de dahil olur. Include yöntemini çağırdığınızda, sorgu yolu yalnızca döndürülen örneğinde IQueryablegeçerlidir. ve nesne bağlamının IQueryable diğer örnekleri etkilenmez. Include yöntemi sorgu nesnesini döndürdüğünden, sorgu için birden çok yol belirtmek üzere bu yöntemi üzerinde IQueryable birden çok kez çağırabilirsiniz.

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

Sorgu sonuçlarına eklenecek ilgili nesneleri belirtir.

[System.Diagnostics.CodeAnalysis.SuppressMessage("Microsoft.Design", "CA1006:DoNotNestGenericTypesInMemberSignatures")]
[System.Diagnostics.CodeAnalysis.SuppressMessage("Microsoft.Design", "CA1011:ConsiderPassingBaseTypesAsParameters")]
public static System.Linq.IQueryable<T> Include<T,TProperty> (this System.Linq.IQueryable<T> source, System.Linq.Expressions.Expression<Func<T,TProperty>> path);

static member Include : System.Linq.IQueryable<'T> * System.Linq.Expressions.Expression<Func<'T, 'Property>> -> System.Linq.IQueryable<'T>

<Extension()>
Public Function Include(Of T, TProperty) (source As IQueryable(Of T), path As Expression(Of Func(Of T, TProperty))) As IQueryable(Of T)

Tür Parametreleri

T

Sorgulanan varlığın türü.

TProperty

Dahil edilen gezinti özelliğinin türü.

Parametreler

source

IQueryable<T>

Include'in çağrıldığı kaynak IQueryable.

path

Expression<Func<T,TProperty>>

Eklenecek yolu temsil eden bir lambda ifadesi.

Döndürülenler

IQueryable<T>

Tanımlı sorgu yoluna sahip yeni bir IQueryable<T> .

Öznitelikler

SuppressMessageAttribute

Açıklamalar

Yol ifadesi, bir koleksiyon alanı ekledikten sonra ek eklemeler oluşturmak için Select çağrısıyla birlikte basit özellik erişim ifadelerinden oluşmalıdır. Olası yollara örnek olarak şunlar verilebilir: Tek bir başvuru eklemek için: sorgu. Include(e => e.Level1Reference) Tek bir koleksiyon eklemek için: query. Include(e => e.Level1Collection) Bir başvuru ve ardından bir düzey aşağı başvuru eklemek için: query. Include(e => e.Level1Reference.Level2Reference) Bir başvuru ve ardından bir düzey aşağı bir koleksiyon eklemek için: query. Include(e => e.Level1Reference.Level2Collection) Bir koleksiyon ve ardından bir düzey aşağı başvuru eklemek için: query. Include(e => e.Level1Collection.Select(l1 => l1. Level2Reference)) Bir koleksiyon ve ardından bir düzey aşağı bir koleksiyon eklemek için: query. Include(e => e.Level1Collection.Select(l1 => l1. Level2Collection)) Bir koleksiyon ve ardından bir düzey aşağı başvuru eklemek için: query. Include(e => e.Level1Collection.Select(l1 => l1. Level2Reference)) Bir koleksiyon ve ardından bir düzey aşağı bir koleksiyon eklemek için: query. Include(e => e.Level1Collection.Select(l1 => l1. Level2Collection)) Koleksiyonu, başvuruyu ve başvuruyu iki düzey aşağı eklemek için: query. Include(e => e.Level1Collection.Select(l1 => l1. Level2Reference.Level3Reference)) Koleksiyonu, koleksiyonu ve başvuruyu iki düzey aşağı eklemek için: query. Include(e => e.Level1Collection.Select(l1 => l1. Level2Collection.Select(l2 => l2. Level3Reference))) Bu uzantı yöntemi, böyle bir yöntem varsa kaynak IQueryable nesnesinin Include(String) yöntemini çağırır. Kaynak IQueryable'ın eşleşen bir yöntemi yoksa, bu yöntem hiçbir şey yapmaz. Entity Framework ObjectQuery, ObjectSet, DbQuery ve DbSet türlerinin tümünün çağıracak uygun bir Include yöntemi vardır. Include yöntemini çağırdığınızda, sorgu yolu yalnızca IQueryable<T'nin> döndürülen örneğinde geçerlidir. Diğer IQueryable<T> örnekleri ve nesne bağlamı etkilenmez. Include yöntemi sorgu nesnesini döndürdüğünden, sorgu için birden çok yol belirtmek üzere bu yöntemi bir IQueryable<T> üzerinde birden çok kez çağırabilirsiniz.

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

Sorgu sonuçlarına eklenecek ilgili nesneleri belirtir.

public static System.Linq.IQueryable<T> Include<T> (this System.Linq.IQueryable<T> source, string path);

static member Include : System.Linq.IQueryable<'T> * string -> System.Linq.IQueryable<'T>

<Extension()>
Public Function Include(Of T) (source As IQueryable(Of T), path As String) As IQueryable(Of T)

Tür Parametreleri

T

Sorgulanan varlığın türü.

Parametreler

source

IQueryable<T>

Dahil Et'in çağrıldığı kaynak IQueryable<T> .

path

String

Sorgu sonuçlarında döndürülecek ilgili nesnelerin noktayla ayrılmış listesi.

Döndürülenler

IQueryable<T>

Tanımlı sorgu yolunu içeren yeni IQueryable<T> bir.

Açıklamalar

Bu uzantı yöntemi, böyle bir yöntem varsa kaynak IQueryable<T> nesnenin Include(String) yöntemini çağırır. Kaynağın IQueryable<T> eşleşen bir yöntemi yoksa, bu yöntem hiçbir şey yapmaz. , ObjectSet<TEntity>ve DbSet<TEntity> türlerinin tümünün ObjectQuery<T>DbQuery<TResult> çağıracak uygun bir Include yöntemi vardır. Yollar her şey dahil. Örneğin, bir dahil etme çağrısı Include("Orders.OrderLines") ifadesini gösteriyorsa, yalnızca OrderLine'lar dahil edilmekle kalmaz, aynı zamanda Siparişler de dahil olur. Include yöntemini çağırdığınızda, sorgu yolu yalnızca döndürülen örneğinde IQueryable<T>geçerlidir. ve nesne bağlamının IQueryable<T> diğer örnekleri etkilenmez. Include yöntemi sorgu nesnesini döndürdüğünden, sorgu için birden çok yol belirtmek üzere bu yöntemi üzerinde IQueryable<T> birden çok kez çağırabilirsiniz.