原文链接： http://docs.autofac.org/en/latest/getting-started/index.html

在程序中使用Autofac的基本模式是：

• 用控制反转（IoC）的思想组织程序。
• 添加对 Autofac 的引用。
• 程序启动阶段
  • 创建 ContainerBuilder 。
  • 注册组件。
  • 生成容器。
• 程序执行阶段
  • 从容器创建生命周期范围对象（ ILifetimeScope 接口）。
  • 使用生命周期范围对象解析组件实例。

本文通过一个简单的控制台程序演示这些步骤。

组织程序

控制反转的基本思路是，不让类创建它的依赖项，而是将依赖项通过构造函数传递给它。请参阅 Martin Fowler 这篇解释依赖注入/控制反转的文章。

在本示例中，我们定义一个输出“今天”的日期的类。但是，我们不想让它和 Console 类捆绑在一起。这有两个原因：1，方便测试，2，在没有Console的环境中也能使用。

我们还对输出日期的方式进行抽象，这样就可以随时切换到另一个版本，比如输出“明天”的日期。

代码：

using System;    namespace DemoApp  {      // 此接口将“输出”概念从Console类解耦。    // 我们只管“输出”，而不关心操作是怎么进行的。    public interface IOutput    {      void Write(string content);    }       // 这里的实现方式是向Console输出内容。    // 也可以用其他方式，比如输出到 Debug 和 Trace。    public class ConsoleOutput : IOutput    {      public void Write(string content)      {        Console.WriteLine(content);      }    }      // 这个接口将“输出日期”的概念从具体的输出方法中解耦。    public interface IDateWriter    {      void WriteDate();    }      // TodayWriter 是这些元素汇合在一起的地方。    // 它的构造函数有一个 IOutput 参数，通过提供不同的实现类，    // TodayWriter可以将日期写到不同的地方。    // 进一步的，在这里WriteDate的实现方式是输出“今天的日期”，    // 我们可以用另一个类输出其他格式，或者其他日期。    public class TodayWriter : IDateWriter    {      private IOutput _output;        public TodayWriter(IOutput output)      {        this._output = output;      }        public void WriteDate()      {        this._output.Write(DateTime.Today.ToShortDateString());      }    }  }

现在我们有了组织良好的依赖关系，接下来引入 Autofac。

添加对 Autofac 的引用

首先向项目添加对Autofac的引用。这个示例中，我们只使用 Autofac 的核心部分。其他类型的应用程序可能需要Autofac 集成库。

最简单的方式是使用 NuGet。“Autofac” 程序包包含所有核心功能。

程序启动阶段

我们在程序启动时创建 ContainerBuilder 对象，然后向它注册组件。组件可以是表达式，.NET 类型, 或者其他暴露服务的代码。组件可以接受其他依赖项。

假设有下面的.net类型：

public class SomeType : IService  {  }

我们有两种使用它的方式:

- 作为这个类型本身, SomeType

- 作为接口, IService

因此, 这里的组件是 SomeType，它暴露的服务是 SomeType 和 IService。

在 Autofac 中,使用 ContainerBuilder 注册组件：

// 创建builder  var builder = new ContainerBuilder();     // 通常仅通过接口暴露服务  builder.RegisterType<SomeType>().As<IService>();     // 但是, 如果同时需要两种服务(不常见)，可以用这种方式：  builder.RegisterType<SomeType>().AsSelf().As<IService>();

在示例程序中，我们要注册全部组件(类)并暴露他们的服务 (接口)，以便他们能连接起来。

我们还需要把容器保存起来，以便稍后使用它解析类型。

using System;  using Autofac;     namespace DemoApp  {      public class Program    {      private static IContainer Container { get; set; }         static void Main(string[] args)      {        var builder = new ContainerBuilder();        builder.RegisterType<ConsoleOutput>().As<IOutput>();        builder.RegisterType<TodayWriter>().As<IDateWriter>();        Container = builder.Build();           // The WriteDate method is where we'll make use        // of our dependency injection. We'll define that        // in a bit.        WriteDate();      }    }  }

现在，容器里注册了全部所需的组件和服务，接下来我们来使用它进行解析。

程序执行阶段

程序执行时，通过从 生存范围 对象解析并使用组件。

容器本身即是一个 生存范围 对象，因此可以从容器直接解析类型，但是并 不推荐这么做 。

解析组件时，根据定义的 实例范围 创建一个新的实例。(解析组件类似于使用new操作符) 有些组件需要清理 (比如实现IDisposable接口) -当 生存范围 对象被清理时，Autofac 可以同时清理它解析的组件。

由于容器对象的生命周期与应用程序相同，如果从容器直接解析了大量内容, 未处理的组件就会越积越多，从而造成资源泄露。

相反，我们从容器创建一个 生存范围 对象，然后通过 生存范围 来解析对象，清理生存范围对象时，从中解析的组件也一同被清理。

(使用 Autofac 集成库时，子范围通常会自动创建。)

对于本示例，“WriteDate” 方法从范围对象获取对象，使用结束时只要清理范围对象。

namespace DemoApp  {    public class Program    {      private static IContainer Container { get; set; }         static void Main(string[] args)      {        // ...the stuff you saw earlier...      }         public static void WriteDate()      {        // Create the scope, resolve your IDateWriter,        // use it, then dispose of the scope.        using (var scope = Container.BeginLifetimeScope())        {          var writer = scope.Resolve<IDateWriter>();          writer.WriteDate();        }      }    }  }

程序的执行过程如下：

• “WriteDate” 方法向 Autofac 请求 IDateWriter 实例。
• Autofac 发现 IDateWriter 映射到 TodayWriter ，于是准备创建一个 TodayWriter 实例。
• Autofac 发现 TodayWriter 的构造函数需要一个IOutput 实例。
• Autofac 发现 IOutput 映射到 ConsoleOutput，于是创建一个ConsoleOutput实例。
• Autofac 使用 ConsoleOutput 实例完成 TodayWriter 的创建。
• Autofac 返回 TodayWriter。

想输出另一个日期时，可以实现另一个 IDateWriter，然后更改启动阶段的注册内容，而不需要更改其他类。这就是控制反转。

注意: 一般而言，普遍认为服务定位是反模式。 (see article) 换言之，随处手工创建范围对象，在代码中零散的使用容器对象是不好的方式。通过使用Autofac 集成库 ，可以避免示例代码中的使用方式。相反，内容在一个位置集中解析，也就是在程序的 “最顶层”位置，极少需要进行手工解析。

更进一步

示例演示了如何使用 Autofac, 您可以继续了解：

• 查看 集成库 列表，了解怎样将 Autofac 集成到程序。
• 了解 注册组件的方式 。
• 了解 Autofac 配置 选项 ，对组件注册进行管理。