NUnit 使用

NUnit 使用
一、简介
　　NUnit是一款堪与JUnit齐名的开源的回归测试框架，供.net开发人员做单元测试之用，可以从www.nunit.org网站上免费获得，最新版本2.2.6。NUnit 2.2.6有5个下载文件，这里用的是NUnit-2.2.6-net-2.0.msi。下载后双击该文件，然后按提示进行安装，这样系统中就具备NUnit环境了。
二、配置类库
　　开发工具我使用的是微软的Visual Studio.net 2005（以下简称vs），打开后点击菜单“文件”->“新建项目”，打开“新建项目”对话框：

在该对话框中，“项目类型”我选择的是“Visual Basic”，如果想使用C#或者J#，请自行选择“其他语言”下的“Visual C#”或“Visual J#”，反正操作差不多，下边也都会介绍到，不过VC就免谈了；“模板”我选的是“控制台应用程序”，您也可以选其它“模板”，我看的例子创建的就是“类库”；名称请自行设定，VB、C#、J#项目我都建了，分别起名为NUnitVB、NUnitCS和NUnitJS，设置好后，点击“确定”按钮。此时项目虽已创建，但尚未保存，请点击“文件”->“全部保存”，打开“保存项目”对话框：

通过“浏览”按钮设置“位置”，我设置的是本机G:/MDZPCK/Microsoft/MySY。
　　下面点击菜单“项目”->“添加引用”，打开“添加引用”对话框：

在“.NET”选项卡中找到组件名称为nunit.framework的一项，点击“确定”按钮，此时在项目中就可以使用NUnit类库了。
三、编写用于测试的类
　　用于测试的类很简单，名为Book，只有id和name两个属性，这两个属性将分别用于两个用例当中。
下面开始编写，请点击菜单“项目”->“添加类”，打开“添加新项”对话框：

在该对话框中，“类”模板被默认选中，请将名称修改为Book.vb或Book.cs、Book.jsl，然后点击“添加”按钮。
　　类创建后，需要修改代码，VB代码如下：
　　Public Class Book
　　　　Dim pid As String = Nothing
　　　　Dim pname As String = Nothing

　　　　Property id() As String
　　　　　　Get
　　　　　　　　Return pid
　　　　　　End Get
　　　　　　Set(ByVal Value As String)
　　　　　　　　pid = Value
　　　　　　End Set
　　　　End Property

　　　　Property name() As String
　　　　　　Get
　　　　　　　　Return pname
　　　　　　End Get
　　　　　　Set(ByVal Value As String)
　　　　　　　　pname = Value
　　　　　　End Set
　　　　End Property
　　End Class
代码比较简单，没什么可说的吧？下边是C#代码：
　　using System;
　　using System.Collections.Generic;
　　using System.Text;

　　namespace NUnitCS
　　{
　　　　public class Book
　　　　{
　　　　　　private string pid = null;
　　　　　　private string pname = null;

　　　　　　public string id
　　　　　　{
　　　　　　　　get
　　　　　　　　{
　　　　　　　　　　return pid;
　　　　　　　　}

　　　　　　　　set
　　　　　　　　{
　　　　　　　　　　pid = value;
　　　　　　　　}
　　　　　　}

　　　　　　public string name
　　　　　　{
　　　　　　　　get
　　　　　　　　{
　　　　　　　　　　return pname;
　　　　　　　　}

　　　　　　　　set
　　　　　　　　{
　　　　　　　　　　pname = value;
　　　　　　　　}
　　　　　　}
　　　　}
　　}
也没什么可说的吧？下边是J#代码：
　　package NUnitJS;

　　public class Book
　　{
　　　　private String pid = null;
　　　　private String pname = null;

　　　　/** @property */
　　　　public void set_id(String value)
　　　　{
　　　　　　pid = value;
　　　　}
　　　　/** @property */
　　　　public String get_id()
　　　　{
　　　　　　return pid;
　　　　}

　　　　/** @property */
　　　　public void set_name(String value)
　　　　{
　　　　　　pname = value;
　　　　}
　　　　/** @property */
　　　　public String get_name()
　　　　{
　　　　　　return pname;
　　　　}
　　}
可以看到，J#代码与VB和C#代码有些不同，因为J#的语法是从Java演变过来的，所以其属性在定义时被拆成了set_XXX和get_XXX这样的两个方法。但仅有set_XXX和get_XXX这样的两个方法还不够，还需要使用@property指令进行说明。虽然用不用@property指令在调用时也没什么区别，但你可以尝试将变量pid和pname更名为id和name，重新编译；而后再将@property指令去掉，再重新编译。真的不一样。
至此，用于测试的类编写完成了。
四、编写测试用例
　　这里只用了一个类进行测试，名为BookTest，以前这样的类可能需要继承NUnit.Framework.TestCase类，但现在只需要对该类使用TestFixture属性进行标识即可，而无须继承了。BookTest类包含两个用例，分别对应该类的testId和testName方法，即每个方法实现了一个测试用例。注意，在NUnit中，这些用来实现测试用例的方法有两种手段进行标识：一个是以testXXX的格式来命名，一个是使用Test属性进行标识。此外，BookTest还有Init和Dispose这两个方法，并分别使用SetUp和TearDown属性来进行标识，前者在每个测试方法开始之前执行，多用来做初始化；后者在每个测试方法完成之后执行，多用来清理资源。注意，这两个方法的名称并没有什么限制，但必须用SetUp和TearDown属性进行标识。另外，NUnit还提供了TestFixtureSetUp和TestFixtureTearDown属性，功能与SetUp和TearDown类似，但前者是在所有用例执行之前做初始化、之后做清理，而后者是在每个用例执行之前做初始化、之后做清理。下面开始编写BookTest。
　　点击菜单“项目”->“添加类”，打开“添加新项”对话框，将名称改为BookTest.vb或BookTest.cs、BookTest.jsl，然后点击“添加”按钮创建该类。修改代码，VB代码如下：
　　Imports NUnit.Framework

　　<TestFixture()> _
　　Public Class BookTest
　　　　Dim bo As Book = Nothing

　　　　<SetUp()> _
　　　　Public Sub Init()
　　　　　　Console.WriteLine("测试开始！")
　　　　　　bo = New Book
　　　　　　Console.WriteLine("book对象被初始化！")
　　　　End Sub

　　　　<Test()> _
　　　　Public Sub testId()
　　　　　　bo.id = "001" '设置id属性的值为
　　　　　　'使用Assert查看id属性的值是否为
　　　　　　Assert.AreEqual("001", bo.id)
　　　　　　Console.WriteLine("id属性被测试！")
　　　　End Sub

　　　　<Test()> _
　　　　Public Sub testName()
　　　　　　bo.name = "ASP" '设置name属性的值为ASP
　　　　　　'使用Assert查看name属性的值是否为JSP，这是个必然出现错误的测试
　　　　　　Assert.AreEqual("JSP", bo.name)
　　　　　　Console.WriteLine("name属性被测试！")
　　　　End Sub

　　　　<TearDown()> _
　　　　Public Sub Dispose()
　　　　　　Console.WriteLine("book对象将被清理！")
　　　　　　bo = Nothing
　　　　　　Console.WriteLine("测试结束！")
　　　　End Sub
　　End Class
这里Init和Dispose方法没什么好说的，就是执行了对book对象的初始化和清理，不过testId和testName需要说明一下。前者是在对bo的id属性进行测试，首先赋值为”001”，然后使用Assert的AreEqual方法查看id属性中存放的值是否是期待的值，由于我的期待值也是”001”，所以执行后这个用例应该是成功的；后者则是对bo的name属性进行测试，也是首先赋值为”ASP”，然后使用Assert的AreEqual方法查看其值是否是期待的，由于我特意将期待值设定为根本不可能的”JSP”，因此这个用例执行后会出现一个错误。但请注意，由于我是特意要让测试出现错误，所以将期待值设定成了不可能的值，如果你是测试人员，请千万不要这么做，否则如果别的地方导致了错误，很容易给自己造成不必要的麻烦。
　　下面简单介绍一下上边用到的静态类NUnit.Framework.Assert。该类主要包含20个方法：
　　1．AreEqual()和AreNotEqual()方法，用来查看两个对象的值是否相等或不等，与对象比较中使用的Equals()方法类似。
　　2．AreSame()和AreNotSame()方法，用来比较两个对象的引用是否相等或不等，类似于通过“Is”或“==”比较两个对象。
　　3．Contains()方法，用来查看对象是否在集合中，集合类型应与System.Collections.IList兼容。示例：
　　　　Dim o As New Object
　　　　Dim al As New ArrayList
　　　　al.Add(o)
　　　　Assert.Contains(o, al)
　　4．Greater()和Less()方法，用来比较两个数值的大小，前者相当于大于号(>)，后者相当于小于号(<)。
　　5．IsInstanceOfType()和IsNotInstanceOfType()方法，用来判断对象是否兼容于指定类型。示例：
　　　　Dim t As Type = New Object().GetType
　　　　Dim s As String = ""
　　　　Assert.IsInstanceOfType(t, s)
由于Object是.net中所有类型的基类，String类型兼容于Object，因此这个示例是能够运行通过的。而下边这个示例运行将是失败的：
　　　　Dim t As Type = New ArrayList().GetType
　　　　Dim s As String = ""
　　　　Assert.IsInstanceOfType(t, s)
　　6．IsAssignableFrom()和IsNotAssignableFrom()方法，用来判断对象是否是指定类型的实例。示例：
　　　　Dim t As Type = New Object().GetType
　　　　Dim s As String = ""
　　　　Assert.IsAssignableFrom(t, s)
这个示例与之前的示例是一样的，但由于字符串s不是Object类型的，因此无法运行通过。而下边这个实例可以运行通过：
　　　　Dim t As Type = New String("").GetType
　　　　Dim s As String = ""
　　　　Assert.IsAssignableFrom(t, s)
　　7．IsFalse()和IsTrue()方法，用来查看变量是是否为false或true，如果IsFalse()查看的变量的值是false则测试成功，如果是true则失败，IsTrue()与之相反。
　　8．IsNull()和IsNotNull()方法，用来查看对象是否为空和不为空。
　　9．IsEmpty()和IsNotEmpty()方法，用来判断字符串或集合是否为空串或没有元素，其中集合类型应与ICollection兼容。
　　10．IsNaN()方法，用来判断指定的值是否不是数字。
　　11．Fail()方法，意为失败，用来抛出错误。我个人认为有两个用途：首先是在测试驱动开发中，由于测试用例都是在被测试的类之前编写，而写成时又不清楚其正确与否，此时就可以使用Fail方法抛出错误进行模拟；其次是抛出意外的错误，比如要测试的内容是从数据库中读取的数据是否正确，而导致错误的原因却是数据库连接失败。
　　12．Ignore()方法，意为忽略，用来忽略后续代码的执行，用途可以参考Fail()方法。
此外，NUnit还提供了一个专用于字符串的静态类NUnit.Framework. StringAssert，该类主要包含4个方法：
　　1．Contains()方法，用来查看指定的第二个字符串中是否包含了第一个字符串。
　　2．StartsWith ()和EndsWith ()方法，分别用来查看指定的第一个字符串是否位于第二个字符串的开头和结尾。
　　3．AreEqualIgnoringCase()方法，用来比较两个字符串是否相等。
　　下面再看一下C#代码：
　　using System;
　　using System.Collections.Generic;
　　using System.Text;
　　using NUnit.Framework;

　　namespace NUnitCS
　　{
　　　　[TestFixture]
　　　　public class BookTest
　　　　{
　　　　　　Book book = null;

　　　　　　[SetUp]
　　　　　　public void Init()
　　　　　　{
　　　　　　　　Console.WriteLine("测试开始！");
　　　　　　　　book = new Book();
　　　　　　　　Console.WriteLine("book对象被初始化！");
　　　　　　}

　　　　　　[Test]
　　　　　　public void testId()
　　　　　　{
　　　　　　　　book.id = "001"; //设置id属性的值为
　　　　　　　　//使用Assert查看id属性的值是否为
　　　　　　　　Assert.AreEqual("001", book.id);
　　　　　　　　Console.WriteLine("id属性被测试！");
　　　　　　}

　　　　　　[Test]
　　　　　　public void testName()
　　　　　　{
　　　　　　　　book.name = "ASP"; //设置name属性的值为ASP
　　　　　　　　//使用Assert查看name属性的值是否为JSP，这是个必然出现错误的测试
　　　　　　　　Assert.AreEqual("JSP", book.name);
　　　　　　　　Console.WriteLine("name属性被测试！");
　　　　　　}

　　　　　　[TearDown]
　　　　　　public void Dispose()
　　　　　　{
　　　　　　　　Console.WriteLine("book对象将被清理！");
　　　　　　　　book = null;
　　　　　　　　Console.WriteLine("测试结束！");
　　　　　　}
　　　　}
　　}
没什么好说的吧？下面看J#代码：
　　package NUnitJS;

　　import System.*;
　　import NUnit.Framework.*;

　　/** @attribute TestFixture() */
　　public class BookTest
　　{
　　　　Book book = null;

　　　　/** @attribute SetUp() */
　　　　public void Init()
　　　　{
　　　　　　Console.WriteLine("测试开始！");
　　　　　　book = new Book();
　　　　　　Console.WriteLine("book对象被初始化！");
　　　　}

　　　　/** @attribute Test() */
　　　　public void testId()
　　　　{
　　　　　　book.set_id("001"); //设置id属性的值为001
　　　　　　//使用Assert查看id属性的值是否为001
　　　　　　Assert.AreEqual("001", book.get_id());
　　　　　　Console.WriteLine("id属性被测试！");
　　　　}

　　　　/** @attribute Test() */
　　　　public void testName()
　　　　{
　　　　　　book.set_id("ASP"); //设置name属性的值为ASP
　　　　　　//使用Assert查看name属性的值是否为JSP，这是个必然出现错误的测试
　　　　　　Assert.AreEqual("JSP", book.get_name());
　　　　　　Console.WriteLine("name属性被测试！");
　　　　}

　　　　/** @attribute TearDown() */
　　　　public void Dispose()
　　　　{
　　　　　　Console.WriteLine("book对象将被清理！");
　　　　　　book = null;
　　　　　　Console.WriteLine("测试结束！");
　　　　}
　　}
改好后，点击菜单“调试”->“启动调试”或按F5键运行程序。等等，main函数里头好象一句代码也没写过呢吧？没错，一句也没写，不过你照做就可以了。在看到黑屏一闪之后，编码工作完成。
五、运行NUnit
　　编码完成后，就可以使用NUnit测试了。NUnit有两种界面，一种是命令行的，一种是可视化的，我使用的就是后者。点击“开始”菜单->“所有程序”->“NUnit-Net-2.0 2.2.6”->“NUnit-Gui”，打开NUnit的可视化界面：

点击菜单“File”->“Open”，打开刚才运行生成的可执行文件：

此时就可以使用BookTest类对Book类进行测试了。请首先选择testId，点击“Run”按钮，运行结果如下图：

testId前的灰点变绿，而且进度条显示为绿条，这表明运行成功。下面再选择BookTest，点击“Run”按钮，运行结果如下图：

testId前的点依然是绿色，但testName前的点是红色，而且进度条显示为红条，这表明testName中存在错误。不过这个错误是预计之内的，如果不想看到，可以在vs中将testName()方法中的”JSP”改成”ASP”，然后重新运行。此时无须重新启动NUnit，NUnit会自动加载重新编写好的文件。此时再运行BookTest，进度条已不是红色，而是绿色了。
NUnit2.0详细使用方法
前一段时间,有人问我在.NET里如何进行TDD开发.这个问题促使我想对NUnit做一个详细的介绍.因为我们大家都知道NUnit是在.NET进行TDD的利器.

       如果你已经知道很多关于NUnit的应用,请指出我的不对之处和提出一些建议，使本文更加完善.如果你对NUnit还不是很了解的话,我建议你还是阅读一下.

     本文分为以下部分:

1. TDD的简介

首先什么是TDD呢?Kent Beck在他的<<测试驱动开发 >>(Addison-Wesley Professional,2003)一书中,使用下面2个原则来定义TDD:

·        除非你有一个失败的自动测试,永远不要写一单行代码.

·        阻止重复

       我想第一个原则是显而易见的.在没有失败的自动测试下就不要写代码.因为测试是嵌入在代码必须满足的需求中.如果没有需求,就没有必要实现任何东西.所以这个原则阻止我们去实现那些没有测试和在解决方案中不需要的功能.

第二个原则说明了在一个程序中,不应该包含重复的代码.如果代码重复,我想这就是不好的软件设计的象征.随着时间的流逝,它会对程序造成不一致的问题,并且使代码变非常混乱 ,因为我们时常不会记得重复代码的位置.如果发现代码重复,我想我们应该立即删除代码重复.其实这就涉及到重构了.在这里我就不多讲了.

一般来说,测试分为2种类型,一是程序员自己的测试,另外一种是客户的测试.关于客户测试，我推荐一个FIT的框架，非常不错。在这里，我们讲的TDD就是程序员测试.那么什么是程序员测试呢?我认为就是我们常说的单元测试.既然是单元测试,在.NET里势必会用到某些工具,目前最著名恐怕就是我即将介绍的NUnit了,

2.NUnit的介绍

NUnit是一个单元测试框架,专门针对于.NET来写的.其实在前面有
JUnit(Java),CPPUnit(C++),他们都是xUnit的一员.最初,它是从JUnit而来.现在的版本是2.2.接下来我所用的都是基于这个版本.

NUnit最初是由James W. Newkirk, Alexei A. Vorontsov 和Philip A. Craig, 后来开发团队逐渐庞大起来.在开发过程中, Kent Beck 和Erich Gamma2位牛人也提供了许多帮助.看来对于NUnit还真是下了一番力气了.J

NUnit是xUnit家族种的第4个主打产品,完全由C#语言来编写,并且编写时充分利用了许多.NET的特性,比如反射,客户属性等等.

最重要的一点是它适合于所有.NET语言.

      如果你还没有下载,可以到http://www.nunit.org/去下载.

2.1 NUnit的介绍

   Ok,下面正式讲解NUnit.在讲解之前,看看几张图片:



图1 NUnit运行的效果

                     图2   NUnit运行的另外一个效果

       从中我们可以非常容易发现,右边是个状态条,图1是红色的,图2是绿色的.为什么会这样呢?因为如果所有测试案例运行成功,就为绿色,反之如果有一个不成功,则为红色,但也有黄色的.左面的工作域内则是我们写的每一个单元测试.

通过上面的图片,我想你对NUnit有个总的了解了.

接下来还是分为2个部分,一是NUnit的布局,另外一部分就是它的核心概念.

首先熟悉一下NUnit GUI的布局.

让我们更进一步看一下测试运行器窗口的布局。在右边面板的中间，可以看到测试进度条。进度条的颜色反映了测试执行的状态：

绿色描述目前所执行的测试都通过

黄色意味某些测试忽略，但是这里没有失败

红色表示有失败

底部的状态条表示下面的状态：

状态.说明了现在运行测试的状态。当所有测试完成时，状态变为Completed.运行测试中，状态是Running: <test-name> (<test-name>是正在运行的测试名称)。

Test Cases说明加载的程序集中测试案例的总个数。这也是测试树里叶子节点的个数。

Tests Run 已经完成的测试个数。

Failures 到目前为止，所有测试中失败的个数.

Time 显示运行测试时间（以秒计）

File主菜单有以下内容：

New Project允许你创建一个新工程。工程是一个测试程序集的集合。这种机制让你组织多个测试程序集，并把他们作为一个组对待。

Open 加载一个新的测试程序集，或一个以前保存的NUnit工程文件。

Close关闭现在加载的测试程序集或现在加载的NUnit工程。

Save 保存现在的Nunit工程到一个文件。如果正工作单个程序集，本菜单项允许你创建一个新的NUnit工程，并把它保存在文件里。

Save As允许你将现有NUnit工程作为一个文件保存。

Reload 强制重载现有测试程序集或NUnit工程。NUnit-Gui自动监测现加载的测试程序集的变化。

当程序集变化时，测试运行器重新加载测试程序集。（当测试正运行时，现在加载的测试程序集不会重新加载。在测试运行之间测试程序集仅可以重新加载。一个忠告：如果测试程序集依赖另外一个程序集，测试运行器不会观察任何依赖的程序集。对测试运行器来说，强制一个重载使全部依赖的程序集变化可见。

Recent Files 说明5个最近在NUnit中加载的测试程序集或NUnit工程（这个列表在Windows注册表，由每个用户维护，因此如果你共享你的PC，你仅看到你的测试）。最近程序集的数量可以使用Options菜单项修改，可以访问Tool主菜单。

Exit退出。

View菜单有以下内容：

Expand一层层扩展现在树中所选节点

Collapse 折叠现在树中选择的节点

Expand All递归扩展树中所选节点后的所有节点

Collapse All递归折叠树中所选节点后的所有节点

Expand Fixtures扩展树中所有代表测试fixture的节点。

Collapse Fixtures 折叠树中所有代表测试fixture的节点。

Properties 显示树中现所选节点的属性。

Tools 菜单由这些项:

Save Results as XML作为一XML文件保存运行测试的结果。

Options让你定制NUnit的行为。

现在看看右边，你已经熟悉Run按钮和进度条。这里还有一个紧跟Run按钮的Stop按钮：点击这个按钮会终止执行正运行的测试。进度条下面是一个文本窗口，在它上方，由以下4个标签：

Errors and Failures 窗口显示失败的测试。在我们的例子里，这个窗口是空。

Tests Not Run 窗口显示没有得到执行的测试。

Console.Error 窗口显示运行测试产生的错误消息。这些此消息是应用程序代码使用Console.Error输出流可以输出的。

Console.Out窗口显示运行测试打印到Console.Error输出流的文本消息。

2.2 一些常用属性

        接下来,我将讲述这个框架如何使用.同时也涉及到一些非常重要的概念,我想其客户属性是非常重要的.在NUnit里,有以下几种属性:
- Test Fixture
- Test
下面我将对每种属性一一讲解.

TestFixtureAttribute

本属性标记一个类包含测试,当然setup和teardown方法可有可无.(关于setup 和teardown方法在后面介绍)

做为一个测试的类,这个类还有一些限制
- 必须是Public,否则NUnit看不到它的存在.
- 它必须有一个缺省的构造函数,否则是NUnit不会构造它.
- 构造函数应该没有任何副作用,因为NUnit在运行时经常会构造这个类多次,如果要是构造函数要什么副作用的话,那不是乱了.
举个例子
```
 
  1  using System;
 2  using NUnit.Framework;
 3  namespace MyTest.Tests
 4{
 5
 6  [TestFixture]
 7  public class PriceFixture
 8  {
 9    // 
10  }
11}
12
 
 
```
TestAttribute

Test属性用来标记一个类(已经标记为TestFixture)的某个方法是可以测试的.为了和先前的版本向后兼容,头4个字符(“test”)忽略大小写.
(参看http://nunit.org/test.html)

这个测试方法可以定义为:
```
       
 public void MethodName()
 
```
从上面可以看出,这个方法没有任何参数,其实测试方法必须没有参数.如果我们定义方法不对的话,这个方法不会出现在测试方法列表中.也就是说在NUnit的界面左边的工作域内,看不到这个方法.还有一点就是这个方法不返回任何参数,并且必须为Public.

例如:
```
 
  1using System;
 2using NUnit.Framework;
 3
 4namespace MyTest.Tests
 5{
 6  [TestFixture]
 7  public class SuccessTests
 8  {
 9    [Test] public void Test1()
10    { /**//*  */ }
11  }
12}
13
14
 
```
```
一般来说,有了上面两个属性,你可以做基本的事情了.
```
```
另外，我们再对如何进行比较做一个描述。
```
```
在NUnit中，用Assert（断言）进行比较，Assert是一个类，它包括以下方法：
AreEqual，AreSame，Equals， Fail，Ignore，IsFalse，IsNotNull，
具体请参看NUnit的文档。
```
3.如何在.NET中应用NUnit

我将举个例子,一步一步演示如何去使用NUnit.

第1步.为测试代码创建一个Visual Studio工程。

在Microsoft Visual Studio .NET中，让我们开始创建一个新的工程。选择Visual C#工程作为工程类型，Class Library作为模板。将工程命名为NUnitQuickStart.图4-1是一个描述本步骤的Visual Studio .NET。

                            图 4-1: 创建第一个NUnit工程

第2步.增加一个NUnit框架引用

在Microsoft Visual Studio .NET里创建这个例子时，你需要增加一个nunit.framework.dll引用，如下：

在Solution Explorer右击引用，然后选择增加引用

   nunit.framework组件，在Add Reference对话框中按Select和OK按钮。

图4-2 描述了这步:

图 4-2: 增加一个 nunit.framework.dll 引用到工程

第3步.为工程加一个类.

为工程加一个NumbersFixture类。这里是这个例子的代码。

1using System;
2using NUnit.Framework;
3
4namespace NUnitQuickStart
5{
6            [TestFixture]
7            public class NumersFixture
8            {
9                        [Test]
10                        public void AddTwoNumbers()
11                        {
12                                    int a=1;
13                                    int b=2;
14                                    int sum=a+b;
15                                    Assert.AreEqual(sum,3);
16                        }
17            }
18}
19

第4步.建立你的Visual Studio 工程，使用NUnit-Gui测试

从程序->NUnit2.2打开NUnit-gui,加载本本工程编译的程序集.

为了在Visual Studio .NET中自动运行NUnit-Gui，你需要建立NUnit-Gui作为你的启动程序：

在 Solution Explorer里右击你的NunitQuickStart工程。

在弹出菜单中选择属性。

在显示的对话框的左面，点击Configuration Properties夹

选择出现在Configuration Properties夹下的Debugging。

在属性框右边的Start Action部分，选择下拉框的Program作为Debug Mode值。

按Apply按钮

设置nunit-gui.exe 作为Start Application。，你既可以键入nunit-gui.exe的全路径，也可使用浏览按钮来指向它。

图4-3 帮助描述本步骤:


图 4-3:将NUnit-Gui 作为工程的测试运行器

第5步.编译运行测试.

现在编译solution。成功编译后，开始应用程序。NUnit-Gui测试运行器出现。当你第一次开始NUnit-Gui，它打开时没有测试加载。从File菜单选择Oprn，浏览NUnitQuickStart.dll的路径。当你加载了测试的程序集，测试运行器为加载的程序集的测试产生一个可见的表现。在例子中，测试程序集仅有一个测试，测试程序集的结构如图4－4所示：

图 4-4: 测试程序集的测试在 NUnit-Gui中的视图

按Run按钮。树的节点变为绿色，而且测试运行器窗口上的进度条变绿，绿色代表成功通过。

4.其他的一些核心概念

   上面的例子介绍了基本的NUnit特性和功能. TestFixture, Test, 和 Assert是3个最基本的特征,我们可以用这些特性进行程序员测试了.但是有的时候,你觉得这3个远远不够,比如有的时候打开一个数据库连接多次,有没有只让它打开一次的方法呢?如果我想把测试分类,应该怎样实现呢?如果我想忽略某些测试,又应该如何去完成呢?不用担心,NUnit已经有这样的功能了.

下面我们一一作出回答.

SetUp/TearDown 属性

在早期给的test fixture定义里,我们说test fixture的测试是一组常规运行时资源.在测试完成之后,或是在测试执行种,或是释放或清除之前,这些常规运行时资源在一确定的方式上可能需要获取和初始化.NUnit使用2个额外的属性:SetUp 和TearDown,就支持这种常规的初始化/清除.我们上面的例子来描述这个功能.让我们增加乘法.

1using System;
2using NUnit.Framework;
3
4namespace NUnitQuickStart
5{
6            [TestFixture]
7            public class NumersFixture
8            {
9                        [Test]
10                        public void AddTwoNumbers()
11                        {
12                                    int a=1;
13                                    int b=2;
14                                    int sum=a+b;
15                                    Assert.AreEqual(sum,3);
16                        }
17                        [Test]
18                        public void MultiplyTwoNumbers()
19                        {
20                                    int a = 1;
21                                    int b = 2;
22                                    int product = a * b;
23                                    Assert.AreEqual(2, product);
24                        }
25
26            }
27}
28

   我们仔细一看,不对,有重复的代码,如何去除重复的代码呢?我们可以提取这些代码到一个独立的方法,然后标志这个方法为SetUp 属性,这样2个测试方法可以共享对操作数的初始化了,这里是改动后的代码:

1using System;
2using NUnit.Framework;
3
4namespace NUnitQuickStart
5{
6            [TestFixture]
7            public class NumersFixture
8            {
9                        private int a;
10                        private int b;
11                        [SetUp]
12                        public void InitializeOperands()
13                        {
14                                    a = 1;
15                                    b = 2;
16                        }
17
18                        [Test]
19                        public void AddTwoNumbers()
20                        {
21                                    int sum=a+b;
22                                    Assert.AreEqual(sum,3);
23                        }
24                        [Test]
25                        public void MultiplyTwoNumbers()
26                        {
27                                    int product = a * b;
28                                    Assert.AreEqual(2, product);
29                        }
30
31            }
32}
33
```
   这样NUnit将在执行每个测试前执行标记SetUp属性的方法.
在本例中就是执行InitializeOperands()方法.记住，这里这个方法必须为
public，不然就会有以下错误：
Invalid Setup or TearDown method signature
```
ExpectedException

这里是一个验证这个假设的测试.有的时候,我们知道某些操作会有异常出现,例如, 在实例中增加除法,某个操作被0除,抛出的异常和.NET文档描述的一样.参看以下源代码.
```
 1[Test]
2[ExpectedException(typeof(DivideByZeroException))]
3public void DivideByZero()
4{
5   int zero = 0;
6   int infinity = a/zero;
7   Assert.Fail("Should have gotten an exception");
8}
9
 
```
除了[Test]属性之外, DivideByZero方法有另外一个客户属性: ExpectedException.在这个属性里,你可以在执行过程中捕获你期望的异常类型,例如在本例就是DivideByZeroException.如果这个方法在没有抛出期望异常的情况下完成了,这个测试失败.使用这个属性帮助我们写程序员测试验证边界条件(Boundary Conditions).

Ignore 属性

由于种种原因,有一些测试我们不想运行.当然,这些原因可能包括你认为这个测试还没有完成,这个测试正在重构之中,这个测试的需求不是太明确.但你有不想破坏测试,不然进度条可是红色的哟.怎么办?使用Ignore属性.你可以保持测试,但又不运行它们.让我们标记MultiplyTwoNumbers测试方法为Ignore属性:
```
 1[Test]
2[Ignore("Multiplication is ignored")]
3public void MultiplyTwoNumbers()
4{
5   int product = a * b;
6   Assert.AreEqual(2, product);
7}
 
```
   运行测试,现在产生了下面的输出(在图5-1显示):

图 5-1: 在一个程序员测试中使用 Ignore属性

   Ignore属性可以附加到一个独立的测试方法,也可以附加到整个测试类(TestFixture).如果Ignore属性附加到TestFixture,所有在fixture的测试都被忽略.

TestFixtureSetUp/TestFixtureTearDown

   有时,一组测试需要的资源太昂贵.例如,数据库连接可能是一个关键资源,在一个test fixture的每个测试中,打开/关闭数据库连接可能非常慢.这就是我在开始提到的问题.如何解决?NUnit有一对类似于前面讨论的SetUp/TearDown的属性: TestFixtureSetUp/TestFixtureTearDown.正如他们名字表明的一样,这些属性用来标记为整个test fixture初始化/释放资源方法一次的方法.

   例如,如果你想为所有test fixture的测试共享相同的数据库连接对象,我们可以写一个打开数据库连接的方法,标记为TestFixtureSetUp属性,编写另外一个关闭数据库连接的方法,标记为TestFixtureTearDown属性.这里是描述这个的例子.
```
  1using NUnit.Framework;
 2
 3[TestFixture]
 4public class DatabaseFixture
 5{
 6   [TestFixtureSetUp]
 7   public void OpenConnection()
 8   {
 9      //open the connection to the database
10   }
11 
12   [TestFixtureTearDown]
13   public void CloseConnection()
14   {
15      //close the connection to the database
16   }
17   
18   [SetUp]
19   public void CreateDatabaseObjects()
20   {
21      //insert the records into the database table
22   }
23 
24   [TearDown]
25   public void DeleteDatabaseObjects()
26   {
27      //remove the inserted records from the database table
28   }
29 
30   [Test]
31   public void ReadOneObject()
32   {
33      //load one record using the open database connection
34   }
35 
36   [Test]
37   public void ReadManyObjects()
38   {
39      //load many records using the open database connection
40   }
41}
42
43
 
```
Test Suite

   Test Suite是test case或其他test suite的集合. 合成(Composite)^,模式描述了test case和test suite之间的关系.

参考来自NUnit的关于Suite的代码

Suite Attribute

1namespace NUnit.Tests
2{
3using System;
4  using NUnit.Framework;
5
6
7
8  public class AllTests
9  {
10    [Suite]
11    public static TestSuite Suite
12    {
13      get
14      {
15        TestSuite suite = new TestSuite("All Tests");
16        suite.Add(new OneTestCase());
17        suite.Add(new Assemblies.AssemblyTests());
18        suite.Add(new AssertionTest());
19        return suite;
20      }
21    }
22  }
23}
24

Category属性

对于测试来说，你有的时候需要将之分类，此属性正好就是用来解决这个问题的。

你可以选择你需要运行的测试类目录，也可以选择除了这些目录之外的测试都可以运行。在命令行环境里 /include 和/exclude来实现。在GUI环境下，就更简单了，选择左边工作域里的Catagories Tab，选择Add和Remove既可以了。

在上面的例子上做了一些改善，代码如下：
```
  1using System; 
 2using NUnit.Framework; 
 3  
 4namespace NUnitQuickStart 
 5{ 
 6            [TestFixture] 
 7            public class NumersFixture 
 8            { 
 9                        private int a; 
10                        private int b; 
11                        [SetUp] 
12                        public  void InitializeOperands() 
13                        { 
14                                    a = 1; 
15                                    b = 2; 
16                        } 
17  
18                        [Test] 
19                        [Category("Numbers")] 
20                        public void AddTwoNumbers() 
21                        { 
22                                    int sum=a+b; 
23                                    Assert.AreEqual(sum,3); 
24                        } 
25                        
26                        [Test] 
27                [Category("Exception")] 
28                        [ExpectedException(typeof(DivideByZeroException))] 
29                        public void DivideByZero() 
30                        { 
31                                    int zero = 0; 
32                                    int infinity = a/zero; 
33                                    Assert.Fail("Should have gotten an exception"); 
34                        } 
35                        [Test] 
36                        [Ignore("Multiplication is ignored")] 
37                        [Category("Numbers")] 
38                        public void MultiplyTwoNumbers() 
39                        { 
40                                    int product = a * b; 
41                                    Assert.AreEqual(2, product); 
42                        } 
43  
44               } 
45
 
        NUnit-GUI界面如图5-2：
```
```
 
```
```
图5-2:使用Catagories属性的界面
```
Explicit属性

本属性忽略一个test和test fixture，直到它们显式的选择执行。如果test和test fixture在执行的过程中被发现，就忽略他们。所以，这样一来进度条显示为黄色，因为有test或test fixture忽略了。

例如：



1
2                        [Test,Explicit]
3                        [Category("Exception")]
4                        [ExpectedException(typeof(DivideByZeroException))]
5                        public void DivideByZero()
6                        {
7                                    int zero = 0;
8                                    int infinity = a/zero;
9                                    Assert.Fail("Should have gotten an exception");
10                        }
11

    为什么会设计成这样呢？原因是Ingore属性忽略了某个test或test fixture，那么他们你再想调用执行是不可能的。那么万一有一天我想调用被忽略的test或test fixture怎么办，就用Explicit属性了。我想这就是其中的原因吧。

Expected Exception属性

期望在运行时抛出一个期望的异常，如果是，则测试通过，否则不通过。

参看下面的例子：

1[Test]
2[ExpectedException(typeofInvalidOperationException))]
3public void ExpectAnException()
4 {
5   int zero = 0;
6   int infinity = a/zero;
7   Assert.Fail("Should have gotten an exception");
8
9 }
10

    在本测试中，应该抛出DivideByZeroException，但是期望的是InvalidOperationException，所以不能通过。
如果我们将[ExpectedException(typeof(InvalidOperationException))]改为[ExpectedException(typeof(DivideByZeroException))]，本测试通过。

5 . 测试生命周期合约

   如果记得test case的定义,其中一个属性是测试的独立性或隔离性.SetUp/TearDown方法提供达到测试隔离性的目的.SetUp确保共享的资源在每个测试运行前正确初始化,TearDown确保没有运行测试产生的遗留副作用. TestFixtureSetUp/TestFixtureTearDown同样提供相同的目的,但是却在test fixture范围里,我们刚才描述的内容组成了测试框架的运行时容器(test runner)和你写的测试之间的生命周期合约(life-cycle contract).

   为了描述这个合约,我们写一个简单的测试来说明什么方法调用了,怎么合适调用的.这里是代码:
```
  1using System;
 2using NUnit.Framework;
 3[TestFixture]
 4public class LifeCycleContractFixture
 5{
 6   [TestFixtureSetUp]
 7   public void FixtureSetUp()
 8   {
 9      Console.Out.WriteLine("FixtureSetUp");
10   }
11 
12   [TestFixtureTearDown]
13   public void FixtureTearDown()
14   {
15      Console.Out.WriteLine("FixtureTearDown");
16   }
17   
18   [SetUp]
19   public void SetUp()
20   {
21      Console.Out.WriteLine("SetUp");
22   }
23
24   [TearDown]
25   public void TearDown()
26   {
27      Console.Out.WriteLine("TearDown");
28   }
29 
30   [Test]
31   public void Test1()
32   {
33      Console.Out.WriteLine("Test 1");
34   }
35
36   [Test]
37   public void Test2()
38   {
39      Console.Out.WriteLine("Test 2");
40   }
41
42}
43
44
 
```
当编译和运行这个测试,可以在System.Console窗口看到下面的输出:
```
 FixtureSetUp
SetUp
Test 1
TearDown
SetUp
Test 2
TearDown
FixtureTearDown
 
```
可以看到, SetUp/TearDown方法调用在每个测试方法的前后. 整个fixture调用一次TestFixtureSetUp/TestFixtureTearDown方法.

作者：Milestone

下载:
1)NUnit的应用文档下载
2)本问的PDF版下载

3)源代码下载
相关阅读:
Revit二次开发示例：DisableCommand
Revit二次开发示例：DesignOptions
C# 非模式窗体show()和模式窗体showdialog()的区别
 Revit二次开发示例：DeleteObject
被动永远做不好运维
 sudo开发常用命令总结
 ansible 配置了端口在host文件但是还要走22 ip:60001 ansible_ssh_port=60001
ansible wc -l 对结果值取大小的操作
 mha切换脚本可用的
 mongoDB自动杀执行时间的连接
原文地址：https://www.cnblogs.com/encounter/p/2188871.html

1. TDD的简介

2.NUnit的介绍

2.1 NUnit的介绍

2.2 一些常用属性

TestFixtureAttribute

TestAttribute

3.如何在.NET中应用NUnit

第1步.为测试代码创建一个Visual Studio工程。

第2步.增加一个NUnit框架引用

第3步.为工程加一个类.

第4步.建立你的Visual Studio 工程，使用NUnit-Gui测试

第5步.编译运行测试.

4.其他的一些核心概念

SetUp/TearDown 属性

ExpectedException

Ignore 属性

TestFixtureSetUp/TestFixtureTearDown

Test Suite

Explicit属性

Expected Exception属性

5 . 测试生命周期合约