How to: Specify the Maximum Test Iterations for a Scenario Using the Load Test Editor
This topic applies to:
Visual Studio Ultimate
Visual Studio Premium
Visual Studio Professional
Visual Studio Express
After you create your load test by using the New Load Test Wizard, you can use the Load Test Editor to change the scenarios properties to meet your testing needs and goals. For more information, see How to: Create a New Load Test Using the New Load Test Wizard.
For a full list of the load test scenario properties and their descriptions, see Load Test Scenario Properties.
You can specify the maximum number of times that you want your tests to run for a scenario by using the Load Test Editor to change the Maximum Test Iterations property in the Properties window.
The Maximum Test Iterations property controls the maximum number of test iterations to run for the scenario. Just as for the Test Iterations property in the load test run settings, this is the maximum across all users on all agents, not a per user setting.
For sequential test mix, one iteration is one pass through all the tests in the mix. For all other test mixes, each test execution counts as an iteration. For more information, see About the Mix Control for Load Tests.
If the load test is a duration-based load test, and the duration expires before the iteration count is complete, the test will still stop. If the test is iteration-based, and the test iterations are met before scenario iterations, the test will stop. The duration is configured by using the Run Duration property in the Properties window associated with a run setting in a load test.
When the scenario iteration count is met, the scenario will stop running, but any other active scenarios will continue to run.
A related property is the Unique property on a Web test data source, which move sequentially through the data, row-by-row, but only one time for each record. For more information, see Binding a Data Source to a Web Performance Test.
The Maximum Test Iterations property is useful for a variety of situations. Some load testers prefer to conduct iteration-based testing, whereas other load testers prefer to conduct duration-based testing.
To specify the maximum test iterations in a scenario
Open a load test.
The Load Test Editor appears. The load test tree is displayed.
In the load test trees Scenarios folder, click the scenario node for which you want to specify the maximum number of test iterations.
On the View menu, select Properties Window.
The categories and properties of the scenario are displayed in the Properties window.
In the text box for the Maximum Test Iterations property, type a value that indicates the maximum number of tests to run for the scenario when the load test is run.
Using a value of 0 for the Maximum Test Iterations property specifies no maximum iterations.
After you have finished changing the property, click Save on the File menu. You can then run your load test by using the new Maximum Test Iterations value.