Прочитать на английском

Поделиться через


Службы времени разработки

Некоторые службы, используемые инструментами, используются только во время разработки. Эти службы управляются отдельно от служб среды выполнения EF Core, чтобы предотвратить их развертывание с помощью приложения. Чтобы переопределить одну из этих служб (например, службу для создания файлов миграции), добавьте реализацию IDesignTimeServices в проект запуска.

internal class MyDesignTimeServices : IDesignTimeServices
{
    public void ConfigureDesignTimeServices(IServiceCollection services)
        => services.AddSingleton<IMigrationsCodeGenerator, MyMigrationsCodeGenerator>();
}

Ссылка на Microsoft.EntityFrameworkCore.Design

Microsoft.EntityFrameworkCore.Design — это пакет DevelopmentDependency. Это означает, что зависимость не будет передаваться транзитивно в другие проекты, и что по умолчанию нельзя ссылаться на его типы.

Чтобы ссылаться на типы и переопределять службы времени разработки, обновите метаданные элемента PackageReference в файле проекта.

<PackageReference Include="Microsoft.EntityFrameworkCore.Design" Version="3.1.9">
  <PrivateAssets>all</PrivateAssets>
  <!-- Remove IncludeAssets to allow compiling against the assembly -->
  <!--<IncludeAssets>runtime; build; native; contentfiles; analyzers; buildtransitive</IncludeAssets>-->
</PackageReference>

Если пакет ссылается транзитивно через Microsoft.EntityFrameworkCore.Tools, необходимо добавить явную ссылку PackageReference в пакет и изменить ее метаданные.

Список служб

Ниже приведен список служб времени разработки.

Служба Description
IAnnotationCodeGenerator Создает код для соответствующих заметок модели.
ICSharpHelper Помогает создавать код C#.
IPluralizer Плюрализация и сингуляризация слов.
IMigrationsCodeGenerator Создает код для миграции.
IMigrationsScaffolder Основной класс для управления файлами миграции.
IDatabaseModelFactory Создает модель базы данных из базы данных.
IModelCodeGenerator Создает код для модели.
IProviderConfigurationCodeGenerator Создает код OnConfiguring.
IReverseEngineerScaffolder Основной класс для шаблонов реверсивных моделей.
IScaffoldingModelFactory Создает модель из модели базы данных.

Использование служб

Эти службы также могут быть полезны для создания собственных средств. Например, если требуется автоматизировать часть рабочего процесса разработки.

Вы можете создать поставщик услуг, содержащий эти службы, с помощью методов расширения AddEntityFrameworkDesignTimeServices и AddDbContextDesignTimeServices.

var db = new MyDbContext();

// Create design-time services
var serviceCollection = new ServiceCollection();
serviceCollection.AddEntityFrameworkDesignTimeServices();
serviceCollection.AddDbContextDesignTimeServices(db);
var serviceProvider = serviceCollection.BuildServiceProvider();

// Add a migration
var migrationsScaffolder = serviceProvider.GetService<IMigrationsScaffolder>();
var migration = migrationsScaffolder.ScaffoldMigration(migrationName, rootNamespace);
migrationsScaffolder.Save(projectDir, migration, outputDir);