.Net 5 XUnit 单元测试

• .Net 5 XUnit 单元测试
  • Demo
    • 创建项目
    • 添加相关代码
    • 测试代码
  • 属性
  • 属性说明
  • Fact
  • Theory
  • MemberData
    • 无参数数据源
    • 带参数据源（方法）
    • 定义类型

xUnit.net 是一个免费的、开源的、以社区为中心的 .NET Framework 单元测试工具。xUnit.net 由 NUnit v2 的原始发明者编写，是用于单元测试 C#、F#、VB.NET 和其他 .NET 语言的最新技术。xUnit.net 可与 ReSharper、CodeRush、TestDriven.NET 和 Xamarin 一起使用。它是.NET 基金会的一部分，按照他们的行为准则运作。它在Apache 2（OSI 批准的许可证）下获得许可。

Demo

创建项目

添加相关代码

public class UnitTest1
{
    [Fact]
    public void PassingTest()
    {
        Assert.Equal(4, Add(2, 2));
    }
    [Fact]
    public void FailingTest()
    {
        Assert.Equal(5, Add(2, 2));
    }
    int Add(int x, int y)
    {
        return x + y;
    }
}

测试代码

属性

属性说明

Fact

DisplayName参数可以为每一个方法命名。

Skip参数可以跳过当前方法，并说明原因。

Timeout参数可以设置超时时间

Theory

public class TheoryTest
{
    [Theory(DisplayName = "Theory Test")]
    [InlineData(1, 1, 2)]
    [InlineData(1, 2, 3)]
    [InlineData(2, 2, 4)]
    public void Demo03_Theory_Test(int num01, int num02, int result)
    {
        Assert.Equal<int>(result, num01 + num02);
    }
}

MemberData

InlineData方便了很多我们测试。
但是当不确定数据来源的时候，或者数据量很大的时候，总不可能一个一个加吧。
所以MemberData就出现了。
它可以提供不同的数据来源，比如：来源于数据库、xml、Excel、文本，我们也称之为数据驱动。

无参数数据源

MemberData特性第一个参数是成员名称（即方法，属性或字段的名称）。
第二个参数是指方法所需要的参数。
这里我们先演示属性传入的方式。

public class MemberDataTest
{
    public static IEnumerable<object[]> InputData_MemberData
    {
        get
        {
            var driverData = new List<object[]>();
            //错的
            driverData.Add(new object[] { 3, 1, 2 });
            driverData.Add(new object[] { 8, 2, 3 });
            driverData.Add(new object[] { 9, 3, 5 });
            //对的
            driverData.Add(new object[] { 3, 4, 7 });
            driverData.Add(new object[] { 4, 5, 9 });
            driverData.Add(new object[] { 5, 6, 11 });
            return driverData;
        }
    }
    [Theory(DisplayName = "MemberData Theory Test")]
    [MemberData(nameof(InputData_MemberData))]
    public void MemberDataTest_Test(int num01, int num02, int result)
    {
        Assert.Equal<int>(result, num01 + num02);
    }
}

带参数据源（方法）

public class MemberDataTest
{
    public static IEnumerable<object[]> InputData_MemberData(string flag)
    {
        var driverData = new List<object[]>();
        if (flag == "Default")
        {
            driverData.Add(new object[] { 1, 1, 2 });
            driverData.Add(new object[] { 1, 2, 3 });
            driverData.Add(new object[] { 2, 3, 5 });
        }
        else
        {
            driverData.Add(new object[] { 3, 4, 7 });
            driverData.Add(new object[] { 4, 5, 9 });
            driverData.Add(new object[] { 5, 6, 11 });
        }
        return driverData;
    }
    [Theory(DisplayName = "MemberData Theory Test")]
    [MemberData(nameof(InputData_MemberData), "Default")]
    public void MemberDataTest_Test(int num01, int num02, int result)
    {
        Assert.Equal<int>(result, num01 + num02);
    }
}

定义类型

public class MatrixTheoryData<T1, T2> : TheoryData<T1, T2>
{
    public MatrixTheoryData(IEnumerable<T1> data1, IEnumerable<T2> data2)
    {
        Contract.Assert(data1 != null && data1.Any());
        Contract.Assert(data2 != null && data2.Any());
        foreach (T1 t1 in data1)
        {
            foreach (T2 t2 in data2)
            {
                Add(t1, t2);
            }
        }
    }
}
public static int[] Numbers = { 5, 6, 7 };
public static string[] Strings = { "Hello", "world!" };
public static MatrixTheoryData<string, int> MatrixData = new MatrixTheoryData<string, int>(Strings, Numbers);
[Theory(DisplayName = "MemberData Theory Test")]
[MemberData(nameof(MatrixData))]
public void MemberDataTest_Test(string x,int y)
{
    Assert.Equal(y, x.Length);
}