QueryableExtensions.Include Methode
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Überlädt
| Name | Beschreibung |
|---|---|
| Include(IQueryable, String) |
Gibt die verknüpften Objekte an, die in die Abfrageergebnisse einbezogen werden sollen. |
| Include<T,TProperty>(IQueryable<T>, Expression<Func<T,TProperty>>) |
Gibt die verknüpften Objekte an, die in die Abfrageergebnisse einbezogen werden sollen. |
| Include<T>(IQueryable<T>, String) |
Gibt die verknüpften Objekte an, die in die Abfrageergebnisse einbezogen werden sollen. |
Include(IQueryable, String)
Gibt die verknüpften Objekte an, die in die Abfrageergebnisse einbezogen 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 punkttrennte Liste verwandter Objekte, die in den Abfrageergebnissen zurückgegeben werden sollen.
Gibt zurück
Ein Neues 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 ObjectQuery, ObjectSet<TEntity>und DbQueryDbSet typen verfügen alle über eine geeignete Include-Methode, die aufgerufen werden soll. Pfade sind alle inklusiven. Wenn beispielsweise ein Include-Aufruf "Include("Orders.OrderLines") angibt, werden "OrderLines" nicht nur "OrderLines" eingeschlossen, sondern auch "Orders". Wenn Sie die Include-Methode aufrufen, ist der Abfragepfad nur für die zurückgegebene Instanz der IQueryable. Andere Instanzen und IQueryable der Objektkontext selbst sind nicht betroffen. Da die Include-Methode das Abfrageobjekt zurückgibt, können Sie diese Methode mehrmals für eine IQueryable Abfrage aufrufen, um mehrere Pfade für die Abfrage anzugeben.
Gilt für:
Include<T,TProperty>(IQueryable<T>, Expression<Func<T,TProperty>>)
Gibt die verknüpften Objekte an, die in die Abfrageergebnisse einbezogen 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 entität, die abgefragt wird.
- TProperty
Der Typ der enthaltenen Navigationseigenschaft.
Parameter
- source
- IQueryable<T>
Die Quelle IQueryable, für die Include aufgerufen werden soll.
- path
- Expression<Func<T,TProperty>>
Ein Lambda-Ausdruck, der den einzuschließden Pfad darstellt.
Gibt zurück
Ein neues IQueryable<T> mit dem definierten Abfragepfad.
- Attribute
Hinweise
Der Pfadausdruck muss aus einfachen Eigenschaftszugriffsausdrücken zusammen mit Aufrufen von Select zum Verfassen zusätzlicher Elemente 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) To include a single collection: query. Include(e => e.Level1Collection) To include a reference and then a reference one level down: query. Include(e => e.Level1Reference.Level2Reference) To include a reference and then a collection one level down: query. Include(e => e.Level1Reference.Level2Collection) To include a collection and then a reference one level down: query. Include(e => e.Level1Collection.Select(l1 => l1. Level2Reference)) To include a collection and then a collection one level down: query. Include(e => e.Level1Collection.Select(l1 => l1. Level2Collection)) So fügen Sie eine Auflistung und dann einen Verweis auf eine Ebene nach unten ein: Abfrage. Include(e => e.Level1Collection.Select(l1 => l1. Level2Reference)) To include a collection and then a collection one level down: query. Include(e => e.Level1Collection.Select(l1 => l1. Level2Collection)) So schließen Sie eine Auflistung, einen Verweis und einen Verweis auf zwei Ebenen nach unten ein: Abfrage. Include(e => e.Level1Collection.Select(l1 => l1. Level2Reference.Level3Reference)) So fügen Sie eine Auflistung, eine Auflistung und einen Verweis auf zwei Ebenen nach unten ein: 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 die IQueryable-Quelle keine übereinstimmende Methode hat, führt diese Methode nichts aus. Die Typen Entity Framework ObjectQuery, ObjectSet, DbQuery und DbSet weisen alle eine geeignete Include-Methode auf, die aufgerufen werden soll. Wenn Sie die Include-Methode aufrufen, ist der Abfragepfad nur für die zurückgegebene Instanz 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 in einem IQueryable<T> mehrmals aufrufen, um mehrere Pfade für die Abfrage anzugeben.
Gilt für:
Include<T>(IQueryable<T>, String)
Gibt die verknüpften Objekte an, die in die Abfrageergebnisse einbezogen 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 entität, die abgefragt wird.
Parameter
- source
- IQueryable<T>
Die Quelle IQueryable<T> , für die Include aufgerufen werden soll.
- path
- String
Die punkttrennte Liste verwandter Objekte, die in den Abfrageergebnissen zurückgegeben werden sollen.
Gibt zurück
Ein Neues 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>, ObjectSet<TEntity>und DbQuery<TResult>DbSet<TEntity> typen verfügen alle über eine geeignete Include-Methode, die aufgerufen werden soll. Pfade sind alle inklusiven. Wenn beispielsweise ein Include-Aufruf "Include("Orders.OrderLines") angibt, werden "OrderLines" nicht nur "OrderLines" eingeschlossen, sondern auch "Orders". Wenn Sie die Include-Methode aufrufen, ist der Abfragepfad nur für die zurückgegebene Instanz der IQueryable<T>. Andere Instanzen und IQueryable<T> der Objektkontext selbst sind nicht betroffen. Da die Include-Methode das Abfrageobjekt zurückgibt, können Sie diese Methode mehrmals für eine IQueryable<T> Abfrage aufrufen, um mehrere Pfade für die Abfrage anzugeben.