ServiceResolver.GenericHost.SimpleInjector 3.6.4

ServiceResolver.GenericHost.SimpleInjector wires ServiceResolver.Ioc.SimpleInjector into Microsoft.Extensions.Hosting's IHostBuilder, replacing the default IServiceProvider with a SimpleInjector-backed one.

Getting started (console / worker apps)

var hostBuilder = Host.CreateDefaultBuilder(args)
    .UseServiceResolver(new SimpleInjectorOptions
    {
        OnRegistering = provider =>
        {
            provider.Register<StringBuilder>(() => new StringBuilder("hello world.."));
        },
        AfterBuildingProvider = provider =>
        {
            provider.Verify();
        }
    });

var host = hostBuilder.Build();

await host.RunAsync();

An overload taking Func<HostBuilderContext, SimpleInjectorOptions> is also available when you need access to configuration or environment during setup.

Getting started (ASP.NET Core, .NET 6+)

Also requires the ServiceResolver.GenericHost.AspNetCore package.

var builder = WebApplication.CreateBuilder(args);

builder.Host.UseServiceResolver(new SimpleInjectorOptions
{
    BeforeRegistering = collection =>
    {
        collection.AddControllers();
    },
    OnRegistering = serviceRegister =>
    {
        serviceRegister
            .AddAspNetCore()
            .AddControllerActivation();
    },
    AfterBuildingProvider = provider =>
    {
        provider.Verify();
    }
});

var app = builder.Build();

app.UseAuthorization();
app.MapControllers();
await app.RunAsync();

Constructor resolution: strict by default, relaxed where it has to be

By default (ConstructorResolutionType = ResolutionType.Hybrid), services registered through IServiceRegister keep SimpleInjector's strict rules (single public constructor, no optional-parameter fallback), while services coming from IServiceCollection (ASP.NET Core, third-party AddXxx() extensions) get a more permissive resolution — because those libraries routinely assume Microsoft's own, more lenient DI conventions. Set ConstructorResolutionType / SuppressDiagnosticType to ResolutionType.Standard (fully strict) or ResolutionType.LessRestrictive (relaxed everywhere) to change this globally.

Main types

• SimpleInjectorOptions — the configuration passed to UseServiceResolver.

Advanced scenarios that configure the underlying Container directly can use the public types under the ServiceResolver.Ioc.Advanced namespace, such as KeyedConstructorResolverBehavior and KeyedDependencyInjectionBehavior — see the documentation for details.

Related packages

• ServiceResolver.GenericHost
• ServiceResolver.Ioc.SimpleInjector
• ServiceResolver.GenericHost.AspNetCore (for ASP.NET Core)