EntityFrameworkQueryableExtensions.Include Méthode

Définition

Espace de noms:

Microsoft.EntityFrameworkCore

Assembly:

Microsoft.EntityFrameworkCore.dll

Paquet:

Microsoft.EntityFrameworkCore v8.0.0

Surcharges

Include<TEntity,TProperty>(IQueryable<TEntity>, Expression<Func<TEntity,TProperty>>)

Spécifie les entités associées à inclure dans les résultats de la requête. La propriété de navigation à inclure est spécifiée à partir du type d’entité interrogée (TEntity). Si vous souhaitez inclure des types supplémentaires en fonction des propriétés de navigation du type inclus, chaînez un appel à ThenInclude<TEntity,TPreviousProperty,TProperty>(IIncludableQueryable<TEntity, IEnumerable<TPreviousProperty>>, Expression<Func<TPreviousProperty, TProperty>>) après cet appel.

Include<TEntity>(IQueryable<TEntity>, String)

Spécifie les entités associées à inclure dans les résultats de la requête. La propriété de navigation à inclure est spécifiée à partir du type d’entité interrogée (TEntity). D’autres propriétés de navigation à inclure peuvent être ajoutées, séparées par le caractère « . ».

Include<TEntity,TProperty>(IQueryable<TEntity>, Expression<Func<TEntity,TProperty>>)

Spécifie les entités associées à inclure dans les résultats de la requête. La propriété de navigation à inclure est spécifiée à partir du type d’entité interrogée (TEntity). Si vous souhaitez inclure des types supplémentaires en fonction des propriétés de navigation du type inclus, chaînez un appel à ThenInclude<TEntity,TPreviousProperty,TProperty>(IIncludableQueryable<TEntity, IEnumerable<TPreviousProperty>>, Expression<Func<TPreviousProperty, TProperty>>) après cet appel.

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)

Paramètres de type

TEntity

Type d’entité interrogée.

TProperty

Type de l’entité associée à inclure.

Paramètres

source

IQueryable<TEntity>

Requête source

navigationPropertyPath

Expression<Func<TEntity,TProperty>>

Expression lambda représentant la propriété de navigation à inclure (t => t.Property1).

Retours

IIncludableQueryable<TEntity,TProperty>

Nouvelle requête avec les données associées incluses.

Exceptions

ArgumentNullException

source ou navigationPropertyPath est null.

Exemples

La requête suivante montre l’inclusion d’un seul niveau d’entités associées :

context.Blogs.Include(blog => blog.Posts)

La requête suivante montre l’inclusion de deux niveaux d’entités sur la même branche :

context.Blogs
   .Include(blog => blog.Posts).ThenInclude(post => post.Tags)

La requête suivante montre l’inclusion de plusieurs niveaux et branches de données associées :

context.Blogs
   .Include(blog => blog.Posts).ThenInclude(post => post.Tags).ThenInclude(tag => tag.TagInfo)
   .Include(blog => blog.Contributors)

La requête suivante montre l’inclusion d’un seul niveau d’entités associées sur un type dérivé à l’aide du cast :

context.Blogs.Include(blog => ((SpecialBlog)blog).SpecialPosts)

La requête suivante montre l’inclusion d’un seul niveau d’entités associées sur un type dérivé à l’aide de l’opérateur « as » :

context.Blogs.Include(blog => (blog as SpecialBlog).SpecialPosts)

Remarques

Pour plus d’informations et d’exemples, consultez Chargement d’entités associées .

Include<TEntity>(IQueryable<TEntity>, String)

Spécifie les entités associées à inclure dans les résultats de la requête. La propriété de navigation à inclure est spécifiée à partir du type d’entité interrogée (TEntity). D’autres propriétés de navigation à inclure peuvent être ajoutées, séparées par le caractère « . ».

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)

Paramètres de type

TEntity

Type d’entité interrogée.

Paramètres

source

IQueryable<TEntity>

Requête source

navigationPropertyPath

String

Chaîne de noms de propriétés de navigation séparées « . » à inclure.

Retours

IQueryable<TEntity>

Nouvelle requête avec les données associées incluses.

Exceptions

ArgumentNullException

source ou navigationPropertyPath est null.

ArgumentException

navigationPropertyPath est vide ou blanc.

Exemples

La requête suivante montre l’inclusion d’un seul niveau d’entités associées :

context.Blogs.Include("Posts")

La requête suivante montre l’inclusion de deux niveaux d’entités sur la même branche :

context.Blogs.Include("Posts.Tags")

La requête suivante montre l’inclusion de plusieurs niveaux et branches de données associées :

context.Blogs
   .Include("Posts.Tags.TagInfo')
   .Include("Contributors")

Remarques

Pour plus d’informations et d’exemples, consultez Chargement d’entités associées .