dotnet vstest

Dit artikel is van toepassing op: ✔️ .NET Core 3.1 SDK en latere versies

Belangrijk

De dotnet vstest opdracht wordt vervangen door dotnet test, die nu kan worden gebruikt om assembly's uit te voeren. Zie dotnet-test.

Naam

dotnet vstest - Voert tests uit van de opgegeven assembly's.

Synopsis

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

Beschrijving

Met dotnet vstest de opdracht wordt de VSTest.Console opdrachtregeltoepassing uitgevoerd om geautomatiseerde eenheidstests uit te voeren.

Argumenten

• TEST_FILE_NAMES

  Voer tests uit vanaf de opgegeven assembly's. Scheid meerdere testassemblynamen met spaties. Jokertekens worden ondersteund.

Opties

• --Blame

  Voert de tests uit in de modus Blame. Deze optie is handig bij het isoleren van de problematische tests waardoor de testhost vastloopt. Er wordt een uitvoerbestand in de huidige map gemaakt als Sequence.xml waarin de volgorde van de uitvoering van de tests vóór de crash wordt vastgelegd.

• --Diag <PATH_TO_LOG_FILE>

  Hiermee worden uitgebreide logboeken voor het testplatform ingeschakeld. Logboeken worden naar het opgegeven bestand geschreven.

• --Framework <FRAMEWORK>

  Doelversie .NET Framework die wordt gebruikt voor de uitvoering van de test. Voorbeelden van geldige waarden zijn .NETFramework,Version=v4.6 of .NETCoreApp,Version=v1.0. Andere ondersteunde waarden zijn Framework40, Framework45, FrameworkCore10en FrameworkUap10.

• --InIsolation

  Voert de tests uit in een geïsoleerd proces. Hierdoor wordt vstest.console.exe proces minder waarschijnlijk gestopt bij een fout in de tests, maar worden tests mogelijk langzamer uitgevoerd.

• -lt|--ListTests <FILE_NAME>

  Een lijst met alle gedetecteerde tests van de opgegeven testcontainer.

• --logger <LOGGER_URI/FRIENDLY_NAME>

  Geef een logboekregistratie op voor testresultaten.

  • Als u testresultaten wilt publiceren naar Team Foundation Server, gebruikt u de TfsPublisher logboekregistratieprovider:

    /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>]
    

  • Gebruik de trx logboekprovider om resultaten te registreren bij een Visual Studio Test Results File (TRX). Met deze schakeloptie maakt u een bestand in de map met testresultaten met de naam van het logboekbestand. Als LogFileName niet wordt opgegeven, wordt er een unieke bestandsnaam gemaakt om de testresultaten op te slaan.

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

• --Parallel

  Voer tests parallel uit. Standaard zijn alle beschikbare kernen op de computer beschikbaar voor gebruik. Geef een expliciet aantal kernen op door de MaxCpuCount eigenschap in te stellen onder het RunConfiguration knooppunt in het bestand runsettings .

• --ParentProcessId <PROCESS_ID>

  Proces-id van het bovenliggende proces dat verantwoordelijk is voor het starten van het huidige proces.

• --Platform <PLATFORM_TYPE>

  Doelplatformarchitectuur die wordt gebruikt voor testuitvoering. Geldige waarden zijn x86, x64en ARM.

• --Port <PORT>

  Hiermee geeft u de poort voor de socketverbinding en het ontvangen van de gebeurtenisberichten.

• --ResultsDirectory:<PATH>

  De map met testresultaten wordt gemaakt in het opgegeven pad als deze niet bestaat.

• --Settings <SETTINGS_FILE>

  Instellingen die moeten worden gebruikt bij het uitvoeren van tests.

• --TestAdapterPath <PATH>

  Gebruik aangepaste testadapters van een bepaald pad (indien aanwezig) in de testuitvoering.

• --TestCaseFilter <EXPRESSION>

  Voer tests uit die overeenkomen met de opgegeven expressie. <EXPRESSION> heeft de indeling <property>Operator<value>[|&<EXPRESSION>], waarbij Operator een van =, !=of ~is. De operator ~ heeft 'contains'-semantiek en is van toepassing op tekenreekseigenschappen zoals DisplayName. Haakjes () worden gebruikt om subexpressies te groepeert. Zie TestCase-filter voor meer informatie.

• --Tests <TEST_NAMES>

  Voer tests uit met namen die overeenkomen met de opgegeven waarden. Meerdere waarden scheiden met komma's.

• -?|--Help

  Hiermee drukt u een korte help voor de opdracht af.

• @<file>

  Leest het antwoordbestand voor meer opties.

• args

  Hiermee geeft u extra argumenten om door te geven aan de adapter. Argumenten worden opgegeven als naam-waardeparen van de vorm <n>=<v>, waarbij <n> de naam van het argument en <v> de waarde van het argument is. Gebruik een spatie om meerdere argumenten van elkaar te scheiden.

Voorbeelden

Voer tests uit in mytestproject.dll:

dotnet vstest mytestproject.dll

Voer tests uit in mytestproject.dll, exporteren naar aangepaste map met aangepaste naam:

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

Voer tests uit in mytestproject.dll en myothertestproject.exe:

dotnet vstest mytestproject.dll myothertestproject.exe

Tests uitvoeren TestMethod1 :

dotnet vstest /Tests:TestMethod1

Uitvoeren TestMethod1 en TestMethod2 testen:

dotnet vstest /Tests:TestMethod1,TestMethod2

Zie ook

• VSTest.Console.exe opdrachtregelopties