Microsoft.Testing.Platform (MTP) を使用した dotnet テスト

この記事の対象: ✔️ .NET 10 SDK 以降のバージョン

名前

dotnet test- MTP .NET単体テストを実行するために使用されるテストドライバーです。

概要

dotnet test
    [<PROJECT_OR_TRAVERSAL_PATH>]
    [--project <PROJECT_PATH>]
    [--solution <SOLUTION_PATH>]
    [--test-modules <EXPRESSION>]
    [--root-directory <ROOT_PATH>]
    [--max-parallel-test-modules <NUMBER>]
    [--config-file <CONFIG_FILE>]
    [--results-directory <RESULTS_DIRECTORY>]
    [--results-directory-layout <flat|per-module>]
    [--diagnostic-output-directory <DIAGNOSTIC_OUTPUT_DIRECTORY>]
    [--minimum-expected-tests <NUMBER>]
    [--maximum-failed-tests <NUMBER>]
    [--timeout <DURATION>]
    [-e|--environment <NAME="VALUE">]
    [-a|--arch <ARCHITECTURE>]
    [--artifacts-path <ARTIFACTS_DIR>]
    [-c|--configuration <CONFIGURATION>]
    [-f|--framework <FRAMEWORK>]
    [--os <OS>]
    [-r|--runtime <RUNTIME_IDENTIFIER>]
    [--use-current-runtime|--ucr]
    [-v|--verbosity <LEVEL>]
    [--no-build]
    [--no-dependencies]
    [--no-restore]
    [--nologo|--no-logo|--no-banner]
    [--no-ansi]
    [--no-progress]
    [--no-artifact-post-processing]
    [--output <VERBOSITY_LEVEL>]
    [--show-test-results <OUTCOME>]
    [--list-tests [text|json]]
    [--no-launch-profile]
    [--no-launch-profile-arguments]
    [--device <DEVICE_ID>]
    [--list-devices]
    [--collect-test-map]
    [--affected-tests]
    [<args>...]

dotnet test -h|--help

Description

MTP を使用すると、 dotnet test は VSTest よりも高速に動作します。テスト関連の引数は、テスト projectに登録されている拡張機能に関連付けられているため、修正されなくなりました。さらに、MTP では、テストの実行時に globbing フィルターがサポートされます。詳細については、 MTP を参照してください。

Important

拡張機能固有のオプションは MTP には組み込まれません。対象となる各テストアプリケーションでは、オプションを提供する拡張機能を登録する必要があります。拡張機能の NuGet パッケージを直接追加するか、パッケージを含むテスト SDK 構成またはプロファイルを使用します。それ以外の場合、オプションが認識されないため、終了コード 5 でテストの実行が失敗します。 dotnet test --help実行して、選択したテストアプリケーションで使用できるオプションを確認し、シナリオ別の拡張機能オプションを参照してオプションのパッケージを見つけます。

Warnung

global.json経由で MTP をオプトインすると、dotnet testはすべてのテストプロジェクトで MTP を使用することが想定されます。いずれかのテストプロジェクトで VSTest が使用されている場合はエラーです。

バージョンの要件

dotnet testの MTP モードには、.NET 10 SDK と MTP 1.7 以降が必要です。 .NET 10 の後に追加されたオプションには、次のセクションで個々の SDK バージョンの要件があります。一部のオプションでは、SDK が完全な実行を調整し、各テストアプリケーションが対応する機能を実装するため、新しい MTP パッケージも必要です。

暗黙的な復元

復元を必要とするすべてのコマンド (dotnet restore、dotnet new、dotnet build、dotnet run、dotnet test、dotnet publish など) によって暗黙的に実行されるため、dotnet pack を実行する必要がなくなりました。暗黙的な復元を無効にするには、--no-restore オプションを使用します。

dotnet restore コマンドは、明示的な復元が理にかなっている特定のシナリオ ( Azure DevOps Services または復元がいつ行われるかを明示的に制御する必要があるビルドシステムなど) で引き続き役立ちます。

NuGet フィードの管理方法については、dotnet restore のドキュメントをご覧ください。

Important

--no-restoreを使用してプロジェクトまたはソリューションを実行する場合は、復元によって生成されたプロジェクトの状態を obj フォルダーに保持し、一致するグローバルパッケージフォルダーを使用できるようにします。テストフレームワークとプラットフォームパッケージのインポートでは、MTP テストアプリケーションを識別するために使用 dotnet test MSBuild プロパティが設定されます。 --no-build オプションは、--no-restoreも意味します。テスト環境にビルドされたテストアプリケーションが含まれているが、プロジェクトの復元状態が含まれていない場合は、代わりに --test-modules を使用します。詳細については、No test projects were foundを参照してください。

オプション

注

一度に使用できるオプションは、--project、--solution、または --test-modules のいずれかです。これらのオプションを組み合わせることはできません。また、 --test-modulesを使用する場合、 --arch、 --configuration、 --device、 --framework、 --list-devices、 --os、 --runtime、または --use-current-runtimeを指定することはできません。これらのオプションでは、プロジェクトの評価が必要であるか、既にビルドされているモジュールには関係ありません。

PROJECT_OR_TRAVERSAL_PATH

実行するプロジェクトまたはトラバーサルプロジェクトを指定します。 .NET 11 以降では、dotnet testはdirs.projなどのMicrosoft.Build.Traversal プロジェクトをサポートし、参照されるテストプロジェクトを再帰的に実行します。

.NET 12 Preview 1 以降では、引数は C# ファイルベースの MTP テストアプリを識別することもできます。ファイルベースのテストアプリでは、 --deviceはサポートされていません。
--project <PROJECT_PATH>

実行するproject ファイルのパス (フォルダー名または完全パス) を指定します。指定しない場合は、既定で現在のディレクトリに設定されます。
--solution <SOLUTION_PATH>

実行するソリューションファイルのパス (フォルダー名または完全パス) を指定します。指定しない場合は、既定で現在のディレクトリに設定されます。
--test-modules <EXPRESSION>

ファイルグロビングを使用してテストモジュールをフィルター処理します。これらのテストモジュールに属するテストのみが実行されます。このオプションはプロジェクトを評価しないため、プロジェクトの復元状態が使用できない場合は、既にビルドされているテストアプリケーションを実行するために使用します。 .NET 11 以降では、パターンの前に!を付けて、一致するモジュールを除外します。複数のパターンをセミコロンで区切ります。各パターンの周囲の空白は無視されます。
--root-directory <ROOT_PATH>

--test-modules オプションのルートディレクトリを指定します。 --test-modules オプションでのみ使用できます。
--max-parallel-test-modules <NUMBER>

並列で実行できるテストモジュールの最大数を指定します。既定値は Environment.ProcessorCountです。
--config-file <CONFIG_FILE>

テストの実行に使用する構成ファイルを指定します。相対パスが指定されている場合は、現在のディレクトリに基づいて絶対パスに変換されます。構成ファイルの設定の詳細については、 testconfig.jsonを参照してください。
--results-directory <RESULTS_DIRECTORY>

テスト結果が格納されるディレクトリを指定します。ディレクトリが存在しない場合は、作成されます。相対パスが指定されている場合は、現在のディレクトリに基づいて絶対パスに変換されます。既定値とレイアウトのオーバーライドについては、「結果と成果物」を参照してください。
--results-directory-layout <flat|per-module>

複数モジュールの実行で結果ディレクトリの下にファイルを整理する方法を指定します。既定の flatでは、すべての結果が同じディレクトリに書き込まれます。 per-module は、各モジュールの結果を <project>/<target-framework>_<runtime-or-architecture>に書き込みます。これにより、同じ相対ファイル名を持つレポートが互いに上書きされなくなります。絶対 --coverage-output パスなどの共有絶対拡張出力パスは、このレイアウトをバイパスします。

.NET 11 以降で使用できます。このオプションは、10.0.4xx 機能バンドの .NET SDK 10.0.402 以降の更新プログラムでも使用できます。
--diagnostic-output-directory <DIAGNOSTIC_OUTPUT_DIRECTORY>

診断出力が格納されるディレクトリを指定します。ディレクトリが存在しない場合は、作成されます。相対パスが指定されている場合は、現在のディレクトリに基づいて絶対パスに変換されます。
--minimum-expected-tests <NUMBER>

実行全体のテストの正の最小数を指定します。集計されたテスト数が指定された最小値より小さい場合、テストの実行は終了コード 9 で失敗します。グローバル数には、スキップされたテストが含まれます。終了コードの詳細については、 MTP 出口コードを参照してください。

このオプションは --前に表示されるため、グローバル (全体実行) オプションです。代わりに各テストモジュールの最小値を要求するには、 -- 後にオプションを渡して、すべてのテストモジュールに転送されるようにします。詳細については、「実行全体とモジュールごとの最小値」を参照してください。

注

グローバル最小値には、.NET 10 SDK (10.0.100) 以降のバージョンが必要です。
--maximum-failed-tests <NUMBER>

指定した数の失敗、エラー、タイムアウト、または取り消されたテストに達した後、実行の完了を停止します。実行はコード 13 で終了します。

.NET 11 以降で使用でき、MTP 2.4 以降が必要です。
--timeout <DURATION>

少なくとも 1 つのテストアプリケーションが実行されている間、指定した期間が経過した後に実行の完了を停止します。正の数の後に、 500ms、 90s、 10m、 2h、 1dなどの単位を指定します。タイムアウトした実行はコード 3 で終了します。

.NET 11 以降で使用でき、MTP 2.4 以降が必要です。
-e|--environment <NAME="VALUE">

テストプロセスの環境変数を設定します。複数の変数を設定するには、このオプションを複数回指定します。コマンドライン値は、起動プロファイルの値をオーバーライドします。

起動プロファイルが存在しない場合、または --no-launch-profile を指定する場合は、.NET SDK 10.0.110 以降を使用します。以前.NET 10 個の SDK バージョンでは、このような場合は変数を無視できます。 .NET 11 以降では、変数は、機能対応のビルド、デバイスの選択、デプロイ、および実行引数のターゲットにもフローします。
-a|--arch <ARCHITECTURE>

ターゲットアーキテクチャを指定します。これは、ランタイム識別子 (RID) を設定する簡単な構文です。指定した値は、既定の RID と組み合わされます。たとえば、win-x64 マシンで --arch x86 と指定すると、RID は win-x86 に設定されます。このオプションを使用する場合は、-r|--runtime オプションは使用しないでください。 .NET 6 Preview 7 以降で使用できます。
--artifacts-path <ARTIFACTS_DIR>

実行されたコマンドからのすべてのビルド出力ファイルは、指定されたパスの下のサブフォルダーに配置され、プロジェクトで区切られます。詳細については、「 Artifacts 出力レイアウトを参照してください。このオプションと指定された値は、dotnetやdotnetを使用する場合など、別のdotnet build --no-restore コマンドの出力に依存する任意のdotnet publish --no-build コマンドで明示的にカスケードする必要があります。 .NET 8 SDK 以降で使用できます。

.NET 11 以降の MTP モードで使用できます。
-c|--configuration <CONFIGURATION>

ビルド構成を定義します。ほとんどのプロジェクトの既定値は Debug ですが、projectのビルド構成設定をオーバーライドできます。
-f|--framework <FRAMEWORK>

テストを実行するターゲットフレームワークのターゲットフレームワークモニカー (TFM)。ターゲットフレームワークは、project ファイルでも指定する必要があります。
--os <OS>

ターゲットオペレーティングシステム (OS) を指定します。これは、ランタイム識別子 (RID) を設定する簡単な構文です。指定した値は、既定の RID と組み合わされます。たとえば、win-x64 マシンで --os linux と指定すると、RID は linux-x64 に設定されます。このオプションを使用する場合は、-r|--runtime オプションは使用しないでください。 .NET 6 以降で使用できます。
-r|--runtime <RUNTIME_IDENTIFIER>

テスト対象のターゲットランタイム。

.NET SDK 7 以降では、短い形式-rを使用できます。

注

グローバル RuntimeIdentifier プロパティ (明示的に、または --arch、 --runtime、または --osを使用して) ソリューションのテストを実行することはサポートされていません。代わりにRuntimeIdentifierを個々のproject レベルに設定します。
--use-current-runtime|--ucr

復元とビルド中に、現在のランタイムをターゲットランタイムとして使用します。

.NET 11 以降で使用できます。このオプションを --test-modulesと組み合わせることはできません。
-v|--verbosity <LEVEL>

コマンドの詳細レベルを設定します。指定できる値は、q[uiet]、m[inimal]、n[ormal]、d[etailed]、および diag[nostic] です。詳細については、LoggerVerbosityを参照してください。
--no-build

テスト projectが実行される前にビルドされていないことを指定します。また、--no-restore フラグも暗黙的に設定します。
--no-dependencies

プロジェクト間参照のビルドをスキップします。

.NET 11 以降で使用できます。
--no-restore

コマンドの実行時に暗黙的な復元が実行されないように指定します。
--nologo|--no-logo|--no-banner

.NETと MTP のスタートアップバナーを非表示にします。 -nologoフォームと/nologoフォーム、およびDOTNET_NOLOGO環境変数もサポートされています。

.NET 11 以降の MTP モードで使用できます。
--no-ansi

ANSI エスケープ文字の画面への出力を無効にします。
--no-progress

画面への進行状況の報告を無効にします。
--no-artifact-post-processing

マルチモジュール実行後の互換性のある成果物の後処理を無効にします。 .NET 11 および MTP 2.4 以降では、登録された成果物の事後プロセッサは、TRX 結果などの互換性のあるレポートを組み合わせることができます。後処理が失敗した場合、SDK は元の成果物とテスト終了コードを保持します。
--output <VERBOSITY_LEVEL>

テスト結果の出力の詳細度を指定します。有効な値は、 Minimal、 Normal、および Detailedです。既定値は Normalです。 Minimal には MTP 2.4 プレビューが必要です。
--show-test-results <OUTCOME>

結果で結果ブロックを選択します。 MTP 2.4 プレビューでは、 passed、 failed、 skipped、 all、または noneを使用します。 failed値には、エラー、タイムアウト、取り消しも含まれます。

passed、failed、およびskippedをコンマ、スペース、または繰り返しの--show-test-resultsオプションと組み合わせます。 allまたはnoneを別の値と組み合わせないでください。この明示的なオプションは、オプションの順序に関係なく、 --output プリセットをオーバーライドします。
--list-tests [text|json]

検出されたテストを実行せずに一覧表示します。値を省略するか、人間が判読できる出力の text を指定します。 .NET 11 以降では、アセンブリ、ターゲットフレームワーク、アーキテクチャ別にテストをグループ化し、使用可能な識別子、ソースの場所、メソッド、パラメーター、特性を含むバージョン管理された JSON ドキュメントのjsonを指定します。
--no-launch-profile

launchSettings.json を使用してアプリケーションを構成しないでください。既定では、 launchSettings.json が使用され、環境変数とコマンドライン引数をテスト実行可能ファイルに適用できます。
--no-launch-profile-arguments

起動プロファイルで commandLineArgs によって指定された引数を使用してアプリケーションを実行しないでください。
--device <DEVICE_ID>

Android または iOS テストプロジェクトのターゲットフレームワークごとに、デバイス、エミュレーター、またはシミュレーターを選択します。 MTP パスは、macOS および Mac Catalyst テストプロジェクトもサポートしています。入力が対話型で、複数のデバイスを使用できる場合は、 dotnet test 1 つを選択するように求めることができます。

.NET 11 以降で使用できます。複数ターゲットプロジェクトの場合は、.NET 11 以降を使用して、デバイス検出で各ターゲットフレームワークが正しく評価されるようにします。 Browser WebAssembly テストプロジェクトは、このオプションではサポートされていません。
--list-devices

テストを実行せずにプロジェクトで使用可能なデバイスを一覧表示します。ソリューションではなくプロジェクトを指定します。

.NET 11 以降で使用できます。
--collect-test-map と --affected-tests

リポジトリテストマップを収集するか、変更の影響を受けるテストを実行します。これらの試験的なオプションには、個別に分散された拡張機能と DOTNET_CLI_ENABLE_AFFECTED_TESTS=1 環境変数が必要です。 2 つのオプションを組み合わせることはできません。影響を受けるテストワークフローでは、デバイステスト、並列テストモジュール、または最小テストポリシーもサポートされません。

.NET 11 以降で使用できます。
--property:<NAME>=<VALUE>

1 つ以上の MSBuild プロパティを設定します。オプションを繰り返して、複数のプロパティを指定します。
```
--property:<NAME1>=<VALUE1> --property:<NAME2>=<VALUE2>
```
短い形式の -p を --property に使用することができます。同じことが /property:property=value に適用され、その短い形式は /pです。使用可能な引数の詳細については、 dotnet msbuild のドキュメントを参照してください。
-?|-h|--help

コマンドの使用方法を示した説明を出力します。
args

テストアプリケーションに渡す追加の引数を指定します。複数の引数を指定する場合は、空白で区切ります。渡す内容の詳細と例については、 MTP の概要と MTP の機能に関するページを参照してください。

ヒント

特定のプロジェクトに追加の引数を指定するには、TestingPlatformCommandLineArguments MSBuild プロパティを使用します。このプロパティは、ソリューションがテストフレームワーク (MSTest や xUnit.net など) を混在させたり、一部のプロジェクトのみが特定の拡張機能を参照したりする場合に特に便利です。詳細については、「テストフレームワークまたは拡張機能が混在するソリューション」を参照してください。

注

ファイルへのトレースログを有効にするには、環境変数 DOTNET_CLI_TEST_TRACEFILE を使用して、トレースファイルへのパスを指定します。

.NET 11 以降では、dotnet test -blはマルチプロジェクト、マルチターゲット、デバイスの実行に 1 つの MSBuild セッションを使用して、バイナリログに完全なビルドが含まれるようにします。

出力と取り消しの動作

.NET 11 以降では、対話型の ANSI 出力に現在実行中のテストが表示され、アセンブリごとのテスト数が報告されます。出力がリダイレクトされた場合、ANSI または進行状況の出力が無効になっている場合、または環境が対話型でない場合、進行状況の表示は無効のままです。

.NET 11 以降では、最初の Ctrl+C は新しいテストアプリケーションのスケジュールを停止し、協調的な取り消しを要求します。 Ctrl+C キーをもう一度押して、子プロセスを直ちに終了します。中止された実行は、コード 3 で終了します。

ライブテストホストの出力には、プロトコル 1.1 以降をサポートする MTP ホストが必要です。古いホストでは、出力がキャプチャされ、失敗したモジュールに対して再生されます。 .NET 11 以降では、障害の概要では、キャプチャされた標準出力が最初の 30 行と最後の 10 行まで 40 行を超えて切り捨てられます。診断ログには完全な出力が保持されます。

複数モジュールの実行の場合、dotnet testは、.NET 11 以降の実行全体でゼロテストの結果を評価します。テストのないモジュールは、明示的な最小テストポリシーでより多くのテストが必要でない限り、別のモジュールがテストを正常に実行しても、実行に失敗しません。

結果と成果物

.NET SDK 10.0.200 以降と MTP 2.3.1 以降では、既定の結果ディレクトリは、dotnet testを呼び出すディレクトリの下にTestResultsされます。 SDK は、 DOTNET_CLI_TEST_COMMAND_WORKING_DIRECTORYを通じてそのディレクトリを提供します。MTP はその作業ディレクトリとして使用され、既定の結果のベースとして使用されます。以前は、各テストアプリケーションがベースとして独自の出力ディレクトリを使用しました。

既定の flat レイアウトでは、同じ呼び出しのテストアプリケーションが結果ディレクトリを共有します。相対レポートパスを分離するには、 --results-directory-layout per-moduleを使用します。カバレッジ固有のファイル名と競合リスクについては、「カバレッジ出力ファイル」を参照してください。

SDK アーティファクトの出力レイアウトが有効になっている場合、.NET 11 以降のバージョンでは、MTP レポート、カバレッジファイル、診断が既定で<ArtifactsPath>/test/<project>/<pivot>下に配置されます。明示的な --results-directory または --results-directory-layout が優先されます。

.NET 11 および MTP 2.4 以降では、互換性のある拡張機能でマルチモジュール実行から成果物を後処理できます。たとえば、TRX 拡張機能では、モジュールごとのレポートを保持しながら、マージされたレポートを作成できます。拡張機能とレポートの要件については、 MTP テストレポートを参照してください。

引数をテストアプリケーションに転送する

dotnet test は、認識されないトークンをテストアプリケーションに転送します。認識されないオプション名とその値の間に認識されたオプションが表示される場合、認識されたオプションを削除すると、残りのトークンがテストアプリケーションのオプションにバインドされる方法が変わる可能性があります。このあいまいさを回避するには、リテラル --の後にテストアプリケーション引数を配置します。

dotnet test --results-directory TestResults -- --report-trx --report-trx-filename A.trx

前の例では、直接パッケージ参照として、またはそれを含むテスト SDK 構成を使用して、 Microsoft.Testing.Extensions.TrxReport パッケージが必要です。

同じパーサーの動作は、 dotnet run と dotnet buildにも適用されます。詳細な例については、リファレンスのdotnet run」を参照してください。

実行全体とモジュールごとの最小値

--minimum-expected-testsの場合、--区切り記号によってオプションのスコープが決まります。

前の引数--はグローバルです。 dotnet test オーケストレーターは、実行全体についてそれらを解釈します。
後の引数--はローカルです。 dotnet test は各テストモジュールに転送されるため、各モジュールは個別に適用されます。

--minimum-expected-testsは両方のスコープで使用できるため、実行全体、各モジュール、またはその両方に最低限必要な場合があります。

dotnet test --minimum-expected-tests 5 -- --minimum-expected-tests 2

上記のコマンドでは、実行全体で少なくとも 5 つのテストと、各テストモジュールで少なくとも 2 つのテストが必要です。

2 つのスコープでは、スキップされたテストの数が異なります。

Scope	スキップされたテストは最小値にカウントされますか?
グローバル	Yes. `dotnet test`集計された合計には、スキップされたテストが含まれます。
モジュールごと	No. MTP は、実行されたテストの数からスキップされたテストを除外します。

.NET 11 SDK 以降、実行全体に対するゼロテストの判定は、集計された結果から 1 回決定されます。 --test-modulesやグローバル --filterなど、テストに一致しないモジュールはコード 8 (ZeroTests) で終了しますが、結果が集計される前にそのコードは成功に正規化されます。その結果、1 つの空のモジュールで実行全体が失敗することはありませんが、モジュールは Exit code: 8 診断を出力に保持して可視性を確保します。

MTP 2.3.0 以降のバージョンでは、 --zero-tests-policy <allow-skipped|strict>が提供されます。既定値の allow-skipped では、スキップされたモジュールがすべて成功します。 strict値はスキップされたテストを実行しないものとして扱うので、スキップされたモジュールはすべてコード 8 で終了します。 --後にオプションを渡して、各テストモジュールに転送します。

dotnet test -- --zero-tests-policy strict

グローバル最小値を設定しない場合、.NET 11 SDK によって、実行全体のゼロテストの判定が個別に決定されます。モジュールごとの --zero-tests-policy 値に関係なく、すべてスキップされた実行全体がコード 8 で終了します。

--minimum-expected-testsを指定しても最小値が満たされない場合、終了コード 9 (MinimumExpectedTestsPolicyViolation) で実行が失敗します。このコードは 8 とは異なり、より厳密なグローバルまたはモジュールごとの最小値が空のモジュールと混同されないようにします。モジュールがゼロテストを実行したときにモジュールごとの最小値がコード 9 を返すには、テストモジュールで MTP 2.3.0 以降のバージョンを使用する必要があります。

注

--minimum-expected-tests 0 が無効です。ゼロテスト終了コードを抑制するには、 --ignore-exit-code 8を使用します。

.NET 11 以降では、テストアプリケーションではなく、--tl、--terminallogger、および--tlpが MSBuild に転送されます。 .NET 12 Preview 1 以降では、認識された-mtフォームと-multiThreaded フォームも MSBuild に転送されます。これらの名前のいずれかを使用してアプリケーションオプションを渡すには、 --の後に配置します。

--helpや--list-testsなどの実行モードオプションをdotnet testに直接渡します。 .NET 11 以降では、SDK はテストアプリケーションとネゴシエートされた実行モードを検証します。起動プロファイルまたは TestingPlatformCommandLineArguments がこれらのオプションのいずれかを挿入した場合、要求された SDK 操作とアプリケーション操作が一致せず、診断で実行が失敗します。

例示

現在のディレクトリのprojectまたはソリューションでテストを実行します。
```
dotnet test
```

TestProject projectでテストを実行します。

dotnet test --project ./TestProject/TestProject.csproj

TestProjects ソリューションでテストを実行します。
```
dotnet test --solution ./TestProjects/TestProjects.sln
```
TestProject.dll アセンブリを使用してテストを実行します。
```
dotnet test --test-modules "**/bin/**/Debug/net10.0/TestProject.dll"
```
ルートディレクトリ TestProject.dll アセンブリを使用してテストを実行します。
```
dotnet test --test-modules "**/bin/**/Debug/net10.0/TestProject.dll" --root-directory "c:\code"
```
.NET 11 以降のトラバーサルプロジェクトによって参照されるすべてのテストプロジェクトを実行します。
```
dotnet test dirs.proj
```
.NET 11 以降でテストを JSON として一覧表示します。
```
dotnet test --list-tests json
```
.NET 12 Preview 1 以降を使用して C# ファイルベースの MTP テストアプリを実行します。
```
dotnet test App.Tests.cs
```
Microsoft Code Coverage 拡張機能を使用して、現在のディレクトリでテストを実行します。テストアプリケーションは、 Microsoft.Testing.Extensions.CodeCoverageを直接参照するか、それを含むテスト SDK 構成を使用して参照する必要があります。
```
dotnet test --coverage
```
テストを実行し、特定のディレクトリに結果を格納します。
```
dotnet test --results-directory ./TestResults
```
特定のディレクトリで診断出力を使用してテストを実行します。
```
dotnet test --diagnostic-output-directory ./Diagnostics
```
少なくとも 10 個のテストが実行されていることを確認して、テストを実行します。
```
dotnet test --minimum-expected-tests 10
```
実行全体で少なくとも 5 つのテストと、各テストモジュールで少なくとも 2 つのテストが必要です。
```
dotnet test --minimum-expected-tests 5 -- --minimum-expected-tests 2
```
TestProject project でテストを実行し、-bl (バイナリログ) 引数を msbuild に指定します。
```
dotnet test --project ./TestProject/TestProject.csproj -bl
```
TestProject project でテストを実行し、MSBuild DefineConstants プロパティを DEV に設定します。
```
dotnet test --project ./TestProject/TestProject.csproj -p:DefineConstants="DEV"
```

こちらも参照ください

フィードバック

このページはお役に立ちましたか?

最終更新: 2026-11-10