NSubstitute完全手册（二）创建替代实例

创建一个替代实例的基本语法：

var substitute = Substitute.For<ISomeInterface>();

这就是通常情况下你创建一个类型的替代实例的方法。一般来说，这个类型是一个接口，但是在一些特殊情况下，也可以对类进行替代。

警告：类的替代可能会有一些不太好的副作用。NSubstitute 只能作用于类中的虚拟成员，所以类中的任何非虚成员代码将都会被真实的执行。如果你尝试替代一个类，而该类会在其构造函数或某个非虚属性中格式化硬盘，那么你就是自讨苦吃了。如果可能的话，请坚持只替代接口类型。

在知道了我们不会替代类类型之后，此处描述如何为一个具有含参构造函数的类创建替代实例：

var someClass = Substitute.For<SomeClassWithCtorArgs>(5, "hello world");

对于具有默认构造函数的类，创建其替代实例的语法与替代接口一样。

替代多个接口

有些时候，你可能需要为多个类型创建替代实例。一个最好的例子就是，当你有代码使用了某类型后，需要检查是否其实现了 IDisposable 接口，并且确认是否调用了 Dispose 进行类型销毁。

    public interface ICommand : IDisposable 
    {
      void Execute();
    }

    public class CommandRunner
    {
      private ICommand _command;

      public CommandRunner(ICommand command)
      {
        _command = command;
      }

      public void RunCommand()
      {
        _command.Execute();
        _command.Dispose();
      }
    }

    [TestMethod]
    public void Test_CreatingSubstitute_MultipleInterfaces()
    {
      var command = Substitute.For<ICommand, IDisposable>();

      var runner = new CommandRunner(command);
      runner.RunCommand();

      command.Received().Execute();
      ((IDisposable)command).Received().Dispose();
    }

通过这种方法，替代实例可以实现多个类型。但请记住，一个类最多只能实现一个类。如果你愿意的话，你可以指定多个接口，但是其中只能有一个是类类型。为多个类型创建替代实例的最灵活的方式是使用重载。

    public class SomeClassWithCtorArgs : IDisposable
    {
      public SomeClassWithCtorArgs(int arg1, string arg2)
      {
      }

      public void Dispose() { }
    }

    [TestMethod]
    public void Test_CreatingSubstitute_SpecifiedOneClassType()
    {
      var substitute = Substitute.For(
            new[] { typeof(ICommand), typeof(IDisposable), typeof(SomeClassWithCtorArgs) },
            new object[] { 5, "hello world" }
          );
      Assert.IsInstanceOfType(substitute, typeof(ICommand));
      Assert.IsInstanceOfType(substitute, typeof(IDisposable));
      Assert.IsInstanceOfType(substitute, typeof(SomeClassWithCtorArgs));
    }

替代委托

通过使用 Substiute.For<T>() 语法，NSubstitute 可以为委托类型创建替代。当为委托类型创建替代时，将无法使该替代实例实现额外的接口或类。

    [TestMethod]
    public void Test_CreatingSubstitute_ForDelegate()
    {
      var func = Substitute.For<Func<string>>();
      func().Returns("hello");
      Assert.AreEqual<string>("hello", func());
    }

NSubstitute 完全手册

• （一）入门基础
• （二）创建替代实例
• （三）设置返回值
• （四）为特定参数设置返回值
• （五）为任意参数设置返回值
• （六）使用函数设置返回值
• （七）设置多个返回值
• （八）替换返回值
• （九）检查接收到的调用
• （十）清理已收到的调用
• （十一）参数匹配器
• （十二）使用回调函数和WhenDo语法
• （十三）抛出异常
• （十四）引发事件
• （十五）自动递归模拟
• （十六）设置out和ref参数
• （十七）参数匹配器上的操作
• （十八）检查调用顺序