XJTAG logo
Open search box button
Close search button

BeginRunSession Method

Starts a new run session. The output for all tests run after calling this method will be grouped as if they were a single test run, even if multiple calls to RunTests, RunTest, StartTesting, or StartTesting are made. This affects the text output and the output to any enabled log files. The run session is ended by calling EndRunSession, which also generates the summary table and writes any log files to disk.

Type: Runner

Namespace: XJTAG.Integration.XJRunner

Syntax

public void BeginRunSession()

Exceptions

RuntimeException

A run session has already been started, or tests or functions are currently executing.

System.ObjectDisposedException

The Runner object has already been disposed.

Remarks

Using BeginRunSession and EndRunSession allows for log files to be formatted as a single test run when multiple calls to RunTests, RunTest, StartTesting, StartTesting are required as part of the testing implementation. This will also affect the text output generated. Calling this method while tests or functions are currently executing will result in an exception being thrown. This does not affect the LastTestRunPassed property, which is updated after each set of test runs, and will represent the result of the last TestCollection or TestFunction run.