QueryableExtensions.Include Methode

Definition

Namespace:

System.Data.Entity

Assembly:

EntityFramework.dll

Überlädt

Include(IQueryable, String)	Gibt die verbundenen Objekte an, die in die Abfrageergebnisse eingeschlossen werden sollen.
Include<T,TProperty>(IQueryable<T>, Expression<Func<T,TProperty>>)	Gibt die verbundenen Objekte an, die in die Abfrageergebnisse eingeschlossen werden sollen.
Include<T>(IQueryable<T>, String)	Gibt die verbundenen Objekte an, die in die Abfrageergebnisse eingeschlossen werden sollen.

Include(IQueryable, String)

Gibt die verbundenen Objekte an, die in die Abfrageergebnisse eingeschlossen werden sollen.

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

Parameter

source

IQueryable

Die Quelle IQueryable , für die Include aufgerufen werden soll.

path

String

Die durch Punkte getrennte Liste verbundener Objekte, die in den Abfrageergebnissen zurückgegeben werden sollen.

Gibt zurück

IQueryable

Eine neue IQueryable mit dem definierten Abfragepfad.

Hinweise

Diese Erweiterungsmethode ruft die Include(String)-Methode des Quellobjekts IQueryable auf, wenn eine solche Methode vorhanden ist. Wenn die Quelle IQueryable keine übereinstimmende Methode hat, führt diese Methode nichts aus. Die ObjectQueryTypen , ObjectSet<TEntity>und DbSetDbQuery verfügen alle über eine geeignete Include-Methode zum Aufrufen. Pfade sind allumfassend. Wenn beispielsweise ein Include-Aufruf auf Include ("Orders.OrderLines") hinweist, wird nicht nur OrderLines, sondern auch Orders eingeschlossen. Wenn Sie die Include-Methode aufrufen, ist der Abfragepfad nur für die zurückgegebene instance von IQueryablegültig. Andere Instanzen von IQueryable und der Objektkontext selbst werden nicht beeinflusst. Da die Include-Methode das Abfrageobjekt zurückgibt, können Sie diese Methode mehrmals für eine aufrufen, IQueryable um mehrere Pfade für die Abfrage anzugeben.

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

Gibt die verbundenen Objekte an, die in die Abfrageergebnisse eingeschlossen werden sollen.

[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)

Typparameter

T

Der Typ der abgefragten Entität.

TProperty

Der Typ der enthaltenen Navigationseigenschaft.

Parameter

source

IQueryable<T>

Das Quell-IQueryable, für das Include aufgerufen werden soll.

path

Expression<Func<T,TProperty>>

Ein Lambdaausdruck, der den einzuschließenden Pfad darstellt.

Gibt zurück

IQueryable<T>

Ein neues IQueryable<T> mit dem definierten Abfragepfad.

Attribute

SuppressMessageAttribute

Hinweise

Der Pfadausdruck muss aus einfachen Eigenschaftenzugriffsausdrücken zusammen mit Aufrufen von Select zum Komponieren zusätzlicher Includes bestehen, nachdem eine Sammlungseigenschaft eingeschlossen wurde. Beispiele für mögliche Includepfade sind: So schließen Sie einen einzelnen Verweis ein: abfrage. Include(e => e.Level1Reference) So schließen Sie eine einzelne Sammlung ein: query. Include(e => e.Level1Collection) Um einen Verweis und dann einen Verweis um eine Ebene nach unten einzuschließen: Abfrage. Include(e => e.Level1Reference.Level2Reference) So schließen Sie einen Verweis und dann eine Sammlung eine Ebene nach unten ein: Abfrage. Include(e => e.Level1Reference.Level2Collection) So schließen Sie eine Auflistung und dann einen Verweis eine Ebene nach unten ein: Abfrage. Include(e => e.Level1Collection.Select(l1 => l1. Level2Reference)) So schließen Sie eine Auflistung und dann eine Auflistung eine Ebene nach unten ein: Abfrage. Include(e => e.Level1Collection.Select(l1 => l1. Level2Collection)) Um eine Auflistung und dann einen Verweis um eine Ebene nach unten einzuschließen: Abfrage. Include(e => e.Level1Collection.Select(l1 => l1. Level2Reference)) So schließen Sie eine Auflistung und dann eine Auflistung eine Ebene nach unten ein: Abfrage. Include(e => e.Level1Collection.Select(l1 => l1. Level2Collection)) Um eine Auflistung, einen Verweis und einen Verweis auf zwei Ebenen nach unten einzuschließen: Abfrage. Include(e => e.Level1Collection.Select(l1 => l1. Level2Reference.Level3Reference)) Um eine Auflistung, eine Auflistung und einen Verweis auf zwei Ebenen nach unten einzuschließen: Abfrage. Include(e => e.Level1Collection.Select(l1 => l1. Level2Collection.Select(l2 => l2. Level3Reference))) Diese Erweiterungsmethode ruft die Include(String)-Methode des IQueryable-Quellobjekts auf, wenn eine solche Methode vorhanden ist. Wenn das Quell-IQueryable über keine übereinstimmende Methode verfügt, führt diese Methode keine Aktion aus. Die Entity Framework-Typen ObjectQuery, ObjectSet, DbQuery und DbSet verfügen alle über eine geeignete Include-Methode zum Aufrufen. Wenn Sie die Include-Methode aufrufen, ist der Abfragepfad nur für die zurückgegebene instance des IQueryable<T> gültig. Andere Instanzen von IQueryable<T> und der Objektkontext selbst sind nicht betroffen. Da die Include-Methode das Abfrageobjekt zurückgibt, können Sie diese Methode mehrmals für ein IQueryable<T> aufrufen, um mehrere Pfade für die Abfrage anzugeben.

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

Gibt die verbundenen Objekte an, die in die Abfrageergebnisse eingeschlossen werden sollen.

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)

Typparameter

T

Der Typ der abgefragten Entität.

Parameter

source

IQueryable<T>

Die Quelle IQueryable<T> , für die Include aufgerufen werden soll.

path

String

Die durch Punkte getrennte Liste verbundener Objekte, die in den Abfrageergebnissen zurückgegeben werden sollen.

Gibt zurück

IQueryable<T>

Eine neue IQueryable<T> mit dem definierten Abfragepfad.

Hinweise

Diese Erweiterungsmethode ruft die Include(String)-Methode des Quellobjekts IQueryable<T> auf, wenn eine solche Methode vorhanden ist. Wenn die Quelle IQueryable<T> keine übereinstimmende Methode hat, führt diese Methode nichts aus. Die ObjectQuery<T>Typen , ObjectSet<TEntity>und DbSet<TEntity>DbQuery<TResult> verfügen alle über eine geeignete Include-Methode zum Aufrufen. Pfade sind allumfassend. Wenn beispielsweise ein Include-Aufruf auf Include ("Orders.OrderLines") hinweist, wird nicht nur OrderLines, sondern auch Orders eingeschlossen. Wenn Sie die Include-Methode aufrufen, ist der Abfragepfad nur für die zurückgegebene instance von IQueryable<T>gültig. Andere Instanzen von IQueryable<T> und der Objektkontext selbst werden nicht beeinflusst. Da die Include-Methode das Abfrageobjekt zurückgibt, können Sie diese Methode mehrmals für eine aufrufen, IQueryable<T> um mehrere Pfade für die Abfrage anzugeben.