csharp-di

What problem does it solve?

Provides clear, opinionated guidance to avoid common dependency injection pitfalls in .NET applications, ensuring correct lifetimes, safe scoped usage, and maintainable service registration patterns.

Core Features & Use Cases

• Generic Host best practices: Directs use of Host.CreateDefaultBuilder or Host.CreateApplicationBuilder and prohibits ad-hoc BuildServiceProvider in production code.
• Worker Service (BackgroundService) patterns: Prescribes creating scopes with IServiceScopeFactory inside ExecuteAsync loops and enforcing cancellation token checks for graceful shutdown.
• Multi-implementation & Decorator strategies: Recommends keyed services for multiple implementations, IEnumerable injection for bulk consumers, and explicit decorator registration for cross-cutting concerns.
• Use Case: Implement a background order processor that safely resolves scoped order services per iteration, applies a cached repository decorator, and supports multiple notification implementations via keyed services.

Quick Start

Use Host.CreateApplicationBuilder(args) to build the host, register interfaces with scoped lifetimes, use IServiceScopeFactory inside BackgroundService loops for scoped work, and apply keyed services or decorators for multi-implementation scenarios.