閱讀英文

共用方式為


dotnet vstest

本文適用於: ✔️ .NET Core 3.1 SDK 與更新版本

重要

dotnet vstest 命令已由 dotnet test 取代,現在可用於執行組件。 請參閱 dotnet test

名稱

dotnet vstest:執行指定組件中的測試。

概要

dotnet vstest [<TEST_FILE_NAMES>] [--Blame] [--Diag <PATH_TO_LOG_FILE>]
    [--Framework <FRAMEWORK>] [--InIsolation] [-lt|--ListTests <FILE_NAME>]
    [--logger <LOGGER_URI/FRIENDLY_NAME>] [--Parallel]
    [--ParentProcessId <PROCESS_ID>] [--Platform] <PLATFORM_TYPE>
    [--Port <PORT>] [--ResultsDirectory<PATH>] [--Settings <SETTINGS_FILE>]
    [--TestAdapterPath <PATH>] [--TestCaseFilter <EXPRESSION>]
    [--Tests <TEST_NAMES>] [[--] <args>...]]

dotnet vstest -?|--Help

描述

dotnet vstest 命令會執行 VSTest.Console 命令列應用程式,以執行自動化的單元測試。

引數

  • TEST_FILE_NAMES

    從指定的組件執行測試。 以空格分隔多個測試組件名稱。 支援萬用字元。

選項。

  • --Blame

    在歸責模式下執行測試。 這個選項有助於隔離造成測試主機損毀的問題。 它會以 Sequence.xml 的形式在目前目錄中建立一個輸出檔,用來擷取損毀前的測試執行順序。

  • --Diag <PATH_TO_LOG_FILE>

    啟用測試平台的詳細資訊記錄檔。 記錄檔會寫入提供的檔案。

  • --Framework <FRAMEWORK>

    用於測試執行的目標 .NET Framework 版本。 有效值的範例包括 .NETFramework,Version=v4.6.NETCoreApp,Version=v1.0。 其他支援的值為 Framework40Framework45FrameworkCore10FrameworkUap10

  • --InIsolation

    在獨立的處理序中執行測試。 這樣會降低 vstest.console.exe 處理序在測試中錯誤處停止的可能性,但是測試的速度可能會比較慢。

  • -lt|--ListTests <FILE_NAME>

    列出所有從指定之測試容器探索到的測試。

  • --logger <LOGGER_URI/FRIENDLY_NAME>

    指定測試結果的記錄器。

    • 若要將測試結果發行至 Team Foundation Server 中,使用 TfsPublisher 記錄器提供者:

      /logger:TfsPublisher;
          Collection=<team project collection url>;
          BuildName=<build name>;
          TeamProject=<team project name>
          [;Platform=<Defaults to "Any CPU">]
          [;Flavor=<Defaults to "Debug">]
          [;RunTitle=<title>]
      
    • 若要將結果記錄到 Visual Studio 測試結果檔案 (TRX),使用 trx 記錄器提供者。 這個參數會以指定的記錄檔名稱,在測試結果目錄中建立檔案。 如果沒有提供 LogFileName,會建立唯一的檔案名稱以保留測試結果。

      /logger:trx [;LogFileName=<Defaults to unique file name>]
      
  • --Parallel

    平行執行測試。 根據預設,電腦上所有的可用核心都可供使用。 在 runsettings 檔案中的 RunConfiguration 節點下設定 MaxCpuCount 屬性,以指定明確的核心數目。

  • --ParentProcessId <PROCESS_ID>

    負責啟動目前處理序之父處理序的處理序識別碼。

  • --Platform <PLATFORM_TYPE>

    用於測試執行的目標平台架構。 有效值為 x86x64ARM

  • --Port <PORT>

    指定通訊端連線和接收事件訊息的連接埠。

  • --ResultsDirectory:<PATH>

    如果測試結果目錄不存在,則會在指定的路徑中建立該目錄。

  • --Settings <SETTINGS_FILE>

    執行測試時要使用的設定。

  • --TestAdapterPath <PATH>

    在測試回合中,從指定的路徑 (如果有的話) 使用自訂測試配接器。

  • --TestCaseFilter <EXPRESSION>

    執行符合指定之運算式的測試。 <EXPRESSION> 的格式為 <property>Operator<value>[|&<EXPRESSION>],其中 Operator (運算子) 為 =!=~ 其中之一。 運算子 ~ 具有「包含」語意,且適用於像是 DisplayName 的字串屬性。 括弧 () 用於將子運算式分組。 如需詳細資訊,請參閱 TestCase 篩選

  • --Tests <TEST_NAMES>

    執行測試,其名稱符合所提供的值。 以逗號分隔多個值。

  • -?|--Help

    印出命令的簡短說明。

  • @<file>

    請讀取回應檔以取得更多選項。

  • args

    指定要傳遞至配接器的額外引數。 引數指定為格式 <n>=<v> 的名稱/值組,其中 <n> 是引數名稱而 <v> 是引數值。 使用空格來分隔多個引數。

範例

mytestproject.dll 中執行測試:

dotnet vstest mytestproject.dll

mytestproject.dll 中執行測試,以自訂名稱匯出到自訂資料夾:

dotnet vstest mytestproject.dll --logger:"trx;LogFileName=custom_file_name.trx" --ResultsDirectory:custom/file/path

mytestproject.dllmyothertestproject.exe 中執行測試:

dotnet vstest mytestproject.dll myothertestproject.exe

執行 TestMethod1 測試:

dotnet vstest /Tests:TestMethod1

執行 TestMethod1TestMethod2 測試:

dotnet vstest /Tests:TestMethod1,TestMethod2

另請參閱