EntityFrameworkQueryableExtensions.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<TEntity,TProperty>(IQueryable<TEntity>, Expression<Func<TEntity,TProperty>>) |
Gibt verwandte Entitäten an, die in die Abfrageergebnisse einbezogen werden sollen. Die einzuzugebende Navigationseigenschaft wird beginnend mit dem Typ der abgefragten Entität ( |
| Include<TEntity>(IQueryable<TEntity>, String) |
Gibt verwandte Entitäten an, die in die Abfrageergebnisse einbezogen werden sollen. Die einzuzugebende Navigationseigenschaft wird beginnend mit dem Typ der abgefragten Entität ( |
Include<TEntity,TProperty>(IQueryable<TEntity>, Expression<Func<TEntity,TProperty>>)
Gibt verwandte Entitäten an, die in die Abfrageergebnisse einbezogen werden sollen. Die einzuzugebende Navigationseigenschaft wird beginnend mit dem Typ der abgefragten Entität (TEntity) angegeben. Wenn Sie zusätzliche Typen basierend auf den Navigationseigenschaften des typs einbeziehen möchten, verketten Sie einen Aufruf nach diesem Aufruf 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)Typparameter
- TEntity
Der Typ der entität, die abgefragt wird.
- TProperty
Der Typ der verknüpften Entität, die einbezogen werden soll.
Parameter
- source
- IQueryable<TEntity>
Die Quellabfrage.
- navigationPropertyPath
- Expression<Func<TEntity,TProperty>>
Ein Lambda-Ausdruck, der die zu enthaltende Navigationseigenschaft darstellt (t => t.Property1).
Gibt zurück
Eine neue Abfrage mit den enthaltenen verknüpften Daten.
Ausnahmen
source oder navigationPropertyPath ist null.
Beispiele
Die folgende Abfrage zeigt, dass eine einzelne Ebene verwandter Entitäten eingeschlossen wird:
context.Blogs.Include(blog => blog.Posts)
Die folgende Abfrage zeigt, wie zwei Entitätsebenen in derselben Verzweigung eingeschlossen werden:
context.Blogs
.Include(blog => blog.Posts).ThenInclude(post => post.Tags)
Die folgende Abfrage zeigt, wie mehrere Ebenen und Verzweigungen verwandter Daten eingeschlossen werden:
context.Blogs
.Include(blog => blog.Posts).ThenInclude(post => post.Tags).ThenInclude(tag => tag.TagInfo)
.Include(blog => blog.Contributors)
Die folgende Abfrage zeigt, wie eine einzelne Ebene verwandter Entitäten in einem abgeleiteten Typ mithilfe von Umwandlungen eingeschlossen wird:
context.Blogs.Include(blog => ((SpecialBlog)blog).SpecialPosts)
Die folgende Abfrage zeigt, wie eine einzelne Ebene verwandter Entitäten für einen abgeleiteten Typ mithilfe des Operators "as" eingeschlossen wird:
context.Blogs.Include(blog => (blog as SpecialBlog).SpecialPosts)
Hinweise
Weitere Informationen und Beispiele finden Sie unter Laden verwandter Entitäten .
Gilt für:
Include<TEntity>(IQueryable<TEntity>, String)
Gibt verwandte Entitäten an, die in die Abfrageergebnisse einbezogen werden sollen. Die einzuzugebende Navigationseigenschaft wird beginnend mit dem Typ der abgefragten Entität (TEntity) angegeben. Weitere einzuzufügende Navigationseigenschaften können durch das Zeichen "." getrennt angefügt werden.
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)Typparameter
- TEntity
Der Typ der entität, die abgefragt wird.
Parameter
- source
- IQueryable<TEntity>
Die Quellabfrage.
- navigationPropertyPath
- String
Eine Zeichenfolge mit getrennten Navigationseigenschaftennamen, die eingeschlossen werden sollen.
Gibt zurück
Eine neue Abfrage mit den enthaltenen verknüpften Daten.
Ausnahmen
source oder navigationPropertyPath ist null.
navigationPropertyPath ist leer oder Leerzeichen.
Beispiele
Die folgende Abfrage zeigt, dass eine einzelne Ebene verwandter Entitäten eingeschlossen wird:
context.Blogs.Include("Posts")
Die folgende Abfrage zeigt, wie zwei Entitätsebenen in derselben Verzweigung eingeschlossen werden:
context.Blogs.Include("Posts.Tags")
Die folgende Abfrage zeigt, wie mehrere Ebenen und Verzweigungen verwandter Daten eingeschlossen werden:
context.Blogs
.Include("Posts.Tags.TagInfo')
.Include("Contributors")
Hinweise
Weitere Informationen und Beispiele finden Sie unter Laden verwandter Entitäten .
