QueryableExtensions.Include - метод (IQueryable, String)
[Эта страница относится к документации к Entity Framework 6. Последняя версия доступна в составе пакета Entity Framework NuGet. Дополнительные сведения об Entity Framework см. в разделе msdn.com/data/ef.]
Задает связанные объекты, включаемые в результаты запроса.
Пространство имен: System.Data.Entity
Сборка: EntityFramework (в EntityFramework.dll)
Синтаксис
'Декларация
<ExtensionAttribute> _
Public Shared Function Include ( _
source As IQueryable, _
path As String _
) As IQueryable
'Применение
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
Параметры
- source
Тип: System.Linq.IQueryable
Исходная последовательность IQueryable, для которой вызывается метод Include.
- path
Тип: System.String
Разделенный точками список связанных объектов, включаемых в результаты запроса.
Возвращаемое значение
Тип: System.Linq.IQueryable
Новый запрос IQueryable с определенным путем запроса.
Примечание об использовании
В Visual Basic и C# этот метод можно вызывать как метод экземпляра для любого объекта типа IQueryable. При вызове метода для экземпляра следует опускать первый параметр. Дополнительные сведения см. в разделе https://msdn.microsoft.com/ru-ru/library/bb384936(v=vs.113) или https://msdn.microsoft.com/ru-ru/library/bb383977(v=vs.113).
Примечания
Этот метод расширения вызывает метод Include(String) исходного объекта IQueryable, если такой метод существует. Если исходный объект IQueryable не имеет сопоставимого метода, то этот метод ничего не делает. Все типы ObjectQuery, ObjectSet<TEntity>, DbQuery и DbSet имеют соответствующий метод Include, который может быть вызван. Включаются и все промежуточные пути. Например, если указано, что следует включить Include("Orders.OrderLines"), будут включены не только объекты OrderLines, но и объекты Orders. При вызове метода Include путь метода является допустимым только для возвращаемого экземпляра IQueryable. Другие экземпляры IQueryable и контекст объекта не затрагиваются. Поскольку метод Include возвращает объект запроса, этот метод можно неоднократно вызывать для IQueryable, чтобы задать несколько путей запроса.