EntityFrameworkQueryableExtensions.Include Méthode
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
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 ( |
| 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 ( |
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
Nouvelle requête avec les données associées incluses.
Exceptions
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 .
S’applique à
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
Nouvelle requête avec les données associées incluses.
Exceptions
source ou navigationPropertyPath est null.
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 .
