RangeAttribute (NUnit 2.5)
The RangeAttribute is used to specify a range of values to be provided for an individual parameter of a parameterized test method. Since NUnit combines the data provided for each parameter into a set of test cases, data must be provided for all parameters if it is provided for any of them.
By default, NUnit creates test cases from all possible combinations of the datapoints provided on parameters - the combinatorial approach. This default may be modified by use of specific attributes on the test method itself.
RangeAttribute supports the following constructors:
public RangeAttribute( int from, int to ); public RangeAttribute( int from, int to, int step ); public RangeAttribute( long from, long to, long step ); public RangeAttribute( float from, float to, float step ); public RangeAttribute( double from, double to, double step );
Example
The following test will be executed nine times, as follows:
MyTest(1, 0.2) MyTest(1, 0.4) MyTest(1, 0.6) MyTest(2, 0.2) MyTest(2, 0.4) MyTest(2, 0.6) MyTest(3, 0.2) MyTest(3, 0.4) MyTest(3, 0.6)
[Test]
public void MyTest(
[Values(1,2,3) int x,
[Range(0.2,0.6,0.2] double d)
{
...
}
Order of Execution
In NUnit 2.5, individual test cases are sorted alphabetically and executed in that order. With NUnit 2.5.1, the individual cases are not sorted, but are executed in the order in which NUnit discovers them. This order does not follow the lexical order of the attributes and will often vary between different compilers or different versions of the CLR.
As a result, when RangeAttribute appears multiple times on a parameter or when other data-providing attributes are used in combination with RangeAttribute, the order of the argument data is undefined.
However, when a single RangeAttribute is used by itself, the order of the data follows exactly the order in which the it is specified in the attribute constructor.