摘要

 Autofac 是一个功能丰富的 .NET 依赖注入容器，用于管理对象的生命周期、解决依赖关系以及进行属性注入。本文将详细讲解 Autofac 的使用方法，包括多种不同的注册方式，属性注入，以及如何使用多个 ContainerBuilder 来注册和合并组件。我们将提供详细的源代码示例来说明每个概念。

Autofac 是一个功能丰富的 .NET 依赖注入容器，用于管理对象的生命周期、解决依赖关系以及进行属性注入。本文将详细讲解 Autofac 的使用方法，包括多种不同的注册方式，属性注入，以及如何使用多个 ContainerBuilder 来注册和合并组件。我们将提供详细的源代码示例来说明每个概念。

1. 安装 Autofac

首先，确保你已经安装了 Autofac NuGet 包。你可以使用 NuGet 包管理器或通过控制台运行以下命令来安装 Autofac：

Install-Package Autofac 

2. 创建一个简单的控制台应用程序

我们将从一个简单的控制台应用程序开始，以演示 Autofac 的基本用法。我们将创建一个包含多个组件的容器，并演示多种注册方式以及属性注入的方法。

Program.cs

using System; using Autofac;  namespace AutofacExample {     class Program     {         static void Main(string[] args)         {             // 步骤 1：创建 ContainerBuilder             var builder = new ContainerBuilder();              // 步骤 2：注册组件             builder.RegisterType<DatabaseConnection>().As<IDatabaseConnection>().SingleInstance();             builder.RegisterType<UserRepository>().As<IUserRepository>().InstancePerLifetimeScope();             builder.RegisterType<Logger>().As<ILogger>().Named<ILogger>("ConsoleLogger");              // 步骤 3：构建容器             var container = builder.Build();              // 步骤 4：解析组件并进行属性注入             using (var scope = container.BeginLifetimeScope())             {                 var userRepository = scope.Resolve<IUserRepository>();                 userRepository.AddUser("John Doe");                  // 属性注入示例                 var logger = scope.ResolveNamed<ILogger>("ConsoleLogger");                 logger.Log("This is a log message with attribute injection.");             }              Console.WriteLine("Press Enter to exit...");             Console.ReadLine();         }     } } 

3. 创建组件和接口

现在，我们将创建三个组件 DatabaseConnection，UserRepository 和 Logger，以及它们所实现的接口。

DatabaseConnection.cs

public interface IDatabaseConnection {     void Connect(); }  public class DatabaseConnection : IDatabaseConnection {     public void Connect()     {         Console.WriteLine("Connected to the database.");     } } 

UserRepository.cs

public interface IUserRepository {     void AddUser(string username); }  public class UserRepository : IUserRepository {     private readonly IDatabaseConnection _databaseConnection;      public UserRepository(IDatabaseConnection databaseConnection)     {         _databaseConnection = databaseConnection;     }      public void AddUser(string username)     {         _databaseConnection.Connect();         Console.WriteLine($"User '{username}' added to the database.");     } } 

Logger.cs

public interface ILogger {     void Log(string message); }  public class Logger : ILogger {     public void Log(string message)     {         Console.WriteLine($"Logging: {message}");     } } 

4. 多种注册方式

Autofac 提供了多种不同的组件注册方式，允许你控制组件的生命周期、解决复杂的依赖关系和应用更高级的用法。以下是一些常见的注册方式：

4.1. 单例注册

你可以注册一个组件为单例，这意味着容器将返回同一个实例，直到容器被销毁。在示例中，我们使用 SingleInstance() 方法将 DatabaseConnection 注册为单例。

builder.RegisterType<DatabaseConnection>().As<IDatabaseConnection>().SingleInstance(); 

4.2. 生命周期范围注册

你可以将组件注册为具有特定生命周期范围，例如单次请求或单个生命周期。在示例中，我们使用 InstancePerLifetimeScope() 方法将 UserRepository 注册为单个生命周期。

builder.RegisterType<UserRepository>().As<IUserRepository>().InstancePerLifetimeScope(); 

4.3. 命名注册

你可以注册组件并为其指定一个名称，以便在解析时根据名称来选择不同的实现。在示例中，我们使用 Named<TService, TImplementer>(string name) 方法为 Logger 注册一个名为 "ConsoleLogger" 的实现。

builder.RegisterType<Logger>().As<ILogger>().Named<ILogger>("ConsoleLogger"); 

4.4. Lambda 表达式注册

你可以使用 Lambda 表达式注册一个组件，以根据需要创建实例。在示例中，我们使用 Lambda 表达式注册 DatabaseConnection。

builder.Register(c => new DatabaseConnection()).As<IDatabaseConnection>(); 

4.5. 泛型组件注册

你可以注册泛型组件，允许你在解析时提供类型参数。在示例中，我们使用 RegisterGeneric 方法注册泛型组件 GenericRepository<T>。

builder.RegisterGeneric(typeof(GenericRepository<>)).As(typeof(IGenericRepository<>)); 

5. 属性注入

Autofac 允许你进行属性注入，这意味着你可以在组件实例化后注入属性的值。在示例中，我们演示了如何使用属性注入将 ILogger 注入到 UserRepository 中。

首先，我们需要为 UserRepository 类添加一个属性，并使用 [Autowired] 特性进行标记：

public class UserRepository : IUserRepository {     private readonly IDatabaseConnection _databaseConnection;      // 使用 [Autowired] 特性进行属性注入     [Autowired]     public ILogger Logger { get; set; }      public UserRepository(IDatabaseConnection databaseConnection)     {         _databaseConnection = databaseConnection;     }      public void AddUser(string username)     {         _databaseConnection.Connect();         Console.WriteLine($"User '{username}' added to the database.");          // 使用注入的 Logger         Logger.Log("User added.");     } } 

接下来，我们需要在容器构建前启用属性注入。这可以通过配置 ContainerBuilder 来实现：

var builder = new ContainerBuilder(); builder.RegisterType<DatabaseConnection>().As<IDatabaseConnection>().SingleInstance  (); builder.RegisterType<UserRepository>().As<IUserRepository>().InstancePerLifetimeScope(); builder.RegisterType<Logger>().As<ILogger>().Named<ILogger>("ConsoleLogger");  // 启用属性注入 builder.RegisterCallback(PropertyInjector.InjectProperties);  var container = builder.Build(); 

现在，当 UserRepository 被解析时，Logger 属性将自动注入，从而实现属性注入。

6. 使用多个ContainerBuilder合并注册

有时候，你可能需要在不同的模块或程序部分中注册组件。对于这种情况，你可以使用多个 ContainerBuilder 对象，并最终将它们合并到一个主容器中。下面是如何实现这一点的示例：

Program.cs（扩展）

在上面的示例中，我们已经创建了一个容器并注册了组件。现在，我们将添加一个额外的 ContainerBuilder，注册另一个组件，然后将它们合并。

// 步骤 7：使用另一个 ContainerBuilder 注册另一个组件 var builder2 = new ContainerBuilder(); builder2.RegisterType<EmailSender>().As<IEmailSender>();  // 步骤 8：合并 ContainerBuilder builder.Update(builder2); 

EmailSender.cs

public interface IEmailSender {     void SendEmail(string to, string subject, string message); }  public class EmailSender : IEmailSender {     public void SendEmail(string to, string subject, string message)     {         Console.WriteLine($"Sending email to {to} with subject: {subject}");         Console.WriteLine($"Message: {message}");     } } 

现在，我们已经注册了一个名为 EmailSender 的额外组件，并将其合并到主容器中。

7. 使用多个 ContainerBuilder 示例

这是完整的示例代码：

Program.cs（完整）

using System; using Autofac;  namespace AutofacExample {     class Program     {         static void Main(string[] args)         {             // 步骤 1：创建 ContainerBuilder             var builder = new ContainerBuilder();              // 步骤 2：注册组件             builder.RegisterType<DatabaseConnection>().As<IDatabaseConnection>().SingleInstance();             builder.RegisterType<UserRepository>().As<IUserRepository>().InstancePerLifetimeScope();             builder.RegisterType<Logger>().As<ILogger>().Named<ILogger>("ConsoleLogger");              // 步骤 3：构建容器             var container = builder.Build();              // 步骤 4：解析组件并进行属性注入             using (var scope = container.BeginLifetimeScope())             {                 var userRepository = scope.Resolve<IUserRepository>();                 userRepository.AddUser("John Doe");                  // 属性注入示例                 var logger = scope.ResolveNamed<ILogger>("ConsoleLogger");                 logger.Log("This is a log message with attribute injection.");             }              // 步骤 7：使用另一个 ContainerBuilder 注册另一个组件             var builder2 = new ContainerBuilder();             builder2.RegisterType<EmailSender>().As<IEmailSender>();              // 步骤 8：合并 ContainerBuilder             builder.Update(builder2);              // 步骤 9：解析新组件             using (var scope = container.BeginLifetimeScope())             {                 var emailSender = scope.Resolve<IEmailSender>();                 emailSender.SendEmail("user@example.com", "Hello", "This is a test email.");             }              Console.WriteLine("Press Enter to exit...");             Console.ReadLine();         }     } } 

这个示例演示了如何使用多个 ContainerBuilder 注册不同的组件，并将它们合并到一个容器中。当程序运行时，它会输出以下内容：

Connected to the database. User 'John Doe' added to the database. Logging: This is a log message with attribute injection. Sending email to user@example.com with subject: Hello Message: This is a test email. Press Enter to exit... 

这表明我们成功注册和合并了不同的组件，并且它们可以一起工作。

Autofac 是一个强大的 .NET 依赖注入容器，它提供了多种注册方式、属性注入以及合并多个 ContainerBuilder 的功能，使你能够更灵活地管理对象的生命周期和解决依赖关系。希望这个示例能够帮助你更好地理解 Autofac 的使用方式，并在你的.NET 项目中更好地应用依赖注入。Autofac 的强大功能使它成为一个优秀的依赖注入容器，适用于各种应用场景。