EntityFrameworkQueryableExtensions.Include Methode

Definition

Namespace:

Microsoft.EntityFrameworkCore

Assembly:

Microsoft.EntityFrameworkCore.dll

Paket:

Microsoft.EntityFrameworkCore v8.0.0

Ü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 (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.

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 ".".

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

IIncludableQueryable<TEntity,TProperty>

Eine neue Abfrage mit den zugehörigen Daten.

Ausnahmen

ArgumentNullException

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 .

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

IQueryable<TEntity>

Eine neue Abfrage mit den zugehörigen Daten.

Ausnahmen

ArgumentNullException

source oder navigationPropertyPath ist null.

ArgumentException

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 .