QueryableExtensions.Include, méthode (IQueryable, 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 ( _
source As IQueryable, _
path As String _
) As IQueryable
'Utilisation
Dim source As IQueryable
Dim path As String
Dim returnValue As IQueryable
returnValue = source.Include(path)
public static IQueryable Include(
this IQueryable source,
string path
)
[ExtensionAttribute]
public:
static IQueryable^ Include(
IQueryable^ source,
String^ path
)
static member Include :
source:IQueryable *
path:string -> IQueryable
public static function Include(
source : IQueryable,
path : String
) : IQueryable
Paramètres
- source
Type : System.Linq.IQueryable
IQueryablesource 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
Nouvel objet IQueryable 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. 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 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 ObjectQuery, ObjectSet<TEntity>, DbQuery et DbSet 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. 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 reprises sur un IQueryable afin de spécifier plusieurs chemins d'accès pour la requête.