本文提供 Microsoft.Testing.Platform 命令列選項的一個核心入口。
平台選項
@指定回應檔的名稱。 回應檔案名稱必須緊接
@字元後面,且字元與回應檔案名稱之間@不得留白。回應檔中的選項將被解讀為彷彿它們在命令列的那個位置。 你不能用反斜線字
\元來串接行數。 使用回應檔案可以幫助處理可能超出終端機限制的長命令行。 您可以將回應檔與內嵌命令行自變數結合。 例如:./TestExecutable.exe @"filter.rsp" --timeout 10s其中 filter.rsp 可以有下列內容:
--filter "A very long filter"或者,單一 rsp 檔案可用來指定逾時和篩選,如下所示:
./TestExecutable.exe @"arguments.rsp"--filter "A very long filter" --timeout 10s備註
使用
dotnet test時,SDK 命令列解析器採用逐行標記法,回應檔案中的每一行視為單一標記。 此時,每個參數必須在獨立的行上:--filter A very long filter --timeout 10s--config-file指定 testconfig.json 檔案。
--diagnostic啟用診斷記錄。 預設的日誌層級是
Trace。 檔案會以以下命名格式寫入輸出目錄:log_[MMddHHssfff].diag。--diagnostic-synchronous-write強制內建檔案記錄器同步寫入記錄。 適用於如果程序崩潰時,您不想遺失任何日誌條目的情況。 這會拖慢測試執行速度。
--diagnostic-output-directory診斷記錄的輸出目錄,如果未指定的話,檔案會產生在預設的 TestResults 目錄中。
--diagnostic-file-prefix記錄檔名稱的前置詞。 預設為
"log"。--diagnostic-verbosity當使用
--diagnostic開關時,定義訊息顯示的詳盡程度。 可用的值為Trace、Debug、Information、Warning、Error或Critical。--exit-on-process-exit如果依賴進程結束,則離開測試進程。 必須提供 PID。
--help輸出有關如何使用命令的說明。
--ignore-exit-code允許忽略某些非零結束代碼,並改為以
0傳回 。 如需更多資訊,請參閱 忽略特定退出代碼。--info顯示 .NET 測試應用程式的進階資訊,例如:
- 平臺。
- 環境。
- 每個已註冊的命令行提供者,例如其
name、version、description和options。 - 每個已註冊的工具,例如其
command、name、version、description等和所有指令行提供者。
這項功能可用來瞭解那些將註冊相同命令列選項的擴充功能,或多個擴充功能版本(或平台)之間的可用選項變化。
--list-tests列出可用的測試。 測試不會執行。
--maximum-failed-tests指定達到的測試失敗數目上限,當達到時,將會停止測試回合。 若要支援此切換,架構作者需要實作
IGracefulStopTestExecutionCapability功能。 到達該測試失敗數量時的退出代碼為13。 如需詳細資訊,請參閱 Microsoft.Testing.Platform 結束代碼。備註
此功能可從 1.5 版開始的 Microsoft.Testing.Platform 中使用。
--minimum-expected-tests指定預期要執行的測試數目下限。 根據預設,至少應該執行一個測試。
--results-directory測試結果將要放置的目錄。 如果指定的目錄不存在,則會建立它。 預設是在包含測試應用程式的目錄中的
TestResults。--timeout全域測試執行逾時。 採用一個自變數做為字串,格式
<value>[h|m|s]其中<value>為 float。
各情境的延伸選項
請參考下表快速找到延長選項。
| Scenario | 功能文件 |
|---|---|
| 收集程式代碼涵蓋範圍 | 程式碼涵蓋範圍 |
| 收集崩潰或懸掛的備份 | 崩潰與懸浮傾倒 |
| 產生測試報告(例如 TRX) | 測試報告 |
| 自訂終端輸出 | 終端輸出 |
| 套用主機層級控制 | 即時重載 |
| 重試未通過測試 | 重試 |
| 執行使用 Microsoft Fakes 框架的測試 | Microsoft 假貨 |
| 發布 OpenTelemetry 的追蹤與指標 | OpenTelemetry |
在你的測驗應用程式中發現選項
執行您的測試可執行檔 --help 以列出當前擴充套件集中可用的選項。
若要對註冊醫療提供者及選項進行進階診斷,請使用 --info。