dotnet vstest

Den här artikeln gäller för: ✔️ .NET 6 SDK och senare versioner

Viktigt!

Kommandot dotnet vstest ersätts av dotnet test, som nu kan användas för att köra sammansättningar. Se dotnet-test.

Namn

dotnet vstest – Kör tester från de angivna sammansättningarna.

Sammanfattning

dotnet vstest [<TEST_FILE_NAMES>] [--Blame] [--Collect:<DATA_COLLECTOR_NAME>]
    [--Diag:<PATH_TO_LOG_FILE>] [-e|--Environment:<NAME="VALUE">]
    [--Framework:<FRAMEWORK>] [--InIsolation] [-lt|--ListTests:<FILE_NAME>]
    [--logger:<LOGGER_URI/FRIENDLY_NAME>] [--Parallel]
    [--Platform:<PLATFORM_TYPE>] [--ResultsDirectory:<PATH>]
    [--Settings:<SETTINGS_FILE>] [--TestAdapterPath:<PATH>]
    [--TestCaseFilter:<EXPRESSION>] [--Tests:<TEST_NAMES>] [[--] <args>...]

dotnet vstest -?|--Help

Description

Kommandot dotnet vstest kör VSTest.Console kommandoradsprogrammet för att köra automatiserade enhetstester. Alternativen i den här artikeln vidarebefordras till vstest.console. En fullständig lista över kommandoradsalternativ finns ivstest.console.exe kommandoradsalternativ.

Arguments

  • TEST_FILE_NAMES

    Kör tester från de angivna sammansättningarna. Avgränsa flera testsammansättningsnamn med blanksteg. Jokertecken stöds.

Options

  • --Blame

    Kör testerna i skuldläge. Det här alternativet är användbart när du isolerar problematiska tester som gör att testvärden kraschar. Den skapar en utdatafil i den aktuella katalogen som Sequence.xml som samlar in körningsordningen för testerna före kraschen.

  • --Collect:<DATA_COLLECTOR_NAME>

    Aktiverar en datainsamlare för testkörningen. Samlar till exempel --Collect:"Code Coverage" in kodtäckning med den inbyggda Visual Studio-insamlaren och --Collect:"XPlat Code Coverage" använder den plattformsoberoende Coverlet-insamlaren. Mer information finns i Övervaka och analysera testkörning.

  • --Diag:<PATH_TO_LOG_FILE>

    Aktiverar utförliga loggar för testplattformen. Loggar skrivs till den angivna filen.

  • -e|--Environment:<NAME="VALUE">

    Anger värdet för en miljövariabel för testvärdprocessen. Skapar variabeln om den inte finns, åsidosätter den om den gör det. Med det här alternativet tvingar du testerna att köras i en isolerad process. Ange alternativet flera gånger för att ange flera variabler.

  • --Framework:<FRAMEWORK>

    Målversion av .NET Framework som används för testkörning. Ett exempel på ett giltigt värde är .NETFramework,Version=v7.0. Andra värden som stöds är Framework40, Framework45, FrameworkCore10och FrameworkUap10.

  • --InIsolation

    Kör testerna i en isolerad process. Detta gör vstest.console.exe processen mindre sannolikt att stoppas vid ett fel i testerna, men testerna kan köras långsammare.

  • -lt|--ListTests:<FILE_NAME>

    Visar en lista över alla identifierade tester från den angivna testcontainern.

  • --logger:<LOGGER_URI/FRIENDLY_NAME>

    Ange en logger för testresultat.

    • Om du vill publicera testresultat till Team Foundation Server använder du loggerprovidern 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>]

    • Om du vill logga resultat till en Visual Studio-testresultatfil (TRX) använder du loggningsprovidern trx . Den här växeln skapar en fil i testresultatkatalogen med det angivna loggfilnamnet. Om LogFileName inte anges skapas ett unikt filnamn för att lagra testresultaten.

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

  • --Parallel

    Kör tester parallellt. Som standard är alla tillgängliga kärnor på datorn tillgängliga för användning. Ange ett explicit antal kärnor genom att ange MaxCpuCount egenskapen under RunConfiguration noden i filen runsettings .

  • --Platform:<PLATFORM_TYPE>

    Målplattformsarkitektur som används för testkörning. Giltiga värden är x86, x64, ARM, ARM64, S390x, Ppc64le, RiscV64och LoongArch64.

  • --ResultsDirectory:<PATH>

    Testresultatkatalogen skapas i den angivna sökvägen om den inte finns.

  • --Settings:<SETTINGS_FILE>

    Inställningar som ska användas när du kör tester.

  • --TestAdapterPath:<PATH>

    Använd anpassade testkort från en viss sökväg (om någon) i testkörningen.

  • --TestCaseFilter:<EXPRESSION>

    Kör tester som matchar det angivna uttrycket. <EXPRESSION> är av formatet <property>Operator<value>[|&<EXPRESSION>], där Operator är en av =, !=eller ~. Operatorn ~ har semantiken "contains" och gäller för strängegenskaper som DisplayName. Parenteser () används för att gruppera underuttryck. Mer information finns i TestCase-filtret.

  • --Tests:<TEST_NAMES>

    Kör tester med namn som matchar de angivna värdena. Avgränsa flera värden med kommatecken.

  • -?|--Help

    Skriver ut en kort hjälp för kommandot.

  • @<file>

    Läser svarsfilen för fler alternativ.

  • args

    Anger extra argument som ska skickas till adaptern. Argument anges som namn/värde-par i formuläret <n>=<v>, där <n> är argumentnamnet och <v> är argumentvärdet. Använd ett blanksteg för att separera flera argument.

Examples

Kör tester i mytestproject.dll:

dotnet vstest mytestproject.dll

Kör tester i mytestproject.dlloch exportera till en anpassad mapp med anpassat namn:

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

Kör tester i mytestproject.dll och myothertestproject.exe:

dotnet vstest mytestproject.dll myothertestproject.exe

Kör TestMethod1 tester:

dotnet vstest /Tests:TestMethod1

Kör TestMethod1 och TestMethod2 testa:

dotnet vstest /Tests:TestMethod1,TestMethod2

Se även

  • Last updated on