TestRegions can be a powerful tool to build testability into your web applications and enable your test automation teams to build highly resilient test beds that have low maintenance costs compared to the traditional automation methods like the HTTP record/replay approaches. TestRegions are ideal to be used with dynamic web frameworks like ASP.NET since they can take out some of the complexity that comes with the auto generated html. Given that TestRegions are injected in the source code of web pages, we wanted to provide Visual Studio and ASP.NET developers a richer experience at design time. Telerik Testing Framework includes an ASP.NET TestRegion Custom Control that can be used just like any other asp: control to define TestRegion's into your code. This control allows you to:
Visually view the defined TestRegions in your app directly in Visual Studio's design view. See figure below.
At runtime this control renders as an HTML comment (), so you don't need to worry about this control affecting your application's markup or layout which is a core principle in the initial design of TestRegions.
Below is a segment of the HTML persisted that is shown in design view above.
Note: The samples shown above are included in full in the code samples installed with Telerik Testing Framework.
To be able to use this control as shown above, you simply need to add it first to your ToolBox. Visual Studio should handle all tag registrations once you drag-n-drop the control on your pages. To add the control to your toolbox:
Locate the ArtOfTest.WebAii.AspNet.dll on your machine. The dll should be located in your Telerik Testing Framework %InstallDir%. This dll contains the ASP.NET TestRegion control and will contain any future test controls we might introduce for ASP.NET.
In Visual Studio, open the Toolbox. (View->Toolbox)
Right-Click in your Toolbox and select 'Add Tab'.
A new tab on your Toolbox will be created. Name it "Testing Controls" or any other title you might choose.
Inside the new tab, right-click again and this time select "Choose Items...". This will pop-up the 'Choose Toolbox Items' dialog.
Click on 'Browse' button and navigate to the ArtOfTest.WebAii.AspNet.dll that you located in step 1 above. Select it and click 'Open'. The control should be added to the dialog.
Now your control is added to your Toolbox and should be ready to be used.