GetRunner Method (XJLink, string)

Gets a Runner instance for the specified XJLink using the specified pin mapping file.

Type: RunnerProject

Namespace: XJTAG.Integration.XJRunner

Syntax

public Runner GetRunner(XJLink xjlink, string pinMapFile)

Parameters

xjlink

Type: XJLink

The XJLink to use to run the tests.

pinMapFile

Type: string

The full path to the pin mapping file to use. If not specified, the project default is used. For XJPack (.xjp) files only pin mappings included as additional files in the XJPack file may be loaded. In this case pinMapFile should be the original pin mapping file path relative to the project file.

Return Value

Runner

A Runner instance for this project.

Exceptions

System.InvalidOperationException

The specified XJLink is in use with another Runner instance.

ProjectException

No suitable licence is available to allow the project to be run.

RuntimeException

There was an error creating the Runner object.

System.ObjectDisposedException

The RunnerProject has already been disposed.

Remarks

This overload of GetRunner returns a Runner instance without any XjtagOutputBox instance to display output. To obtain any text output from tests, the TextOutputGenerated event should be subscribed to. Alternatively output can be retrieved after the test has finished from the OutputFromLastTestRun property.