使用 MSTest 和 .NET Core 进行 C# 单元测试Unit testing C# with MSTest and .NET Core

本文内容

本教程介绍分步构建示例解决方案的交互式体验，以了解单元测试概念。如果希望使用预构建解决方案学习本教程，请在开始前查看或下载示例代码。有关下载说明，请参阅示例和教程。

本文介绍如何测试 .NET Core 项目。如果要测试 ASP.NET Core 项目，请参阅 ASP.NET Core 中的集成测试 。

创建源项目Create the source project

打开 shell 窗口。创建一个名为 unit-testing-using-mstest 的目录，用以保存解决方案 。在此新目录中，运行 dotnet new sln 为类库和测试项目创建新的解决方案文件。接下来，创建 PrimeService 目录。下图显示了当前的目录和文件结构：

  1. /unit-testing-using-mstest
  2.     unit-testing-using-mstest.sln
  3.     /PrimeService

将 PrimeService 作为当前目录，然后运行 dotnet new classlib 以创建源项目。将 Class1.cs 重命名为 PrimeService.cs。创建 PrimeService 类的失败实现：

  1. using System;
  3. namespace Prime.Services
  4. {
  5.     public class PrimeService
  6.     {
  7.         public bool IsPrime(int candidate) 
  8.         {
  9.             throw new NotImplementedException("Please create a test first.");
  10.         } 
  11.     }
  12. }

将目录更改回 unit-testing-using-mstest 目录。运行 dotnet sln add PrimeService/PrimeService.csproj 向解决方案添加类库项目。

创建测试项目Create the test project

接下来，创建 PrimeService.Tests 目录。下图显示了它的目录结构：

  1. /unit-testing-using-mstest
  2.     unit-testing-using-mstest.sln
  3.     /PrimeService
  4.         Source Files
  5.         PrimeService.csproj
  6.     /PrimeService.Tests

将 PrimeService.Tests 目录作为当前目录，并使用 dotnet new mstest 创建一个新项目。dotnet 新命令会创建一个将 MSTest 用作测试库的测试项目。生成的模板在 PrimeServiceTests.csproj 文件中配置测试运行程序：

  1. <ItemGroup>
  2.   <PackageReference Include="Microsoft.NET.Test.Sdk" Version="15.3.0" />
  3.   <PackageReference Include="MSTest.TestAdapter" Version="1.1.18" />
  4.   <PackageReference Include="MSTest.TestFramework" Version="1.1.18" />
  5. </ItemGroup>

测试项目需要其他包创建和运行单元测试。上一步中的 dotnet new 添加了 MSTest SDK、MSTest 测试框架和 MSTest 运行程序。现在，将 PrimeService 类库作为另一个依赖项添加到项目中。使用 dotnet add reference 命令：

  1. dotnet add reference ../PrimeService/PrimeService.csproj

可以在 GitHub 上的示例存储库中看到整个文件。

下图显示了最终的解决方案布局：

  1. /unit-testing-using-mstest
  2.     unit-testing-using-mstest.sln
  3.     /PrimeService
  4.         Source Files
  5.         PrimeService.csproj
  6.     /PrimeService.Tests
  7.         Test Source Files
  8.         PrimeServiceTests.csproj

在 unit-testing-using-mstest 目录中执行 dotnet sln add .\PrimeService.Tests\PrimeService.Tests.csproj。

创建第一个测试Create the first test

编写一个失败测试，使其通过，然后重复此过程。从 PrimeService.Tests 目录删除 UnitTest1.cs，并创建一个名为 PrimeService_IsPrimeShould.cs 且包含以下内容的新 C# 文件：

  1. using Microsoft.VisualStudio.TestTools.UnitTesting;
  2. using Prime.Services;
  4. namespace Prime.UnitTests.Services
  5. {
  6.     [TestClass]
  7.     public class PrimeService_IsPrimeShould
  8.     {
  9.         private readonly PrimeService _primeService;
  11.         public PrimeService_IsPrimeShould()
  12.         {
  13.             _primeService = new PrimeService();
  14.         }
  16.         [TestMethod]
  17.         public void IsPrime_InputIs1_ReturnFalse()
  18.         {
  19.             var result = _primeService.IsPrime(1);
  21.             Assert.IsFalse(result, "1 should not be prime");
  22.         }
  23.     }
  24. }

TestClass 属性表示包含单元测试的类。TestMethod 属性指示方法是测试方法。

保存此文件并执行 dotnet test 以构建测试和类库，然后运行测试。MSTest 测试运行程序包含要运行测试的程序入口点。dotnet test 使用已创建的单元测试项目启动测试运行程序。

测试失败。尚未创建实现。在起作用的 PrimeService 类中编写最简单的代码，使此测试通过：

  1. public bool IsPrime(int candidate)
  2. {
  3.     if (candidate == 1)
  4.     {
  5.         return false;
  6.     }
  7.     throw new NotImplementedException("Please create a test first.");
  8. }

在 unit-testing-using-mstest 目录中，再次运行 dotnet test。dotnet test 命令构建 PrimeService 项目，然后构建 PrimeService.Tests 项目。构建这两个项目后，该命令将运行此单项测试。测试通过。

添加更多功能Add more features

你已经通过了一个测试，现在可以编写更多测试。质数有其他几种简单情况：0、-1。可使用 TestMethod 属性添加新测试，但这很快就会变得枯燥乏味。还有其他 MSTest 属性，使用这些属性可编写类似测试的套件。DataTestMethod 属性表示执行相同代码但具有不同输入参数的测试套件。可以使用 DataRow 属性来指定这些输入的值。

可以不使用这两个属性创建新测试，而用来创建单个数据驱动的测试。数据驱动的测试方法用于测试多个小于 2（即最小质数）的值：

  1. [DataTestMethod]
  2. [DataRow(-1)]
  3. [DataRow(0)]
  4. [DataRow(1)]
  5. public void IsPrime_ValuesLessThan2_ReturnFalse(int value)
  6. {
  7.     var result = _primeService.IsPrime(value);
  9.     Assert.IsFalse(result, $"{value} should not be prime");
  10. }

运行 dotnet test，两项测试均失败。若要使所有测试通过，可以更改方法开头的 if 子句：

  1. if (candidate < 2)

通过在主库中添加更多测试、理论和代码继续循环访问。你将拥有已完成的测试版本和库的完整实现。

你已生成一个小型库和该库的一组单元测试。你已将解决方案结构化，使添加新包和新测试成为了正常工作流的一部分。你已将多数的时间和精力集中在解决应用程序的目标上。

请参阅See also