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
| Include<TEntity,TProperty>(IQueryable<TEntity>, Expression<Func<TEntity,TProperty>>) |
Gibt verwandte Entitäten an, die in die Abfrageergebnisse einbezogen werden sollen. Die einzudingde 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 einzudingde 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 einzudingde Navigationseigenschaft wird beginnend mit dem Typ der abgefragten Entität (TEntity) angegeben. Wenn Sie zusätzliche Typen basierend auf den Navigationseigenschaften des eingeschlossenen Typs einschließen möchten, verketten Sie einen Aufruf an ThenInclude<TEntity,TPreviousProperty,TProperty>(IIncludableQueryable<TEntity,
IEnumerable<TPreviousProperty>>, Expression<Func<TPreviousProperty,
TProperty>>) nach diesem Aufruf.
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 abgefragten Entität.
- TProperty
Der Typ der verknüpften Entität, die eingeschlossen werden soll.
Parameter
- source
- IQueryable<TEntity>
Die Quellabfrage.
- navigationPropertyPath
- Expression<Func<TEntity,TProperty>>
Ein Lambdaausdruck, der die navigationseigenschaft darstellt, die eingeschlossen werden soll (t => t.Property1).
Gibt zurück
Eine neue Abfrage mit den zugehörigen Daten.
Ausnahmen
source oder navigationPropertyPath ist null.
Beispiele
Die folgende Abfrage zeigt, dass eine einzelne Ebene verwandter Entitäten enthalten ist:
context.Blogs.Include(blog => blog.Posts)
Die folgende Abfrage zeigt, dass zwei Entitätsebenen in derselben Verzweigung enthalten sind:
context.Blogs
.Include(blog => blog.Posts).ThenInclude(post => post.Tags)
Die folgende Abfrage zeigt, dass mehrere Ebenen und Verzweigungen verwandter Daten enthalten sind:
context.Blogs
.Include(blog => blog.Posts).ThenInclude(post => post.Tags).ThenInclude(tag => tag.TagInfo)
.Include(blog => blog.Contributors)
Die folgende Abfrage zeigt das Einschließen einer einzelnen Ebene verwandter Entitäten für einen abgeleiteten Typ mithilfe der Umwandlung:
context.Blogs.Include(blog => ((SpecialBlog)blog).SpecialPosts)
Die folgende Abfrage zeigt, dass eine einzelne Ebene von verknüpften Entitäten für einen abgeleiteten Typ mithilfe des "as"-Operators 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 einzudingde Navigationseigenschaft wird beginnend mit dem Typ der abgefragten Entität (TEntity) angegeben. Weitere einzuzufügende Navigationseigenschaften können angefügt werden, getrennt durch das Zeichen ".".
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 abgefragten Entität.
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 zugehörigen Daten.
Ausnahmen
source oder navigationPropertyPath ist null.
navigationPropertyPath ist leer oder leer.
Beispiele
Die folgende Abfrage zeigt, dass eine einzelne Ebene verwandter Entitäten enthalten ist:
context.Blogs.Include("Posts")
Die folgende Abfrage zeigt, dass zwei Entitätsebenen in derselben Verzweigung enthalten sind:
context.Blogs.Include("Posts.Tags")
Die folgende Abfrage zeigt, dass mehrere Ebenen und Verzweigungen verwandter Daten enthalten sind:
context.Blogs
.Include("Posts.Tags.TagInfo')
.Include("Contributors")
Hinweise
Weitere Informationen und Beispiele finden Sie unter Laden verwandter Entitäten .
Gilt für:
Entity Framework