TestCaseData

The TestCaseData class provides extended test case information for a parameterized test, although any object deriving from TestCaseParameters may be used. Unlike NUnit 2, you cannot implement ITestCaseData, you must derive from TestCaseParameters.

[TestFixture]
public class MyTests
{
    [TestCaseSource(typeof(MyDataClass), nameof(MyDataClass.TestCases))]
    public int DivideTest(int n, int d)
    {
        return n / d;
    }
}

public class MyDataClass
{
    public static IEnumerable TestCases
    {
        get
        {
            yield return new TestCaseData(12, 3).Returns(4);
            yield return new TestCaseData(12, 2).Returns(6);
            yield return new TestCaseData(12, 4).Returns(3);
        }
    }
}

This example uses the fluent interface supported by TestCaseData to make the program more readable.

TestCaseData supports the following properties and methods, which may be appended to an instance in any order.

• Explicit() or Explicit(string) causes the test case to be marked explicit, optionally specifying the reason for doing so.
• Ignore(string) causes the test case to be ignored and specifies the reason, which is required.
• Returns specifies the expected result to be returned from the method, which must have a compatible return type.
• SetArgDisplayNames(string[]) sets the list of display names to use as the parameters in the test name.
• SetCategory(string) applies a category to the test.
• SetDescription(string) sets the description property of the test.
• SetName(string) provides a name for the test. If not specified, a name is generated based on the method name and the arguments provided. See Template Based Test Naming.
• SetProperty(string, string), SetProperty(string, int) and SetProperty(string, double) apply a named property and value to the test.
• TypeArgs specifies the Types to be used when targeting a generic test method. (NUnit 4.1+)