テスト エクスプローラーを使用して単体テストを実行する

テスト エクスプローラーを使用し、Visual Studio またはサード パーティの単体テスト プロジェクトから単体テストを実行します。 テスト エクスプローラーを使用し、テストをカテゴリにまとめたり、テストの一覧にフィルターを適用したり、テストのプレイリストを作成、保存、実行したりすることもできます。 また、テスト エクスプローラーを使用して単体テストをデバッグし、Visual Studio Enterprise でコード カバレッジを分析することもできます。

テスト エクスプローラーは、ソリューション内の複数のテスト プロジェクト、および運用コード プロジェクトに含まれるテスト クラスからテストを実行できます。 テスト プロジェクトは別の単体テスト フレームワークを使用できます。 テスト対象のコードを .NET 用に記述する場合、対象コードの言語にかかわらず、.NET も対象とする言語でテスト プロジェクトを記述できます。 ネイティブ C/C++ コード プロジェクトは、C++ の単体テスト フレームワークを使用してテストする必要があります。

テスト プロジェクトをビルドする

Visual Studio ソリューションにテスト プロジェクトをまだ設定していない場合は、まずテスト プロジェクトを作成してビルドする必要があります。

• 単体テストの概要 (.NET)
• C/C++ 用の単体テストの記述

Visual Studio には、マネージド コードおよびネイティブ コード用の Microsoft 単体テスト フレームワークが含まれます。 ただし、テスト エクスプローラーでは、テスト エクスプローラーのアダプターを実装した単体テスト フレームワークも実行できます。 サードパーティの単体テスト フレームワークのインストールの詳細については、「サードパーティ製の単体テスト フレームワークをインストールする」を参照してください。

テスト エクスプローラーでテストを実行する

テスト プロジェクトをビルドすると、テストはテスト エクスプローラーに表示されます。 テスト エクスプローラーが表示されない場合は、Visual Studio メニューの [テスト] を選び、[テスト エクスプローラー] を選択します (または Ctrl + E、T キーを押します)。

テストを実行、書き込み、再実行すると、テスト エクスプローラーにはプロジェクト、名前空間、クラスの既定のグループ化の結果が表示されます。 テスト エクスプローラーでテストをグループ化する方法を変更できます。

テスト エクスプローラーのツール バーからテストの検索、整理、実行の作業の多くを行うことができます。

テストの実行

ソリューション内のすべてのテスト、グループ内のすべてのテスト、または選択した一連のテストを実行できます。 次のいずれかの操作を行います。

• ソリューション内のすべてのテストを実行するには、[すべて実行] アイコンを選びます (または Ctrl + R、V キーを押します)。

• 既定のグループ内のテストをすべて実行するには、 [実行] アイコンを選択し、メニューでそのグループを選択します。

• 実行する個々のテストを選び、選んだテストの右クリック メニューを開いてから、[選択したテストの実行] を選びます (または Ctrl + R、T キーを押します)。

• 個々のテストに実行順序を定める依存関係がない場合、ツール バーの設定メニューで並列テストの実行を有効にします。 これにより、すべてのテスト実行にかかる時間を著しく短縮できます。

各ビルドの後にテストを実行する

各ローカル ビルドの後で単体テストを実行するには、テスト エクスプローラーのツール バーで設定アイコンを開き、 [ビルド後にテストを実行] を選択します。

テスト結果を表示する

テストを実行して、記述し、再実行すると、テスト エクスプローラーに [失敗したテスト] 、 [成功したテスト] 、 [スキップされたテスト] 、および [テストを実行しない] のグループの結果が表示されます。 テスト エクスプローラーの下部または横の詳細ウィンドウに、テストの実行の概要が表示されます。

テストの詳細を表示する

個々のテストの詳細を表示するには、そのテストを選択します。

テストの詳細ペインに次の情報が表示されます。

• テスト メソッドのソース ファイル名と行番号。

• テストの状態。

• テスト メソッドの実行に要した経過時間。

テストが失敗した場合、詳細ペインには次の情報も表示されます。

• テストの単体テスト フレームワークによって返されたメッセージ。

• テストが失敗した時刻のスタック トレース。

テスト メソッドのソース コードを表示する

Visual Studio エディターでテスト メソッドのソース コードを表示するには、テストを選んでから、右クリック メニューの [テストを開く] を選択します (または F12 キーを押します)。

テスト リストをグループ化およびフィルター処理する

テスト エクスプローラーを使用すると、テストを定義済みのカテゴリにグループ化できます。 テスト エクスプローラーで実行されるほとんどの単体テスト フレームワークでは、独自のカテゴリおよびカテゴリ/値のペアを定義して、テストをグループ化することができます。 テストのプロパティに対して文字列を照合して、テストの一覧をフィルター処理することもできます。

テストの一覧のテストをグループ化する

テスト エクスプローラーのグループ

Traits

通常、特徴はカテゴリ名/値のペアですが、1 つのカテゴリにすることもできます。 特徴は、単体テスト フレームワークによってテスト メソッドとして識別されるメソッドに割り当てることができます。 単体テスト フレームワークは、特徴のカテゴリを定義できます。 特徴のカテゴリに値を追加して、独自のカテゴリ名/値のペアを定義できます。 特徴のカテゴリと値を指定する構文は、単体テスト フレームワークによって定義されます。

マネージド コード用の Microsoft 単体テスト フレームワークでの特徴の定義

マネージド アプリケーション用の Microsoft 単体テスト フレームワークで、TestPropertyAttribute 属性の特徴の名前と値のペアを定義します。 テスト フレームワークには、次の定義済みの特徴も含まれています。

C++ 用の Microsoft 単体テスト フレームワークでの特徴の定義

「C++ 用の Microsoft 単体テスト フレームワークの使用方法」をご覧ください。

カスタム プレイリストを作成する

<Playlist Version="2.0">
  <Rule Name="Includes" Match="Any">
    <Property Name="Trait" Value="SchemaUpdateBasic" />
  </Rule>
</Playlist>

<Playlist Version="2.0">
  <Rule Name="Includes" Match="Any">
    <Rule Match="All">
      <Property Name="Solution" />
        <Rule Match="Any">
            <Property Name="Trait" Value="TestCategory [Value]" />
        </Rule>
    </Rule>
  </Rule>
</Playlist>

<Playlist Version="2.0">
  <Rule Name="Includes" Match="Any">
    <Property Name="Trait" Value="SchemaUpdateBasic" />
  </Rule>
</Playlist>

<Playlist Version="2.0">
  <Rule Name="Includes" Match="Any">
    <Rule Match="All">
      <Property Name="Solution" />
        <Rule Match="Any">
            <Property Name="Trait" Value="TestCategory [Value]" />
        </Rule>
    </Rule>
  </Rule>
</Playlist>

テスト リストを検索およびフィルター処理する

テスト エクスプローラーの検索フィルターを使用して、表示および実行するプロジェクトのテスト メソッドを制限することもできます。

テスト エクスプローラーの検索ボックスに文字列を入力して Enter キーを押すと、完全修飾名にその文字列が含まれるテストだけを表示するようにテスト リストがフィルター処理されます。

異なる条件でフィルター処理するには

1. 検索ボックスの右にあるドロップダウン リストを開きます。

2. 新しい条件を選択します。

3. 引用符の間にフィルターの値を入力します。 文字列に含まれるものではなく、完全に一致するものを検索する場合は、コロン (:) ではなく等号 (=) を使用します。

フィルター処理結果のサブセットを除外するには、次の構文を使用します。

FilterName:"Criteria" -FilterName:"SubsetCriteria"

たとえば、FullName:"MyClass" - FullName:"PerfTest" の場合、名前に "PerfTest" も含むテストを除いて、名前に "MyClass" を含むすべてのテストを返します。

単体テストのコード カバレッジを分析する

Visual Studio Enterprise エディションで利用可能な Visual Studio のコード カバレッジ ツールを使用して、単体テストで実際にテスト中の製品コードの量を確認できます。 選択したテストまたはソリューションのすべてのテストのコード カバレッジを実行できます。

ソリューションのテスト メソッドのコード カバレッジを実行するには:

• テスト エクスプローラー内を右クリックし、 [選択されたテストのコード カバレッジの分析] を選択します。

[コード カバレッジの結果] ウィンドウに、行、関数、クラス、名前空間、およびモジュールで実行された製品コードのブロックのパーセンテージが表示されます。

詳細については、「コード カバレッジを使用した、テストされるプロジェクトのコード割合の確認」を参照してください。

テスト ショートカット

テストはテスト エクスプローラーから実行できます。テストのコード エディター内で右クリックし、 [テストの実行] を選択するか、Visual Studio の既定のテスト エクスプローラー ショートカットを使用します。 ショートカットの一部はコンテキストベースです。 つまり、コード エディター内のカーソルの位置に基づいて、テストが実行、デバッグ、またはプロファイルされます。 カーソルがテスト メソッド内にある場合、そのテスト メソッドが実行されます。 カーソルがクラス レベルにある場合、そのクラスのすべてのテストが実行されます。 名前空間レベルの場合も同じことが適用されます。

オーディオ キューのテスト

テスト エクスプローラーを使用すると、テストの実行が完了したときに音を鳴らすことができます。 サウンドには 2 種類あり、1 つは、テストの実行が成功し、すべてのテストに合格したことを示し、もう 1 つは、テストが完了し、少なくとも 1 つのテストに失敗したことを示します。 これらのサウンドは、Windows 11 の既定の [サウンド] ダイアログで設定できます。 この機能は、Visual Studio 2019 Update 16.9 Preview 3 以降で使用できます。

1. Windows 11 の既定の [サウンド] ダイアログを開きます。
2. [サウンド] タブに移動します。
3. [Microsoft Visual Studio] カテゴリを見つけます。 [テストの実行成功] または [テストの実行失敗] のサウンドを選択して、事前設定済みのサウンドを選択するか、独自のオーディオ ファイルを参照します。
   

関連するコンテンツ

• コードの単体テスト
• テスト エクスプローラーを使用して単体テストをデバッグする
• 64 ビット プロセスとして単体テストを実行する
• テスト エクスプローラーに関する FAQ