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