WinForm 中依赖注入详解：从理论到项目实战-育师

前言

随着软件系统日益复杂，良好的架构设计成为保障项目可维护性、可测试性和扩展性的关键。在开发实践中，依赖注入(Dependency Injection, DI) 已成为解耦组件、提升代码可测试性和实现模块化设计的重要手段之一。

尽管 WinForm是一个相对传统的桌面应用开发框架，但并不意味着它无法拥抱现代化的开发理念。

事实上，在 WinForm 项目中引入依赖注入，不仅可以改善代码结构、提高开发效率，还能让桌面应用程序具备与现代 ASP.NET Core 应用一致的设计思想和架构风格。

本文将从依赖注入的基本概念讲起，逐步深入到其在 WinForm 中的应用场景与优势，并介绍如何使用 .NET 的官方依赖注入容器 Microsoft.Extensions.DependencyInjection 在 WinForm 中实现优雅的依赖管理。

#WinForm开发技巧

依赖注入

依赖注入(Dependency Injection, DI)是一种软件设计模式，它允许我们将对象的创建与使用分离。在传统的编程方式中，当一个类需要使用另一个类的功能时，它通常会直接创建该类的实例。这种方式会导致高耦合，使得代码难以测试和维护。

依赖注入的核心思想是：类不应该负责创建它所依赖的对象，而应该从外部获取这些依赖。

为什么在WinForm中使用依赖注入

传统的Winform应用程序通常采用紧耦合的设计方式，窗体直接创建并管理它们所需的服务和对象。随着应用程序规模的增长，这种方式会导致以下问题：

1、代码耦合度高

窗体与具体实现紧密绑定

2、难以进行单元测试

无法轻松替换依赖项

3、代码重用性差

业务逻辑与UI逻辑混合

4、维护困难

修改一处可能影响多处

引入依赖注入可以解决这些问题，使WinForm应用程序更加模块化、可测试和可维护。虽然WinForm是一个相对较老的UI框架，但它完全可以与现代的依赖注入框架结合使用。

依赖注入容器

.NET Core引入了官方的依赖注入容器Microsoft.Extensions.DependencyInjection，它提供了一套简单而强大的API来管理依赖关系。即使在Winform这样的传统.NET应用中，我们也可以使用这个现代化的DI容器。

要在Winform项目中使用它，首先需要安装相关NuGet包：

Install-Package Microsoft.Extensions.DependencyInjection

这个DI容器的核心组件包括：

IServiceCollection：用于注册服务
ServiceProvider：用于解析服务
ServiceDescriptor：描述服务的注册信息

它支持三种服务生命周期：

1、Singleton

整个应用程序生命周期内只创建一个实例

2、Scoped

在同一个作用域内共享一个实例

3、Transient

每次请求都创建一个新实例

在Winform应用中实现依赖注入

在Winform应用中实现依赖注入需要几个关键步骤：

1、创建和配置服务容器

2、注册所需的服务

3、构建服务提供者

4、使用服务提供者获取窗体实例

下面是一个基本的实现示例：

注册服务的生命周期

在Winform应用中选择适当的服务生命周期非常重要：

Singleton

适用于整个应用程序生命周期内共享的服务，如配置服务、日志服务等。

services.AddSingleton<ILogService, LogService>();

Scoped

在Winform中，Scoped生命周期通常与应用程序生命周期相同，但在某些情况下可以创建自定义范围。适用于需要在特定操作期间共享的服务。

services.AddScoped<IDataService, DataService>();

Transient

每次请求都创建新实例，适用于轻量级、无状态的服务。

services.AddTransient<ICalculationService, CalculationService>();

自动注册窗体和控件

在大型应用中，手动注册每个窗体和控件会很繁琐。我们可以使用反射自动注册所有窗体和控件：

日志服务的集成

日志记录是现代应用程序的重要组成部分。我们可以使用NLog等日志框架，并通过依赖注入集成到Winform应用中：首先，安装必要的NuGet包：

Install-Package NLog
Install-Package NLog.Extensions.Logging
Install-Package Microsoft.Extensions.Logging

然后，配置日志服务：

配置文件示例

nlog.config文件的示例：

项目示例

安装NLog

NLogNLog.Extensions.Logging

nlog.config

<?xml version="1.0" encoding="utf-8" ?>
<nlog xmlns="http://www.nlog-project.org/schemas/NLog.xsd"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
autoReload="true"
internalLogLevel="Info"
internalLogFile="internal-nlog-info.txt">
<targets>
<target xsi:type="File"
name="logfile"
fileName="${basedir}/logs/${shortdate}.json">
<layout xsi:type="JsonLayout">
<attribute name="time" layout="${longdate}" />
<attribute name="level" layout="${level:uppercase=true}" />
<attribute name="logger" layout="${logger}" />
<attribute name="message" layout="${message}" />
<attribute name="exception" layout="${exception:format=tostring}" />
</layout>
</target>
<target xsi:type="Console"
name="logconsole"
layout="${level:uppercase=true}: ${message} ${exception:format=tostring}" />
</targets>
<rules>
<logger name="*" minlevel="Info" writeTo="logfile" />
<logger name="*" minlevel="Debug" writeTo="logconsole" />
</rules>
</nlog>

Program.cs

using Microsoft.Extensions.DependencyInjection;
using Microsoft.Extensions.Logging;
using NLog.Extensions.Logging;
using NLog;
using System.Reflection;
namespaceAppWinformDI
{
internal staticclass Program
{
publicstatic IServiceProvider ServiceProvider { get; privateset; }/// <summary>/// The main entry point for the application./// </summary>
[STAThread]
static void Main()
{// To customize application configuration such as set high DPI settings or default font,// see https://aka.ms/applicationconfiguration.
ApplicationConfiguration.Initialize();//配置依赖注入
var services = new ServiceCollection();
ConfigureServices(services);
ServiceProvider = services.BuildServiceProvider();
Application.Run(ServiceProvider.GetRequiredService<FrmMain>());
}
private static void ConfigureServices(ServiceCollection services)
{//获取日志记录器
var logger = LogManager.GetCurrentClassLogger();//配置NLog
var configPath = Path.Combine(AppContext.BaseDirectory, "Configuration", "nlog.config");
LogManager.Setup().LoadConfigurationFromFile(configPath);//注册NLog服务
services.AddLogging(loggingBuilder =>
{
loggingBuilder.ClearProviders();
loggingBuilder.SetMinimumLevel(Microsoft.Extensions.Logging.LogLevel.Trace);
loggingBuilder.AddNLog(configPath);
});//直接注册NLog的Logger
services.AddSingleton(LogManager.GetCurrentClassLogger());//为常用类注册特定的Logger
services.AddSingleton(typeof(ILogger<>), typeof(Logger<>));//注册窗体
RegisterAllFormsAndControls(services);
}
private static void RegisterAllFormsAndControls(ServiceCollection services)
{//获取当前应用程序集
var assembly = Assembly.GetExecutingAssembly();//查找所有继承自Form的类型
var formTypes = assembly.GetTypes()
.Where(t => !t.IsAbstract && !t.IsInterface && typeof(System.Windows.Forms.Form).IsAssignableFrom(t));//查找所有继承自UserControl的类型
var controlTypes = assembly.GetTypes()
.Where(t => !t.IsAbstract && !t.IsInterface && typeof(System.Windows.Forms.UserControl).IsAssignableFrom(t));//注册所有Form类型
foreach (var formType in formTypes)
{
services.AddScoped(formType);
}//注册所有UserControl类型
foreach (var controlType in controlTypes)
{
services.AddScoped(controlType);
}
}
}
}