NCover Documentation

Coverage Data Files

A list of coverage files -or- wildcards ('', '?') that resolve to coverage files. The specified coverage files will be merged together before any other options are applied.

<CoverageDataPaths>
    <CoverageDataPath>coverage.xml</CoverageDataPath>
    <CoverageDataPath>coverage.02.09.xml</CoverageDataPath>
</CoverageDataPaths>

Append Trend to a File

        Appends trend data from the merged coverage files to the specified output path and filename.
        The file will be created if it does not exist. If this parameter is specified and 
        <a href="coverage-options#lt">LoadTrendPath</a> is not, then this file will provide trend data for the reports.
        Otherwise, the file specified by <a href="coverage-options#lt">LoadTrendPath</a> will provide trend data for the reports.
        If both <a href="coverage-options#at">CoverageTrendPath</a> and <a href="coverage-options#lt">LoadTrendPath</a> are specified,
        then the trend data from the merged coverage files will be appended to the path in <a href="coverage-options#at">CoverageTrendPath</a>
        before the trend data for the reports is loaded from <a href="coverage-options#lt">LoadTrendPath</a>.
        (If <a href="coverage-options#at">CoverageTrendPath</a> and <a href="coverage-options#lt">LoadTrendPath</a> are the same full path and filename, then
        <a href="coverage-options#lt">LoadTrendPath</a>)

        </p><div class="example">

Usage:

<CoverageTrendPath>C:\data\trends\myproject.trend</CoverageTrendPath>

Build Id

        Specify the build ID for the <a href="merging#s">MergedCoverageDataFileName</a>.
        Defaults to the build ID of the first coverage data file loaded.

        </p><div class="example">

Usage:

<BuildId>myproject_3.0.12.3721</BuildId>

Hide

        Specify what elements to hide (if any) in the report.
        These elements will still exist and affect coverage percentages, but they will not appear.<br />
        Possible Values:<br />
        None (default)<br />
        HideUnvisited<br />
        HideFullyCovered<br />
        HideThresholdCovered

        </p><div class="example">

Usage:

<FilterStyle>HideUnvisited</FilterStyle>

Ignore Failed Builds

        By default, reports with trend data will include trend data from builds that had failing tests. However, you can
        make the reports act as if that data doesn't exist by using this argument or setting it to true.
        Using this argument will make the reports only use trend data from builds that had no failing tests.

        </p><div class="example">

Usage:

<IgnoreFailedBuilds>true</IgnoreFailedBuilds>

Load Trend from a File

        Rather than creating new trends from the coverage data, this parameter loads trend data
        for the report from the specified output path and filename, and uses the trend data in
        the given file without appending trend data from the merged coverage files.

        </p><div class="example">

Usage:

<LoadTrendPath>C:\data\trends\myproject.trend</LoadTrendPath>

Output Path

        Specify the default output path for all generated reports. Defaults to the current directory.<br />
        NOTE: this parameter is interpreted as a directory for the 'FullCoverageReport' and
        as a file for every other report.

        </p><div class="example">

Usage:

<OutputPath>D:\reports\html\fullcoverage10.2.09</OutputPath>

Output Report

The Reports option allows you to create multiple reports using the same filters, satisfactory thresholds, and sort order, giving you multiple views of the same data.

Usage:
<Reports>
    <Report>
        <ReportType> ... </ReportType>
        <Format> ... </Format>
        <OutputPath> ... </OutputPath>
        <params>
            <param>
                <name> ... </name>
                <value> ... </value>
            </param>
            <param>
                <name> ... </name>
                <value> ... </value>
            </param>
        </params>
    </Report>
</Reports>

'ReportType' is the type of report to create.
For a list of possible values, see the Report Types Reference.

'Format' specifies the file type (XML or HTML) to ouput the report file(s) in.
Possible Values are "Xml" or "Html".

'OutputPath' is where the report will be created.
If no output path is specified, then the value of OutputPath will be used.

'params' is a list of optional name-value pairs that is specific to the report type being created.
For an exhaustive explanation of parameters, examples, a reference of the Report Types that support parameters, and the parameters they support, go to the NCover Reporting Parameters Reference.

Project Name

        Set this value to control the project name that appears at the top of every generated report.
        By default, the project name is taken from the first coverage file loaded.

        </p><div class="example">

Usage:

<ProjectName>my very long project name</ProjectName>

Sort By

        Specifies the sorting to apply to the reports.
        Default is no sorting.<br />
        Permitted values:<br />
        Name<br />
        ClassLine<br />
        CoveragePercentageAscending<br />
        CoveragePercentageDescending<br />
        UnvisitedSequencePointsAscending<br />
        UnvisitedSequencePointsDescending<br />
        VisitCountAscending<br />
        VisitCountDescending<br />
        FunctionCoverageAscending<br />
        FunctionCoverageDescending<br />

        </p><div class="example">

Usage:

<SortStyle>VisitCountDescending</SortStyle>

Top Uncovered to Report

        By default, NCover.Reporting only reports the top 10 most uncovered items in the
        "Top Uncovered" reports. Set this value to control how many are shown.

        </p><div class="example">

Usage:

<NumOfTopUncoveredToReport>50</NumOfTopUncoveredToReport>

Xslt Override Path

        You may provide the path to the Xslt file you wish to use for the report.

        </p><div class="example">

Usage:

<XsltOverridePath>mycustomfile.xslt</XsltOverridePath>

If you still need technical assistance, we can help:

Submit A Support Ticket