QueryableExtensions.Include Méthode

Définition

Espace de noms:

System.Data.Entity

Assembly:

EntityFramework.dll

Surcharges

Include(IQueryable, String)	Spécifie les objets connexes à inclure dans les résultats de la requête.
Include<T,TProperty>(IQueryable<T>, Expression<Func<T,TProperty>>)	Spécifie les objets connexes à inclure dans les résultats de la requête.
Include<T>(IQueryable<T>, String)	Spécifie les objets connexes à inclure dans les résultats de la requête.

Include(IQueryable, String)

Spécifie les objets connexes à inclure dans les résultats de la requête.

public static System.Linq.IQueryable Include (this System.Linq.IQueryable source, string path);

static member Include : System.Linq.IQueryable * string -> System.Linq.IQueryable

<Extension()>
Public Function Include (source As IQueryable, path As String) As IQueryable

Paramètres

source

IQueryable

Source IQueryable sur laquelle appeler Include.

path

String

Liste d'objets connexes, séparés par des points, à retourner dans les résultats de la requête.

Retours

IQueryable

Nouvel objet IQueryable avec le chemin d’accès de requête défini.

Remarques

Cette méthode d’extension appelle la méthode Include(String) de l’objet source IQueryable , si une telle méthode existe. Si la source IQueryable n’a pas de méthode correspondante, cette méthode ne fait rien. Les ObjectQuerytypes , DbQueryObjectSet<TEntity>et DbSet ont tous une méthode Include appropriée à appeler. Les chemins d’accès sont entièrement inclusifs. Par exemple, si un appel d’inclusion indique Include(« Orders.OrderLines »), les lignes de commandes seront non seulement incluses, mais également les commandes. Lorsque vous appelez la méthode Include, le chemin de requête est valide uniquement sur le instance retourné du IQueryable. Les autres instances de IQueryable et le contexte d'objet lui-même ne sont pas affectés. Étant donné que la méthode Include retourne l’objet de requête, vous pouvez appeler cette méthode plusieurs fois sur un IQueryable pour spécifier plusieurs chemins d’accès pour la requête.

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

Spécifie les objets connexes à inclure dans les résultats de la requête.

[System.Diagnostics.CodeAnalysis.SuppressMessage("Microsoft.Design", "CA1006:DoNotNestGenericTypesInMemberSignatures")]
[System.Diagnostics.CodeAnalysis.SuppressMessage("Microsoft.Design", "CA1011:ConsiderPassingBaseTypesAsParameters")]
public static System.Linq.IQueryable<T> Include<T,TProperty> (this System.Linq.IQueryable<T> source, System.Linq.Expressions.Expression<Func<T,TProperty>> path);

static member Include : System.Linq.IQueryable<'T> * System.Linq.Expressions.Expression<Func<'T, 'Property>> -> System.Linq.IQueryable<'T>

<Extension()>
Public Function Include(Of T, TProperty) (source As IQueryable(Of T), path As Expression(Of Func(Of T, TProperty))) As IQueryable(Of T)

Paramètres de type

T

Type d’entité interrogée.

TProperty

Type de propriété de navigation inclus.

Paramètres

source

IQueryable<T>

IQueryable source sur lequel appeler Include.

path

Expression<Func<T,TProperty>>

Expression lambda qui représente le chemin d'accès à inclure.

Retours

IQueryable<T>

Nouveau T IQueryable<> avec le chemin de requête défini.

Attributs

SuppressMessageAttribute

Remarques

L’expression de chemin d’accès doit être composée d’expressions d’accès à la propriété simples ainsi que d’appels à Sélectionner pour composer des incluts supplémentaires après avoir inclus une propriété de collection. Voici quelques exemples de chemins d’accès include possibles : pour inclure une seule référence : requête. Include(e => e.Level1Reference) Pour inclure une seule collection : requête. Include(e => e.Level1Collection) Pour inclure une référence, puis une référence de niveau inférieur : requête. Include(e => e.Level1Reference.Level2Reference) Pour inclure une référence, puis une collection un niveau vers le bas : requête. Include(e => e.Level1Reference.Level2Collection) Pour inclure une collection, puis une référence d’un niveau inférieur : requête. Include(e => e.Level1Collection.Select(l1 => l1). Level2Reference)) Pour inclure une collection, puis une collection un niveau inférieur : requête. Include(e => e.Level1Collection.Select(l1 => l1). Level2Collection)) Pour inclure une collection, puis une référence d’un niveau inférieur : requête. Include(e => e.Level1Collection.Select(l1 => l1). Level2Reference)) Pour inclure une collection, puis une collection un niveau inférieur : requête. Include(e => e.Level1Collection.Select(l1 => l1). Level2Collection)) Pour inclure une collection, une référence et une référence à deux niveaux vers le bas : requête. Include(e => e.Level1Collection.Select(l1 => l1). Level2Reference.Level3Reference)) Pour inclure une collection, une collection et une référence à deux niveaux vers le bas : requête. Include(e => e.Level1Collection.Select(l1 => l1). Level2Collection.Select(l2 => l2. Level3Reference))) Cette méthode d’extension appelle la méthode Include(String) de l’objet IQueryable source, si une telle méthode existe. Si le IQueryable source n'a pas de méthode correspondante, cette méthode n'exécute aucune action. Les types Entity Framework ObjectQuery, ObjectSet, DbQuery et DbSet ont tous une méthode Include appropriée à appeler. Lorsque vous appelez la méthode Include, le chemin de requête est valide uniquement sur le instance retourné du T> IQueryable<. Les autres instances de IQueryable<T> et le contexte d’objet lui-même ne sont pas affectés. Étant donné que la méthode Include retourne l’objet de requête, vous pouvez appeler cette méthode plusieurs fois sur un IQueryable<T> pour spécifier plusieurs chemins d’accès pour la requête.

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

Spécifie les objets connexes à inclure dans les résultats de la requête.

public static System.Linq.IQueryable<T> Include<T> (this System.Linq.IQueryable<T> source, string path);

static member Include : System.Linq.IQueryable<'T> * string -> System.Linq.IQueryable<'T>

<Extension()>
Public Function Include(Of T) (source As IQueryable(Of T), path As String) As IQueryable(Of T)

Paramètres de type

T

Type d’entité interrogée.

Paramètres

source

IQueryable<T>

Source IQueryable<T> sur laquelle appeler Include.

path

String

Liste d'objets connexes, séparés par des points, à retourner dans les résultats de la requête.

Retours

IQueryable<T>

Nouvel objet IQueryable<T> avec le chemin d’accès de requête défini.

Remarques

Cette méthode d’extension appelle la méthode Include(String) de l’objet source IQueryable<T> , si une telle méthode existe. Si la source IQueryable<T> n’a pas de méthode correspondante, cette méthode ne fait rien. Les ObjectQuery<T>types , DbQuery<TResult>ObjectSet<TEntity>et DbSet<TEntity> ont tous une méthode Include appropriée à appeler. Les chemins d’accès sont entièrement inclusifs. Par exemple, si un appel d’inclusion indique Include(« Orders.OrderLines »), les lignes de commandes seront non seulement incluses, mais également les commandes. Lorsque vous appelez la méthode Include, le chemin de requête est valide uniquement sur le instance retourné du IQueryable<T>. Les autres instances de IQueryable<T> et le contexte d'objet lui-même ne sont pas affectés. Étant donné que la méthode Include retourne l’objet de requête, vous pouvez appeler cette méthode plusieurs fois sur un IQueryable<T> pour spécifier plusieurs chemins d’accès pour la requête.