Язык

QueryableExtensions.Include Метод

Определение

Перегрузки

Имя. Описание
Include(IQueryable, String)

Указывает связанные объекты для включения в результаты запроса.

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

Указывает связанные объекты для включения в результаты запроса.

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

Указывает связанные объекты для включения в результаты запроса.

Include(IQueryable, String)

Указывает связанные объекты для включения в результаты запроса.

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

Параметры

source
IQueryable

Источник IQueryable , в котором требуется вызвать Include.

path
String

Разделенный точками список связанных объектов, возвращаемых в результатах запроса.

Возвращаемое значение

Новый IQueryable с определенным путем запроса.

Комментарии

Этот метод расширения вызывает метод Include(String) исходного IQueryable объекта, если такой метод существует. Если источник IQueryable не имеет соответствующего метода, этот метод ничего не делает. ObjectSet<TEntity> DbQuery У ObjectQueryвсех DbSet типов есть соответствующий метод Include для вызова. Пути являются все включающими. Например, если вызов включения указывает include("Orders.OrderLines"), то не только будут включены строки OrderLines, но и Заказы. При вызове метода Include путь запроса действителен только для возвращаемого экземпляра IQueryableобъекта. Другие экземпляры IQueryable и сам контекст объекта не затрагиваются. Так как метод Include возвращает объект запроса, этот метод можно вызывать несколько раз для IQueryable указания нескольких путей для запроса.

Применяется к

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

Указывает связанные объекты для включения в результаты запроса.

[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)

Параметры типа

T

Тип запрашиваемой сущности.

TProperty

Тип включенного свойства навигации.

Параметры

source
IQueryable<T>

Исходный идентификатор IQueryable для вызова Include.

path
Expression<Func<T,TProperty>>

Лямбда-выражение, представляющее путь для включения.

Возвращаемое значение

Новый IQueryable<T> с определенным путем запроса.

Атрибуты

Комментарии

Выражение пути должно состоять из простых выражений доступа к свойствам вместе с вызовами Select для создания дополнительных включений после включения proprty коллекции. Ниже приведены примеры возможных путей: включение одной ссылки: запрос. Include(e => e.Level1Reference) Для включения одной коллекции: запроса. Include(e => e.Level1Collection) Чтобы включить ссылку, а затем ссылку на один уровень вниз: запрос. Include(e => e.Level1Reference.Level2Reference) Чтобы включить ссылку, а затем коллекцию один уровень вниз: запрос. Include(e => e.Level1Reference.Level2Collection) Для включения коллекции, а затем ссылки на один уровень вниз: запрос. Include(e => e.Level1Collection.Select(l1 => l1). Level2Reference)) Чтобы включить коллекцию, а затем коллекцию на один уровень вниз: запрос. Include(e => e.Level1Collection.Select(l1 => l1). Level2Collection)) Чтобы включить коллекцию, а затем ссылку на один уровень вниз: запрос. Include(e => e.Level1Collection.Select(l1 => l1). Level2Reference)) Чтобы включить коллекцию, а затем коллекцию на один уровень вниз: запрос. Include(e => e.Level1Collection.Select(l1 => l1). Level2Collection)) Чтобы включить коллекцию, ссылку и ссылку на два уровня вниз: запрос. Include(e => e.Level1Collection.Select(l1 => l1). Level2Reference.Level3Reference)) Чтобы включить коллекцию, коллекцию и ссылку на два уровня вниз: запрос. Include(e => e.Level1Collection.Select(l1 => l1). Level2Collection.Select(l2 => l2. Level3Reference))) Этот метод расширения вызывает метод Include(String) исходного объекта IQueryable, если такой метод существует. Если исходный метод IQueryable не имеет соответствующего метода, этот метод ничего не делает. Типы Entity Framework ObjectQuery, ObjectSet, DbQuery и DbSet имеют соответствующий метод Include для вызова. При вызове метода Include путь запроса действителен только для возвращаемого экземпляра IQueryable<T>. Другие экземпляры IQueryable<T> и сам контекст объекта не затрагиваются. Так как метод Include возвращает объект запроса, этот метод можно вызывать несколько раз в IQueryable<T> , чтобы указать несколько путей для запроса.

Применяется к

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

Указывает связанные объекты для включения в результаты запроса.

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)

Параметры типа

T

Тип запрашиваемой сущности.

Параметры

source
IQueryable<T>

Источник IQueryable<T> , в котором требуется вызвать Include.

path
String

Разделенный точками список связанных объектов, возвращаемых в результатах запроса.

Возвращаемое значение

Новый IQueryable<T> с определенным путем запроса.

Комментарии

Этот метод расширения вызывает метод Include(String) исходного IQueryable<T> объекта, если такой метод существует. Если источник IQueryable<T> не имеет соответствующего метода, этот метод ничего не делает. ObjectSet<TEntity> DbQuery<TResult> У ObjectQuery<T>всех DbSet<TEntity> типов есть соответствующий метод Include для вызова. Пути являются все включающими. Например, если вызов включения указывает include("Orders.OrderLines"), то не только будут включены строки OrderLines, но и Заказы. При вызове метода Include путь запроса действителен только для возвращаемого экземпляра IQueryable<T>объекта. Другие экземпляры IQueryable<T> и сам контекст объекта не затрагиваются. Так как метод Include возвращает объект запроса, этот метод можно вызывать несколько раз для IQueryable<T> указания нескольких путей для запроса.

Применяется к