QueryableExtensions.Include<T>, méthode (IQueryable<T>, String)
[Cette page concerne Entity Framework version 6. La dernière version est disponible sous le nom de package 'Entity Framework' NuGet. Pour plus d'informations sur Entity Framework, consultez msdn.com/data/ef.]
Spécifie les objets connexes à inclure dans les résultats de la requête.
Espace de noms : System.Data.Entity
Assembly : EntityFramework (dans EntityFramework.dll)
Syntaxe
'Déclaration
<ExtensionAttribute> _
Public Shared Function Include(Of T) ( _
source As IQueryable(Of T), _
path As String _
) As IQueryable(Of T)
'Utilisation
Dim source As IQueryable(Of T)
Dim path As String
Dim returnValue As IQueryable(Of T)
returnValue = source.Include(path)
public static IQueryable<T> Include<T>(
this IQueryable<T> source,
string path
)
[ExtensionAttribute]
public:
generic<typename T>
static IQueryable<T>^ Include(
IQueryable<T>^ source,
String^ path
)
static member Include :
source:IQueryable<'T> *
path:string -> IQueryable<'T>
JScript does not support generic types and methods.
Paramètres de type
- T
Type de l'entité interrogée.
Paramètres
- source
Type : System.Linq.IQueryable<T>
IQueryable<T>source sur lequel appeler Include.
- path
Type : System.String
Liste d'objets connexes, séparés par des points, à retourner dans les résultats de la requête.
Valeur de retour
Type : System.Linq.IQueryable<T>
Nouvel objet IQueryable<T> avec le chemin d'accès de requête défini.
Remarque sur l'utilisation
En Visual Basic et C#, vous pouvez appeler cette méthode comme une méthode d'instance sur n'importe quel objet de type IQueryable<T>. Lorsque vous utilisez la syntaxe des méthodes d'instance pour appeler cette méthode, omettez le premier paramètre. Pour plus d'informations, consultez https://msdn.microsoft.com/fr-fr/library/bb384936(v=vs.113) ou https://msdn.microsoft.com/fr-fr/library/bb383977(v=vs.113).
Notes
Cette méthode d'extension appelle la méthode Include(String) de l'objet IQueryable<T> source, si une telle méthode existe. Si le IQueryable<T> source n'a pas de méthode correspondante, cette méthode n'exécute aucune action. Les types ObjectQuery<T>, ObjectSet<TEntity>, DbQuery<TResult> et DbSet<TEntity> comportent 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"), OrderLines sera inclus, mais également Orders. Lorsque vous appelez la méthode Include, le chemin d'accès de la requête est valide uniquement sur l'instance retournée de 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 reprises sur un IQueryable<T> afin de spécifier plusieurs chemins d'accès pour la requête.