QueryableExtensions.Include Methode

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

Gibt zurück

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.

[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

Parameter

Gibt zurück

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.

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

Parameter

Gibt zurück

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.