How to use dependency injection in WinForms

How to use Dependency Injection (DI) in Windows Forms (WinForms)

To use DI in a WinForms .NET 5 or 6 you can do the following steps:

  1. Create a WinForms .NET Application

  2. Install Microsoft.Extensions.Hosting package (which gives you a bunch of useful features like DI, Logging, Configurations, and etc.)

  3. Add a new interface, IHelloService.cs:

    public interface IHelloService
    {
        string SayHello();
    }
    
  4. Add a new implementation for your service HelloService.cs:

    public class HelloService : IHelloService
    {
        public string SayHello()
        {
            return "Hello, world!";
        }
    }
    
  5. Modify the Program.cs:

    //using Microsoft.Extensions.DependencyInjection;
    static class Program
    {
        [STAThread]
        static void Main()
        {
            Application.SetHighDpiMode(HighDpiMode.SystemAware);
            Application.EnableVisualStyles();
            Application.SetCompatibleTextRenderingDefault(false);
    
            var host = CreateHostBuilder().Build();
            ServiceProvider = host.Services;
    
            Application.Run(ServiceProvider.GetRequiredService<Form1>());
        }
        public static IServiceProvider ServiceProvider { get; private set; }
        static IHostBuilder CreateHostBuilder()
        {
            return Host.CreateDefaultBuilder()
                .ConfigureServices((context, services)=>{
                    services.AddTransient<IHelloService, HelloService>();
                    services.AddTransient<Form1>();
                });
        }
    }
    

Now you can inject IHelloService in Form1 and use it:

//using Microsoft.Extensions.DependencyInjection;
public partial class Form1 : Form
{
    private readonly IHelloService helloService;

    public Form1(IHelloService helloService)
    {
        InitializeComponent();
        this.helloService = helloService;
        MessageBox.Show(helloService.SayHello());
    }
}

If you want to show Form2 using DI, you first need to register it services.AddTransient<Form2>();, then depending to the usage of Form2, you can use either of the following options:

  • If you only need a single instance of Form2 in the whole life time of Form1, then you can inject it as a dependency to the constructor of Form1 and store the instance and show it whenever you want.

    But please pay attention: it will be initialized just once, when you open Form1 and it will not be initialized again. You also should not dispose it, because it’s the only instance passed to Form1.

    public Form1(IHelloService helloService, Form2 form2)
    { 
         InitializeComponent();
             form2.ShowDialog();
    }
    
  • If you need multiple instances of Form2 or you need to initialize it multiple times, then you may get an instance of it like this:

    using (var form2 = Program.ServiceProvider.GetRequiredService<Form2>())
         form2.ShowDialog();
    

Leave a Comment