.runsettings ファイルを使用した単体テストの構成

Visual Studio の単体テストは、*.runsettings ファイルを使用して構成できます。(拡張子 runsettings を使用していればファイル名は自由です。)たとえば、テストが実行される .NET Framework、テスト結果が配信されるディレクトリ、テストの実行中に収集されるデータを変更できます。

特殊な構成を行う必要がない場合、*.runsettings ファイルは不要です。このファイルが最もよく使われるのは、コード カバレッジをカスタマイズする場合です。

[!メモ]

.runsettings と .testsettings

テストを構成するファイルには、次の 2 種類があります。*.runsettings は、単体テストに使用されます。*.testsettings は、ラボ環境テスト、Web パフォーマンスおよびロード テストに使用されます。また、一部の種類の診断データ アダプター (Intellitrace など) およびイベント ログ アダプターをカスタマイズする場合にも使用されます。

2010 以前のエディションの Visual Studio では、単体テストをカスタマイズするためにも *.testsettings ファイルが使用されていました。これは現在でも可能ですが、*.runsettings ファイルで同等の構成を使用する場合より、テストの実行速度が遅くなります。

.runsettings ファイルによるテストのカスタマイズ

1. XML ファイルを Visual Studio ソリューションに追加し、ファイル名を test.runsettings に変更します。(ファイル名は自由ですが、拡張子には runsettings を使用する必要があります。)

2. ファイルの内容を以下のサンプルで置き換えます。

   必要に応じてファイルを編集します。

3. [テスト] メニューの [テストの設定] をクリックし、[テスト設定ファイルの選択] をクリックします。

ソリューション内に複数の *.runsettings ファイルを作成し、[テストの設定] メニューを使用して状況に応じてそれらを有効または無効にすることができます。

このサンプル .runsettings ファイルをコピーする

一般的な *.runsettings ファイルを示します。すべての値には既定値があるため、ファイルの各要素は省略可能です。

<?xml version="1.0" encoding="utf-8"?>
<RunSettings>
  <!-- Configurations that affect the Test Framework -->
  <RunConfiguration>
    <!-- Path relative to solution directory -->
    <ResultsDirectory>.\TestResults</ResultsDirectory>

    <!-- [x86] | x64  
      - You can also change it from menu Test, Test Settings, Default Processor Architecture -->
    <TargetPlatform>x86</TargetPlatform>

    <!-- Framework35 | [Framework40] | Framework45 -->
    <TargetFrameworkVersion>Framework40</TargetFrameworkVersion>
  </RunConfiguration>
  
  <!-- Configurations for data collectors -->
  <DataCollectionRunSettings>
    <DataCollectors>
      <DataCollector friendlyName="Code Coverage" uri="datacollector://Microsoft/CodeCoverage/2.0" assemblyQualifiedName="Microsoft.VisualStudio.Coverage.DynamicCoverageDataCollector, Microsoft.VisualStudio.TraceCollector, Version=11.0.0.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a">
        <Configuration>
          <CodeCoverage>
            <ModulePaths>
              <Exclude>
                <ModulePath>.*CPPUnitTestFramework.*</ModulePath>
              </Exclude>
            </ModulePaths>
          </CodeCoverage>
        </Configuration>
      </DataCollector>
      
    </DataCollectors>
  </DataCollectionRunSettings>
  
  <!-- Adapter Specific sections -->
  
  <!-- MSTest adapter -->
  <MSTest>
    <MapInconclusiveToFailed>True</MapInconclusiveToFailed>
    <CaptureTraceOutput>false</CaptureTraceOutput>
    <DeleteDeploymentDirectoryAfterTestRunIsComplete>False</DeleteDeploymentDirectoryAfterTestRunIsComplete>
    <DeploymentEnabled>False</DeploymentEnabled>
  </MSTest>
  
  
</RunSettings>

.runsettings ファイルは、コード カバレッジを構成するためにも使用されます。

このトピックの残りの部分では、ファイルの内容について説明します。

.runsettings ファイルを編集する

.runsettings ファイルには、次の要素があります。

テストの実行の構成

診断データ アダプター (データ コレクター)

DataCollectors 要素は、診断データ アダプターの設定を指定します。診断データ アダプターは、テスト対象の環境とアプリケーションに関する追加情報を収集するために使用します。各アダプターには既定の設定があるため、既定値を使用しない場合にのみ設定を指定する必要があります。

コード カバレッジ アダプター

コード カバレッジ データ コレクターは、アプリケーション コードのどの部分がテストで実行されたかを示すログを作成します。コード カバレッジの設定のカスタマイズの詳細については、「コード カバレッジ分析のカスタマイズ」を参照してください。

その他の診断データ アダプター

コード カバレッジ アダプターは、現在のところ、実行設定ファイルを使用してカスタマイズできる唯一のアダプターです。

他の種類の診断データ アダプターをカスタマイズするには、テスト設定ファイルを使用する必要があります。詳細については、「Visual Studio のテストにおけるテスト設定の指定」を参照してください。

MSTest の実行設定

これらは、[TestMethod] 属性を持つテスト メソッドを実行するテスト アダプターに固有の設定です。

<RunSettings>
  <MSTest>
    <SettingsFile>my.testsettings</SettingsFile> 
    <ForcedLegacyMode>true</ForcedLegacyMode> 
  </MSTest>
</RunSettings>

参照

概念

コード カバレッジ分析のカスタマイズ

その他の技術情報

Visual Studio のテストにおけるテスト設定の指定