UnitOfWork

Реализация паттерна "Unit Of Work" для EntityFrameworkCore на платформе .NET. This is a Unit ofWork pattern implementation on .NET.

Nuget

Calabonga.UnitOfWork

Версии

10.0.3 2026-09-03

• Обновлены пакеты EntityFrameworkCore до 10.0.11 (Updated EntityFrameworkCore packages to 10.0.11). Microsoft.EntityFrameworkCore.Sqlite в тестах также поднят до 10.0.11 — уходит транзитивная уязвимость SQLitePCLRaw (NU1903, GHSA-2m69-gcr7-jv3q).

10.0.2 2026-09-03

• Обновлён Calabonga.PagedListCore до 3.0.0 (Updated Calabonga.PagedListCore to 3.0.0). Пакет используется только как контракт IPagedList<T>.
• Исправлена несогласованность пагинации (Fixed inconsistent pagination).
  • GetPagedList (синхронный) и GetPagedListAsync теперь используют единую нумерацию страниц: 0-based, первая страница — pageIndex: 0 (значение по умолчанию сохранено, ломающих изменений нет).
  • Для средних страниц корректно вычисляются HasPreviousPage и HasNextPage (ранее средняя страница сообщала об отсутствии предыдущей).
  • Синхронный путь больше не материализует весь запрос на клиенте: Skip/Take/Count транслируются в SQL.
  • IEnumerable<T>.ToPagedList(...) приведён к тем же 0-based правилам.

10.0.0 2026-01-07

• Перехали на NET10 (Migration to NET10)

6.2.0 2025-11-21

• ServiceLifetime for IUnitOfWork added as a parameter during DI-container registration.

6.1.0 2025-10-13

• FromSqlRawInterpolated implemented in IUnitOfWork from DbContext.

6.0.0 2025-03-05

• Deprecated methods were removed. Please use TrackingType parameter instead of disableTracking.

5.0.0 2024-11-25

• Released new 5.0.0 version
• Deprecated methods will remove soon. Please use new overrides with TrackingType parameter.

5.0.0-beta.2 2024-11-23

• Добавлена поддержка фреймворка NET9.0 наряду с фреймворком NET8.0 (Added support for NET9.0 framework along with NET8.0 framework). Теперь в одном пакете поддержка двух версий.

5.0.0-beta.1 2024-11-03

• Созданые перегрузки для всех методов, где используется параметр disableTracking с целью дополнить новым способом управления слежением за изменениями. Теперь доступно выбрать один из вариантов:

  /// <summary>
  /// Changes Tracking Type for DbSet operations
  /// </summary>
  public enum TrackingType
  {
      NoTracking,
      NoTrackingWithIdentityResolution,
      Tracking
  }

  Если вы используте сборку Calabonga.UnitOfWork впервые, то никаких действий дополнительных не потребуется. А если вы обновляете сборку на проекте, где уже был использовано Calabonga.UnitOfWork, то для использования новых методов достаточно указать явно тип слежения за изменениями. Пример кода без использования явного типа слежения:

  public async Task<IEnumerable<PictureFile>> GetFilesForPostAsync(Guid postId, CancellationToken cancellationToken)
  {
      var maps = await _unitOfWork
          .GetRepository<ImageMapLink>()
          .GetAllAsync(predicate: x => x.PostId == postId); // <= Error after update 5.0.x
  
      if (maps.Any())
      {
          return maps.ToList().Select(x => new PictureFile(x.ImageSrc, x.MappedSrc!));
      }
  
      return [];
  }

  Достаточно явно добавить тип

  public async Task<IEnumerable<PictureFile>> GetFilesForPostAsync(Guid postId, CancellationToken cancellationToken)
  {
      var maps = await _unitOfWork
          .GetRepository<ImageMapLink>()
          .GetAllAsync(predicate: x => x.PostId == postId, 
              trackingType: TrackingType.NoTracking); // <= Add explicit value
  
      if (maps.Any())
      {
          return maps.ToList().Select(x => new PictureFile(x.ImageSrc, x.MappedSrc!));
      }
  
      return [];
  }

• Методы, где используется параметр disableTracking, помечены атрибутом obsolete, что означает, что в последующих версиях данные методы будут удалены.

• Исправлены дубликаты кода, возникшие при склеивании веток (спасибо Andrey).

4.0.0 от 2024-02-25

• Обновлена версия сборки до .NET8.
• IPagedList<T> вынесен в свой собственный nuget-пакет Calabogna.PagedListCore.
• Обновлена документация https://calabonga.github.io/UnitOfWork/

3.1.0 от 2023-03-25

• Обновлены nuget-пакеты EntityFramework
• Добавлены дополнительные параметры в методы IRepository<T> для управления AutoIncludes.
• Обновлена документация https://calabonga.github.io/UnitOfWork/

2022-02-08

• Сборка переведена на NET6.0. В проект был обновлен (Nullable = true)
• Обновлены методы на предмет обработки Nullable типов
• Удалена сборка AutoHistory по причине отсутствия поддержки ее NET6.0.

Ссылки

• EntityFramework Core и паттерны "Unit of Work" и "Repository" (ru)
• Документация API
• Блог по программированию
• Boosty.To
• Пишите комментарии к видео на сайте www.calabonga.net

Автор