テストの実行の概要

TAEF を使用してテストを実行するには、%:\Program Files (x86)\Windows Kits\10\Testing\Runtimes\TAEF にある TE.EXE コマンドでテスト ファイルを指定します。 たとえば、CPP.Basic.Examples.dll テスト ファイル内のすべてのテストを実行するには、次のコマンドを実行します。

TE.exe CPP.Basic.Examples.dll

異なる方法でマークアップされたテストが含まれている場合でも、複数のテスト ファイルを指定できます。 たとえば、テストが異なる言語で記述されていても、次のコマンドにより、CPP.Basic.Examples.dll ファイルと CSharp.Basic.Examples.dll ファイル内のすべてのテストが実行されます。

TE.exe CPP.Basic.Examples.dll CSharp.Basic.Examples.dll

実行するファイルを選択するために、ワイルドカードを使用することもできます。

TE.exe *.Examples.dll

また、相対パスを指定することもできます。

TE.exe Examples\*

テストを含まないファイルをコマンド プロンプトで指定した場合、TE.exe によりエラー メッセージがレポートされます。

実行の順序

コマンド プロンプトで指定したテスト ファイルは、指定した順序で処理されます。

アウトプロセス実行

既定では、TAEF はアウトプロセスでテストを実行します。 TAEF は TE.ProcessHost.exe プロセスを使用してテストを実行します。 これにより、テストを互いに分離できるため、特定のテストが以前のテストの影響を受けることはありません。 TE.exe プロセスでテストを実行するには、TE.exe の "/inproc" オプションを指定します。

テストの選択

"/select" オプションを使用し、"選択クエリ" を指定することで、特定のテストを選択できます。 テストの名前のみに基づいて選択する場合は、代わりに "/name" オプションを使用します。 選択クエリを使用して特定の実行対象テストを選択する方法の詳細については、選択に関するページを参照してください。

コマンドの一部を環境変数 te_cmd として指定する

te.exe のコマンド オプションの一部が常に同じである場合は、環境変数 te_cmd を利用できます。 te_cmd の設定はすべて、te.exe 実行用のコマンドに追加されます。 "set te_cmd=/list" を使用すると、コマンド プロンプトで指定したバイナリの実行に対してテストの一覧が常に表示されます。

テストの一覧表示

"/list" コマンド オプションをテスト ファイルと共に指定すると、テスト ファイル内のクラスとテスト メソッドの名前がコンソールに一覧表示されます。 指定したバイナリごとのバイナリ名、クラス名、およびテスト メソッド名が一覧表示されるだけで、実行はされないことに注意してください。 セットアップ メソッドやクリーンアップ メソッド、各レベルで指定したメタデータやプロパティなど、詳細を一覧表示する場合、データが提供されているデータ ドリブン テストについては、代わりに "/listproperties" コマンド オプションを使用します。

テスト結果

一般的なテスト ケースの場合、テスト結果は Verify 呼び出しが成功したか失敗したかによって異なります。 使用可能な API とその他の詳細については、"Verify" に関するページを参照してください。 テスト中に Verify 呼び出しが行われなかった場合、TAEF で提供されるログ サブスクライバーのテスト結果は既定で "Passed" になります。 テストの作成時に "DefaultTestResult" を明示的に指定することもできます。 詳細については、「テストを作成する」を参照してください。

ヘルプ - コマンド オプション

TE.exe の "/?" を指定することで、使用可能なすべてのコマンド オプションの説明を表示できます。 詳細については、「Te.exe のコマンド オプション」を参照してください。