Что такое IQueryable и когда выполняется запрос?

IQueryable<T> — это ключевой интерфейс в пространстве имён System.Linq, расширяющий IEnumerable<T>. Он предназначен для представления запросов к удалённым источникам данных, таким как базы данных через ORM (например, Entity Framework Core), веб-сервисы или другие провайдеры запросов. Основная идея — отложенное (ленивое) выполнение и возможность трансляции выражений LINQ в специфичный для источника язык запросов (например, SQL).

Как работает IQueryable

Когда вы создаёте запрос, используя методы расширения для IQueryable (например, Where, OrderBy, Select), вы не выполняете его немедленно. Вместо этого вы строите дерево выражений (Expression Tree), которое описывает логику запроса. Это дерево хранится в свойстве IQueryable.Provider и может быть проанализировано провайдером запросов.

Когда выполняется запрос?

Запрос выполняется только при вызове метода, который требует материализации результатов. Это называется триггером выполнения. К таким методам относятся:

• Итерация с помощью foreach.
• Вызов методов агрегации: ToList(), ToArray(), ToDictionary(), First(), Single(), Count(), Sum() и т.д.
• Явное обращение к IQueryable.Provider.Execute().

До этого момента запрос остаётся лишь описанием. Это позволяет эффективно комбинировать условия и фильтры, так как окончательный запрос формируется один раз и выполняется на стороне источника данных.

Пример кода

using (var context = new AppDbContext())
{
    // Создание IQueryable — запрос НЕ выполняется.
    IQueryable<Product> query = context.Products
        .Where(p => p.Price > 100)
        .OrderBy(p => p.Name);

    // Добавление ещё одного условия — запрос всё ещё не выполнен.
    query = query.Where(p => p.CategoryId == 5);

    // Триггер выполнения: вызов ToList() отправляет SQL в базу данных.
    List<Product> expensiveProducts = query.ToList();

    // В консоли можно увидеть сгенерированный SQL-запрос.
    // SELECT * FROM Products WHERE Price > 100 AND CategoryId = 5 ORDER BY Name
}

Где применяется IQueryable?

Основное применение — в ORM, таких как Entity Framework Core, для построения эффективных запросов к базам данных. Также он используется в OData, некоторых NoSQL клиентах и при работе с любыми источниками данных, поддерживающими трансляцию выражений. Это позволяет писать декларативный код на C#, который преобразуется в нативный язык запроса источника.

Вывод: Используйте IQueryable, когда вам нужно строить динамические запросы к внешним источникам данных (особенно базам данных) и хотите, чтобы фильтрация и сортировка выполнялись на стороне сервера, а не в памяти приложения. Это критически важно для производительности при работе с большими объёмами данных.