Шпаргалка по EF Core 11
Те части EF Core 11, которые стоит запомнить.
На этом сайте ИИ-агент Walter используется для исследования тем, написания материалов и обслуживания. Подготовка и проверка материалов
Эта подборка - живой указатель всего, что я писал про EF Core 11: новые возможности запросов, векторный поиск по индексам DiskANN, работа над производительностью и заметки по миграции с EF Core 8, 9 или 10.
С чего начать
Если вы уже знакомы с EF Core и нужна только разница, пробегитесь по статьям с тегом “ef core 11”. Если планируете миграцию, статьи с тегом migration содержат ломающие изменения и точные команды dotnet ef, которые я использовал.
Что на этой странице
Список ниже автоматически собирает статьи с одним из тегов: ef core, efcore, entity framework, ef core 11, efcore 11. Сначала самые новые.
Указатель (105 статей)
2026 / 10
- Исправление: The property 'X' is part of a key and so cannot be modified or marked as modified в EF Core
EF Core никогда не обновляет значение ключа у отслеживаемой сущности. Не копируйте ключ из DTO, используйте уникальный индекс вместо альтернативного ключа, а настоящий ключ меняйте вставкой новой строки и удалением старой. Проверено на EF Core 10.0.14.
- Как держать отдельные папки миграций для нескольких DbContext в одном проекте EF Core
Передайте --output-dir один раз для каждого DbContext, и EF Core будет складывать все последующие миграции в эту папку и пространство имён. Почему раскладка по умолчанию получается перекошенной, откуда берётся CS0111 при общей папке, как перенести существующие миграции и когда стоит разделить таблицу истории.
- Как настроить самоссылающуюся связь многие-ко-многим (подписчики и подписки) в EF Core
Моделируем подписчиков и подписки на одной сущности User в EF Core 11: что строит конвенция, почему SQL Server молча превращает один внешний ключ соединительной таблицы в ClientCascade, как сопоставить явную сущность Follow с временной меткой и как удалить пользователя без ошибок 547 и 1785.
- Что определяет, создаст ли EF Core для столбца SQL Server `date` тип `DateOnly` или `DateTime` при scaffold?
Это определяет версия EF Core у провайдера SQL Server в вашем стартовом проекте: EF Core 7 и более ранние создают для date тип DateTime, EF Core с 8 по 11 создают DateOnly. Здесь показано сопоставление типов, которое принимает решение, измеренный результат для EF Core 7, 8, 10 и 11 RC 2, а также два способа вернуть DateTime, не переключив столбец незаметно на datetime2.
- Исправление: конфликт версий NU1608 / NU1107 между Pomelo.EntityFrameworkCore.MySql и EF Core 10
Pomelo 9.0.0 допускает только EF Core Relational 9.0.x, а сборки для EF Core 10 нет. Оставьте все пакеты EF Core на 9.0.x или перейдите на Microting.EntityFrameworkCore.MySql 10.0.x. Подавление предупреждения приводит к падению при запуске.
- Fix: Settings file 'DotnetToolSettings.xml' was not found in the package
Пакет инструмента нацелен на более новую версию .NET, чем SDK, выполняющий установку, или вообще не является инструментом .NET. Используйте более новый SDK, зафиксируйте версию инструмента с подходящей папкой tools или принудительно задайте --framework.
- Как проверить, отслеживается ли сущность в DbContext, перед её подключением в EF Core
Используйте DbSet.Local.FindEntry(key), чтобы спросить у трекера изменений, отслеживается ли сущность с заданным ключом, без обращения к базе данных и без перебора. Почему Entry(entity).State вводит в заблуждение, почему Find выполняет запрос, и проверенный помощник AttachOrMerge для EF Core 10.
- Что такое скомпилированная модель в EF Core 11 и когда стоит её включать
Скомпилированная модель - это сгенерированный C#-код, который воссоздаёт вашу модель EF Core без запуска OnModelCreating. Замеры на EF Core 11 RC1: загрузка модели сокращается с 714 мс до 215 мс при 500 сущностях, но путь через MSBuild (заменивший EFOptimizeContext) медленнее, устаревшие модели ломаются молча, а фильтры запросов блокируют генерацию.
- Что такое shadow-свойство в EF Core 11 и почему оно появилось в моей миграции?
Shadow-свойство - это столбец, который EF Core отслеживает без соответствующего CLR-свойства. Почему EF Core 11 их создаёт (отсутствующие FK-свойства, неверно названные FK, несовпадение типов, раздвоенные связи), как заметить столбец вида BlogId1 в миграции, как исправить каждую причину и как использовать shadow-свойства намеренно.
- AddDbContextPool или AddDbContextFactory для параллельного выполнения запросов EF Core
AddDbContextPool выдаёт один scoped DbContext на область DI, поэтому не может выполнять два запроса одновременно. AddDbContextFactory и AddPooledDbContextFactory дают контекст на каждый вызов, а именно это нужно параллельным запросам. Замеры на EF Core 11 RC 1: пулированная фабрика создаёт контекст за 342 нс и 40 Б против 17 мкс и 44 КБ.
- Исправление: Invalid column name 'Value' при использовании SqlQueryRaw<T> для скалярного результата в EF Core
EF Core оборачивает скалярный SqlQuery<T> в подзапрос и выбирает столбец с именем Value, как только вы добавляете First, Where, Max или Single. Задайте в SQL псевдоним AS Value или сначала материализуйте результат.
- Исправление: There is already an object named 'X' in the database после сброса миграций EF Core
После удаления папки Migrations и создания нового InitialCreate EF Core не знает, что ваши таблицы уже существуют. Удалите базу данных для разработки или запишите новую миграцию в __EFMigrationsHistory, не выполняя её.
- Как задать параметры сеанса PostgreSQL, такие как search_path или statement_timeout, для каждого подключения EF Core с Npgsql
Однократно выполненный SET стирается командой DISCARD ALL в тот момент, когда Npgsql возвращает подключение в пул. Передайте search_path и statement_timeout в стартовом пакете через ключевые слова строки подключения Search Path и Options, а при необходимости используйте ALTER ROLE или перехватчик ConnectionOpened, и узнайте, почему UsePhysicalConnectionInitializer молча теряет свой SET.
- EF.Parameter или EF.Constant в запросах EF Core 11
EF.Constant встраивает захваченное значение в SQL как литерал, EF.Parameter превращает литерал в SQL-параметр. Оставляйте поведение EF Core по умолчанию, используйте EF.Parameter, чтобы динамически построенные деревья выражений не перекомпилировались при каждом вызове, а EF.Constant применяйте только для значений с небольшим набором вариантов и настолько перекошенными данными, что каждому нужен свой план.
2026 / 09
- Исправление: EF Core `Contains` для static readonly `IList<T>` или `ISet<T>` не удаётся транслировать
EF Core 8, 9 и 10 не могут транслировать Contains, если список является static readonly полем типа IList, ICollection, ISet или IReadOnlySet. Вызовите Enumerable.Contains явно или перейдите на EF Core 11.
- Как добавить уникальный индекс на JSON-сопоставленное свойство в EF Core 11 (SQL Server и SQLite)
HasIndex(...).IsUnique() на члене ToJson() не обеспечивает уникальность в EF Core 11 RC 1: SQL Server отбрасывает IsUnique, а SQLite индексирует весь документ. Вынесите значение JSON в вычисляемый столбец и поставьте уникальный индекс на него.
- Как атомарно добавить элемент в массив jsonb в PostgreSQL с EF Core и Npgsql
Загрузка сущности, вызов List.Add и сохранение перезаписывают весь документ jsonb и незаметно теряют параллельные добавления. Перенесите добавление в один UPDATE с оператором jsonb ||, через ExecuteSqlAsync или через сопоставленную функцию внутри ExecuteUpdateAsync, и сделайте его идемпотентным с помощью проверки @>.
- Как использовать последовательность Oracle для генерации первичных ключей в EF Core
Привязка ключа EF Core к последовательности Oracle через UseSequence в Oracle.EntityFrameworkCore 10: какой DDL и какой SQL для INSERT на самом деле генерирует провайдер, как сослаться на существующую последовательность или унаследованный триггер, почему на кавычках и HiLo спотыкаются чаще всего и как перевести identity-столбец на последовательность без ORA-00001.
- Как настроить собственную плюрализацию имён таблиц в dotnet ef dbcontext scaffold через IPluralizer
Таблица с именем Gas превращается в сущность Ga. Замените встроенный плюрализатор Humanizer собственной реализацией IPluralizer, зарегистрируйте её через IDesignTimeServices в стартовом проекте и узнайте, почему TryAddSingleton там молча ничего не делает.
- Как гарантировать идемпотентную обработку сообщений в EF Core 11, когда одно и то же сообщение получают два экземпляра приложения
Проверка на существование в обработчике не та защита, за которую вы её принимаете. Поставьте уникальный индекс на таблицу inbox, пишите маркер в том же SaveChanges, что и бизнес-изменение, и пусть победителя выбирает база данных. Плюс ловушка с ExecuteUpdate, которая молча сводит всё это на нет.
- Как задать собственные соглашения об именовании первичных ключей, внешних ключей и индексов в миграциях EF Core 11
Переименуйте все PK_, FK_, AK_ и IX_, которые генерирует EF Core 11, с помощью одного IModelFinalizingConvention, сохраните приоритет явно заданных имён, уложитесь в ограничение длины идентификатора и избегите перестроения кластеризованного индекса, которое следующая миграция сгенерирует для существующей базы данных.
- Миграция приложения EF Core с Cosmos DB после изменения экранирования генерируемых id в EF Core 11
EF Core 11 перестает экранировать '/', '\', '?' и '#' в генерируемых значениях id для Cosmos DB, поэтому документы, записанные EF Core 8-10, больше не находятся по ключу. Как понять, затронуты ли вы, когда включать переключатель EscapeIllegalCosmosIdCharacters и как безопасно переписать id с помощью транзакционного пакета.
- Уровень совместимости SQL Server 150 или 160: что меняется в запросах EF Core 11
EF Core 11 теперь по умолчанию задаёт для UseSqlServer уровень совместимости 160, из-за чего в ваш SQL попадают LEAST, GREATEST и двухаргументные LTRIM/RTRIM, в том числе в каждом Take(n).FirstOrDefault(). Оставляйте 160 на SQL Server 2022 и новее; закрепите UseCompatibilityLevel(150), если хоть одно окружение ещё работает на SQL Server 2019.
- Исправление: EF Core MigrateAsync и CanConnectAsync 60 секунд повторяют попытки при 'Login failed for user'
Проверка существования базы в провайдере SQL Server для EF Core повторяет ошибку 18456 целую минуту, с EnableRetryOnFailure или без него. Падайте сразу, ограничьте RetryTimeout или дождитесь EF Core 12.
- Исправление: Could not load file or assembly 'Microsoft.Data.SqlClient, Version=7.0.0.0' после обновления EF Core
EF Core 11 скомпилирован против Microsoft.Data.SqlClient 7.0.0.0, но при восстановлении пакетов или развёртывании победила копия 6.x. Удалите старую фиксацию версии SqlClient и заново разверните весь вывод сборки.
- Исправление: InvalidOperationException: Nullable object must have a value в проекции EF Core 11
EF Core выбрасывает это исключение, когда Select читает SQL NULL в int, decimal или DateTime, не допускающий null. Приведите член к типу, допускающему null, и добавьте ?? default, либо защитите навигацию проверкой на null.
- Как экранировать подстановочные символы % и _ в запросах с EF.Functions.Like и StartsWith в EF Core 11
StartsWith, EndsWith и Contains в EF Core 11 уже сами экранируют % и _, а EF.Functions.Like этого не делает. Разбираем SQL, который генерирует EF, переиспользуемый помощник для экранирования и перегрузку с escapeCharacter, благодаря которой всё работает в SQL Server, SQLite и PostgreSQL.
- Нативный столбец json или nvarchar(max) для хранения JSON в SQL Server с EF Core 11
Используйте нативный тип json в SQL Server 2025 и Azure SQL: благодаря ему EF Core 11 получает JSON_CONTAINS, типизированный JSON_VALUE, обновление на месте через modify() и JSON-индексы. Оставайтесь на nvarchar(max) для SQL Server 2019/2022, устаревших инструментов или схемы, которую нужно уметь откатить.
- Исправление: PublishAot вместе с EFOptimizeContext исчерпывает память при сборке EF Core
Генерация модели EF Core во время сборки снова и снова запускала MSBuild, пока не заканчивалась RAM. Обновите Tasks и Design до 10.0.10+, а в EF Core 11 удалите EFOptimizeContext.
- Исправление: AS JSON option can be specified only for column of nvarchar(max) type in WITH clause
EF Core формирует [col] json '$.path' AS JSON внутри OPENJSON WITH, и Azure SQL отклоняет это с ошибкой Msg 13618. Обновитесь до EF Core 10.0.11+ или понизьте уровень совместимости провайдера до 160.
- Исправление: Complex entry original ordinal '-1' is invalid при сохранении комплексной коллекции с ToJson
Обновите Microsoft.EntityFrameworkCore до 10.0.10 или новее. До этой версии рост вложенной коллекции внутри второго комплексного свойства с ToJson ломал SaveChanges.
- Исправление: The complex type collection must be initialized to a non-null value
В EF Core 10.0.x присвоение null сложному свойству с коллекцией из двух элементов внутри сложной коллекции ToJson ломает DetectChanges. Исправлено в 11.0.0-rc.1.
- Исправление: MissingMethodException 'AbstractionsStrings.ArgumentIsEmpty' после обновления EF Core Tools
dotnet ef бросает MissingMethodException на ArgumentIsEmpty, потому что Tools 10.0.6 перестал подтягивать совместимый Microsoft.EntityFrameworkCore.Design. Зафиксируйте Design на своей версии EF Core.
- Как написать value converter в EF Core 11, который преобразует null из базы данных в ненулевое значение в коде
По умолчанию EF Core никогда не передаёт null в value converter. Разбираем внутренний конструктор convertsNulls, который это меняет, вызов IsRequired(false), от которого он зависит, почему он не работает с enum и другими типами значений, ловушку WHERE col = NULL, которую он создаёт, и два подхода, решающие задачу без внутреннего API.
- Как использовать пессимистичную блокировку с UPDLOCK и SELECT ... FOR UPDATE в EF Core 11
В EF Core 11 по-прежнему нет API блокировок. Разбираем, как взять настоящую блокировку строки через FromSql: WITH (UPDLOCK, ROWLOCK) в SQL Server, FOR UPDATE в PostgreSQL, ловушка с подзапросом, которая молча расширяет блокировку, NOWAIT и SKIP LOCKED, повторы при дедлоках и что делать, когда строки ещё нет.
- Что такое перехватчик EF Core и когда он нужен?
Перехватчик EF Core - это класс, который EF вызывает до и после операций вроде выполнения команды или SaveChanges и который может изменить или подавить их, а не только наблюдать. Здесь разобраны семь точек перехвата в EF Core 11, правила регистрации и времени жизни, а также случаи, когда фильтр запроса или обычное журналирование подходят лучше.
2026 / 08
- Fix: 23505: duplicate key value violates unique constraint при конкурентной вставке в EF Core
Проверка-затем-вставка в вашем обработчике не атомарна. Перехватывайте PostgresException с SqlState 23505 или сверните всё в одну инструкцию INSERT ... ON CONFLICT. EnableRetryOnFailure не поможет.
- Исправление: CREATE DATABASE permission denied in database 'master' при запуске dotnet ef database update
Migrate() в EF Core всегда проверяет наличие базы данных и создаёт её через жёстко зашитое подключение к master. Выдайте CREATE ANY DATABASE, почините доступ логина к существующей базе или выпускайте идемпотентный SQL-скрипт.
- Исправление: Model building is not supported when publishing with NativeAOT в сборке .NET MAUI для iOS
Сборки для iOS выставляют DynamicCodeSupport=false, поэтому EF Core отказывается строить модель, даже если вы никогда не включали NativeAOT. Поставляйте скомпилированную модель и предкомпилированные запросы либо снова включите интерпретатор.
- Как писать переиспользуемые предикаты LINQ, которые EF Core транслирует в Where, Select и OrderBy
Вспомогательный метод, возвращающий bool, бросает "could not be translated". Expression<Func<T, bool>> не бросает. Разбираем, как компоновать, вкладывать и переиспользовать деревья выражений в EF Core 11 без LINQKit, с реальным SQL для каждого случая.
- Решение: "An exception was thrown while attempting to evaluate a LINQ query parameter expression" в EF Core 11
EF Core выбрасывает это, когда вычисляемая на клиенте часть запроса падает во время вычисления. Прочитайте InnerException, включите EnableSensitiveDataLogging и вынесите проверку на null за пределы лямбды.
- Как генерировать первичный ключ из последовательности базы данных при вставке в EF Core 11
Переводим ключ с IDENTITY на последовательность SQL Server в EF Core 11 через UseSequence: точный SQL, который выдаёт EF, почему явные значения ключа вдруг работают без IDENTITY_INSERT, последовательность bigint для колонки int и пропуски, которые нужно закладывать в проект.
- Как использовать IDbContextFactory<T> из singleton-сервиса в Blazor
Singleton не может внедрить DbContext, но может внедрить IDbContextFactory<T>, потому что AddDbContextFactory по умолчанию регистрирует фабрику как singleton. Создавайте и освобождайте по одному контексту на вызов и никогда не сохраняйте экземпляр.
- Исправление: dotnet tool install --global dotnet-ef выдаёт ошибку
Все способы, которыми dotnet tool install --global dotnet-ef падает на SDK .NET 10, с точным сообщением и кодом возврата для каждого: уже установлен, версия не найдена, понижение версии заблокировано, конфликт shim, недоступный фид NuGet и несоответствие среды выполнения, которое ломается уже после успешной установки.
- Как вызвать хранимую процедуру и отобразить её результаты в EF Core 11
Используйте FromSql на DbSet, когда процедура возвращает полные строки сущности, Database.SqlQuery<T> при проекции и ExecuteSql, когда она не возвращает ничего. Никогда не присоединяйте оператор LINQ к EXEC и не читайте выходной параметр до того, как ридер будет освобождён.
- Как переименовать таблицу в миграции EF Core 11 без потери данных
EF Core генерирует RenameTable, когда вы меняете имя таблицы, но DropTable плюс CreateTable, когда вы переименовываете класс сущности. Здесь разобрано, как различать эти два случая, приём с ToTable, который делает переименование класса бесплатным, и баг переименования столбцов, который молча меняет ваши данные местами.
- WebApplicationFactory против Testcontainers для интеграционных тестов в ASP.NET Core
Выбирайте среду интеграционных тестов ASP.NET Core по проверяемому поведению: маршрутизация HTTP, производственная СУБД или опубликованный образ приложения.
- Как реализовать оптимистичную конкурентность с токеном rowversion в EF Core 11
Добавляем токен конкурентности rowversion в EF Core 11: настройка через [Timestamp] и IsRowVersion, SQL, который EF действительно генерирует, перехват DbUpdateConcurrencyException, побеждает база vs побеждает клиент vs слияние, отсоединённые API с ETag и пять ловушек, которые молча отключают всю защиту.
- Как хранить enum строкой в EF Core 11 с помощью value converter
Храните C#-перечисления в EF Core 11 читаемыми строками вместо int: HasConversion, массовая настройка для всех enum, ловушка nvarchar(max), проблема сортировки и миграция существующего int-столбца.
2026 / 07
- Решение: Your startup project doesn't reference Microsoft.EntityFrameworkCore.Design
Добавьте Microsoft.EntityFrameworkCore.Design в стартовый проект, который собирает dotnet ef, а не в проект с вашим DbContext, и передавайте -s в многослойных решениях.
- Исправление: "The model for context 'X' has pending changes" в EF Core 11
EF Core выбрасывает PendingModelChangesWarning, когда модель расходится с последним снимком миграции. Добавьте миграцию или устраните ложное срабатывание.
- Как применять миграции EF Core 11 в продакшене с помощью dotnet ef migrations bundle
Полное руководство по развёртыванию изменений схемы EF Core 11 через bundle миграций: сборка efbundle в CI, ловушка appsettings.json с именованными строками подключения, self-contained bundle и musl RID для Alpine, блокировка миграций начиная с EF Core 9, откат к целевой миграции и почему транзакция на миграцию не спасает на MySQL.
- Комплексные типы против владеемых сущностей в EF Core 11: что выбрать?
В EF Core 11 по умолчанию используйте комплексные типы для объектов-значений и переходите на владеемые сущности только тогда, когда вам нужна отдельная таблица или коллекция, отображённая на собственные строки.
- TPH vs TPT vs TPC для маппинга наследования в EF Core 11: что выбрать?
В EF Core 11 по умолчанию используйте TPH почти для любой иерархии, обращайтесь к TPC только когда вы преимущественно запрашиваете один листовой тип и бенчмарк доказывает его выигрыш, а TPT применяйте только когда к этому вынуждает внешнее ограничение.
- Решение: System.InvalidOperationException: Sequence contains no elements
Это исключение означает, что вы вызвали .First() или .Single() на пустой последовательности. Используйте FirstOrDefault/SingleOrDefault с проверкой на null, защитите запрос или устраните причину пустоты источника.
- Как логировать SQL, который генерирует EF Core 11
Смотрите точный SQL, который Entity Framework Core 11 отправляет в базу данных, вместе со значениями параметров, с помощью LogTo, Microsoft.Extensions.Logging и ToQueryString.
- Решение: "The property could not be mapped, because it is not a supported primitive type or a valid entity type" в EF Core 11
EF Core наткнулся на свойство, которое не знает, как хранить. Сопоставьте его как комплексный тип, преобразуйте через HasConversion, задайте ему ключ или исключите через [NotMapped].
- Как настроить наследование по стратегии таблица на иерархию (TPH) в EF Core 11
TPH -- стратегия наследования по умолчанию в EF Core: одна таблица, один столбец-дискриминатор. Как настроить дискриминатор, разделять столбцы, обрабатывать nullable-свойства производных типов и обойти подводные камни в EF Core 11.
- Как отобразить составной тип вместо owned-сущности в EF Core 11
Owned-сущности несут скрытый ключ и ссылочную идентичность, которые противоречат объектам-значениям. Вот как отобразить объект-значение как составной тип в EF Core 11, когда стоит переходить и какие есть подводные камни.
- Миграция сидинга с HasData на UseAsyncSeeding в EF Core 11
Пошаговое руководство по переносу данных сида с HasData на UseSeeding и UseAsyncSeeding в EF Core 11, включая ловушку миграции DeleteData, которая удаляет ваши существующие строки, если вы её пропустите.
- Именованные фильтры запросов vs один глобальный фильтр запросов в EF Core 11: что выбрать?
Оба варианта генерируют одинаковый SQL. Прибегайте к именованным фильтрам только тогда, когда нужно отключить один предикат независимо; один комбинированный фильтр проще для единственной задачи в EF Core 11.
- Решение: "The LINQ expression could not be translated" в EF Core 11
EF Core 11 выбрасывает это, когда Where или OrderBy вызывает метод, который нельзя преобразовать в SQL. Перепишите предикат с помощью транслируемых операторов или сначала загрузите данные на клиент через AsEnumerable.
- Исправление: "The required column 'X' was not present in the results of a 'FromSql' operation" в EF Core 11
EF Core выбрасывает это, когда ваш сырой SQL не возвращает все столбцы, на которые мапится сущность, или имена не совпадают. Верните все сопоставленные столбцы с совпадающими именами или запросите скалярный либо бесключевой тип.
- Как использовать именованные фильтры запросов для мягкого удаления и мультитенантности в EF Core 11
Примените два независимых глобальных фильтра запросов к одной сущности в EF Core 11: фильтр мягкого удаления и фильтр тенанта, каждый с именем, чтобы можно было отключить один без другого через IgnoreQueryFilters.
2026 / 06
- HasData vs UseSeeding для заполнения данных в EF Core 11: что выбрать?
Используйте HasData только для фиксированных справочных данных, принадлежащих модели. Для всего остального в EF Core 11 используйте UseSeeding и UseAsyncSeeding. Сравнение бок о бок с правилами, которые предопределяют решение.
- Исправление: FOREIGN KEY constraint failed при удалении сущности в EF Core 11
EF Core выбрасывает FOREIGN KEY constraint failed, потому что у родителя ещё есть зависимые строки, которые база данных отказывается оставлять сиротами. Загрузите дочерние записи, сделайте связь необязательной или настройте OnDelete.
- Исправление: No service for type 'Microsoft.EntityFrameworkCore.DbContextOptions' has been registered
EF Core выбрасывает это, когда AddDbContext не вызывался, вызван после Build или конструктор контекста принимает не тот DbContextOptions. Регистрируйте до Build и используйте DbContextOptions<ВашКонтекст>.
- Исправление: The seed entity for entity type 'X' cannot be added because a non-zero value is required for property 'Id'
HasData задаёт начальные данные для сущности с ключом, генерируемым хранилищем, но без явного значения. Дайте каждой строке стабильный Id, отличный от нуля, или используйте UseSeeding.
- Как реализовать keyset-пагинацию (cursor pagination) в EF Core 11
Замените Skip/Take на WHERE, который перескакивает за последнюю увиденную строку. Сортируйте по полностью уникальному ключу, переносите значения последней строки как курсор, и EF Core 11 превратит следующую страницу в поиск по индексу вместо сканирования с OFFSET.
- Как мапить и запрашивать JSON-столбцы в EF Core 11
Сопоставьте вложенный тип с одним JSON-столбцом через ComplexProperty(...).ToJson(), позвольте EF Core 11 хранить его в нативном типе json SQL Server 2025, а затем запрашивайте его с помощью LINQ, который транслируется в JSON_VALUE, JSON_CONTAINS и JSON_PATH_EXISTS.
- Как засеять связь многие-ко-многим в EF Core 11
Заполнение таблицы связки для отношения многие-ко-многим в EF Core 11: неявные теневые ключи, которые нужно именовать вручную, шаблон UsingEntity HasData и альтернатива UseSeeding во время выполнения, работающая с навигациями пропуска.
- Как заполнять данные с помощью UseSeeding и UseAsyncSeeding в EF Core 11
Заполняйте справочные данные правильно в EF Core 11 с помощью UseSeeding и UseAsyncSeeding: где их настраивать, когда они выполняются, какую проверку идемпотентности нельзя пропускать и почему нужно реализовать обе.
- AsNoTracking vs AsNoTrackingWithIdentityResolution в EF Core 11: что выбрать?
Используйте AsNoTracking по умолчанию для запросов только на чтение. Прибегайте к AsNoTrackingWithIdentityResolution только тогда, когда граф результата содержит одну и ту же сущность несколько раз и ваш код полагается на получение единого общего экземпляра.
- Новый анализатор EF1004 в EF Core 11 ловит скрытую асинхронную ошибку
EF Core 11 Preview 5 включает анализатор EF1004. Он помечает вызов ToAsyncEnumerable() на IQueryable, чтобы вы случайно не выполнили запрос к базе данных синхронно внутри await foreach.
- Исправление: The entity type 'X' requires a primary key to be defined в EF Core 11
EF Core не может найти ключ для вашего типа. Назовите свойство Id или {Type}Id, добавьте [Key], вызовите HasKey или, если это представление либо сырой SQL, вызовите HasNoKey.
- Исправление: The configured execution strategy 'SqlServerRetryingExecutionStrategy' does not support user-initiated transactions
EnableRetryOnFailure конфликтует с BeginTransaction. Оберните всю транзакцию в db.Database.CreateExecutionStrategy().ExecuteAsync(...), чтобы она повторялась как единое целое.
- Как использовать перехватчики EF Core 11 для аудита
Проставляйте столбцы CreatedBy/ModifiedOn и пишите полный журнал изменений с помощью ISaveChangesInterceptor в EF Core 11, включая время жизни в DI, текущего пользователя и подводные камни ExecuteUpdate.
- EF Core ExecuteUpdate против загрузки сущностей и SaveChanges: что выбрать?
Руководство по выбору и реальный benchmark для EF Core 11: используйте ExecuteUpdate для множественных записей по предикату, а путь загрузить-затем-SaveChanges только тогда, когда нужен отслеживатель изменений, перехватчики или сложный граф объектов.
- Миграция с EF Core 6 на EF Core 11: критические изменения, которые действительно бьют
Руководство по миграции с фиксированными версиями, с EF Core 6.0 на EF Core 11.0, проходящее через критические изменения EF7, 8, 9, 10 и 11, которые ломают реальные приложения: Encrypt=True, Contains через OPENJSON, PendingModelChangesWarning, нативный столбец json и разделение SqlClient 7.0.
- Исправление: ObjectDisposedException: Cannot access a disposed context instance
Ваша задача fire-and-forget захватила DbContext с областью запроса, который область DI уже освободила. Создайте новый контекст внутри задачи через IServiceScopeFactory или IDbContextFactory.
- EF Core 11 Preview 4: Хватит заново вводить --project и --startup-project с .config/dotnet-ef.json
EF Core 11 Preview 4 позволяет инструменту dotnet ef читать значения опций по умолчанию из файла .config/dotnet-ef.json, так что многопроектные решения больше не вынуждают передавать --project и --startup-project в каждой команде.
- Как использовать разделение запросов, чтобы избежать декартова взрыва в EF Core 11
Когда вы делаете Include двух одноуровневых коллекций, EF Core 11 возвращает декартово произведение, и число строк взрывается. Вот как это исправляет AsSplitQuery, как включить его глобально и какие тонкости согласованности и упорядочивания нужно учитывать.
2026 / 05
- Как использовать ExecuteUpdate и ExecuteDelete для массовых записей в EF Core 11
Полное руководство по ExecuteUpdate и ExecuteDelete в EF Core 11: какой SQL они генерируют, ловушка трекера изменений, которая молча перезаписывает вашу массовую запись, транзакции, контроль конкурентного доступа через число затронутых строк и сеттеры через делегат из EF Core 10, позволяющие собирать условные обновления обычными инструкциями if.
- EF Core 11 Preview 4: столбцы периода во временных таблицах наконец могут быть настоящими свойствами
EF Core 11 Preview 4 снимает многолетнее ограничение shadow-свойств для временных таблиц SQL Server. PeriodStart и PeriodEnd теперь могут быть обычными CLR-свойствами, настраиваемыми строго типизированными лямбдами HasPeriodStart и HasPeriodEnd.
- Скомпилированные запросы EF Core vs сырой SQL vs Dapper: что побеждает на пути чтения?
Для путей с большим количеством чтений в .NET 11 чистый EF Core с AsNoTracking держится в пределах ~5% от Dapper. Используйте скомпилированные запросы на профилированном горячем пути одной строки, а Dapper только для наименьшей задержки или для SQL, который LINQ не может выразить.
- IEnumerable vs IAsyncEnumerable vs IQueryable в C#: что должен возвращать метод?
Три интерфейса последовательностей, три модели выполнения. Используйте IQueryable, когда база данных может транслировать запрос, IAsyncEnumerable, когда производитель асинхронный и вам нужна потоковая передача, IEnumerable для всего остального в памяти.
- EF Core 11 vs Dapper для массовых вставок: реальный бенчмарк
Для массовых вставок в .NET 11 не побеждают ни EF Core, ни Dapper. Побеждает SqlBulkCopy. Это бенчмарк, причина и то место, которое заслуживает каждый инструмент.
- Fix: A possible object cycle was detected
System.Text.Json отказывается сериализовать графы с обратными ссылками. Установите ReferenceHandler.IgnoreCycles, спроецируйте на DTO или пометьте обратный указатель атрибутом [JsonIgnore]. Preserve - крайнее средство.
- Исправление: SqlException: Timeout expired при миграциях EF Core
Миграции используют DbContext времени проектирования, а не ваш CommandTimeout времени выполнения. Установите таймаут через UseSqlServer(o => o.CommandTimeout(...)), Command Timeout в строке подключения или Database.SetCommandTimeout перед Migrate().
- Fix: dotnet ef migrations add падает с 'Unable to create an object of type DbContext'
Инструменты EF Core времени проектирования не смогли создать экземпляр вашего DbContext. Предоставьте host через WebApplication.CreateBuilder, укажите правильный startup project или реализуйте IDesignTimeDbContextFactory.
- Исправление: The instance of entity type cannot be tracked because another instance with the same key value is already being tracked
EF Core 11 выбрасывает это исключение, когда два объекта делят первичный ключ внутри одного DbContext. Отсоедините старый или обновите его на месте. AsNoTracking при чтении предотвращает коллизию.
- Исправление: A second operation was started on this context instance before a previous operation completed
EF Core выбрасывает это исключение, когда два await выполняются параллельно на одном DbContext. Ожидайте каждый вызов последовательно или получайте новый DbContext на каждую конкурентную единицу работы через IDbContextFactory.
- Исправление: System.InvalidOperationException: No connection string named 'DefaultConnection' could be found
Если GetConnectionString возвращает null в .NET 11, в вашем appsettings.json нет ключа, файл не копируется в выходной каталог сборки или выбран не тот файл окружения. Три проверки решают 95% случаев.
- Как обнаружить запросы N+1 в EF Core 11
Практическое руководство по выявлению запросов N+1 в EF Core 11: как этот шаблон выглядит в реальном коде, как сделать его видимым через журналы, диагностические перехватчики, OpenTelemetry, и тест, который ломает сборку при регрессии горячего пути.
- Как использовать скомпилированные запросы EF Core на горячих путях
Практическое руководство по скомпилированным запросам в EF Core 11: когда EF.CompileAsyncQuery действительно даёт выигрыш, шаблон со статическим полем, подводные камни Include и отслеживания, и как замерить производительность до и после, чтобы убедиться, что дополнительная церемония оправдана.
- Как писать интеграционные тесты против настоящего SQL Server с помощью Testcontainers
Полное руководство по запуску интеграционных тестов ASP.NET Core против настоящего SQL Server 2022 с использованием Testcontainers 4.11 и EF Core 11: настройка WebApplicationFactory, IAsyncLifetime, подмена регистрации DbContext, применение миграций, параллелизм, очистка через Ryuk и подводные камни CI.
2026 / 04
- Как прогреть модель EF Core до первого запроса
EF Core строит свою концептуальную модель лениво при первом обращении к DbContext, поэтому первый запрос в свежем процессе на несколько сотен миллисекунд медленнее любого последующего. Это руководство охватывает три реальных решения в EF Core 11: стартовый IHostedService, который трогает Model и открывает соединение, dotnet ef dbcontext optimize для поставки предкомпилированной модели, и подводные камни ключа кеша, которые всё равно молча перестраивают модель.
- Как мокать DbContext, не ломая отслеживание изменений
Прямое мокание DbContext незаметно ломает ChangeTracker, поэтому Microsoft не рекомендует так делать. Это руководство показывает два паттерна, которые действительно работают в EF Core 11: SQLite в памяти с удерживаемым открытым соединением, чтобы запускался настоящий ChangeTracker, и паттерн репозитория, полностью убирающий EF Core из теста.
- Как использовать IAsyncEnumerable<T> с EF Core 11
Запросы EF Core 11 напрямую реализуют IAsyncEnumerable<T>. Как стримить строки через await foreach, когда предпочесть его вместо ToListAsync, и подводные камни со соединениями, трекингом и отменой.
- Как правильно использовать records с EF Core 11
Практическое руководство по сочетанию records C# и EF Core 11. Где records подходят, где они ломают change tracking, и как моделировать value objects, сущности и проекции, не воюя с фреймворком.
- EF Core 11 вырезает ненужные reference joins в split queries
EF Core 11 Preview 3 убирает избыточные to-one joins из split queries и роняет ненужные ORDER BY ключи. Один заявленный сценарий стал на 29% быстрее, другой на 22%. Вот как теперь выглядит SQL.
- EF Core 11 добавляет GetEntriesForState, чтобы пропустить DetectChanges
EF Core 11 Preview 3 вводит ChangeTracker.GetEntriesForState, state-фильтрованный enumerator, избегающий лишнего прохода DetectChanges в hot paths вроде SaveChanges interceptors и audit hooks.
- EF Core 11 включает transactional batches Cosmos DB по умолчанию
EF Core 11 группирует writes Cosmos DB в transactional batches по container и partition на каждом SaveChanges, давая best-effort атомарность и меньше roundtrips без изменений кода.
- EF Core 11 позволяет создать и применить миграцию одной командой
Команда dotnet ef database update теперь принимает --add для создания и применения миграции в одном шаге. Вот как это работает, почему это важно для контейнеров и .NET Aspire, и на что обратить внимание.
- EF Core 11 добавляет нативный векторный поиск SQL Server с индексами DiskANN
EF Core 11 Preview 2 поддерживает VECTOR_SEARCH() из SQL Server 2025 и векторные индексы DiskANN прямо из LINQ. Вот как настроить индекс, выполнять приближённые запросы, и что меняется по сравнению с подходом VectorDistance из EF Core 10.