dotnet vstest

Dieser Artikel gilt für: ✔️ .NET 6 SDK und höhere Versionen

Von Bedeutung

Der dotnet vstest Befehl wird durch dotnet testersetzt, der jetzt zum Ausführen von Assemblys verwendet werden kann. Siehe dotnet test.

Name

dotnet vstest - Führt Tests aus den angegebenen Assemblys aus.

Zusammenfassung

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

Der dotnet vstest Befehl führt die VSTest.Console Befehlszeilenanwendung aus, um automatisierte Komponententests auszuführen. Die Optionen in diesem Artikel werden weitergeleitet an vstest.console. Die vollständige Liste der Befehlszeilenoptionen finden Sie unter vstest.console.exe Befehlszeilenoptionen.

Arguments

  • TEST_FILE_NAMES

    Führen Sie Tests aus den angegebenen Assemblys aus. Trennen Sie mehrere Testassemblynamen durch Leerzeichen. Platzhalter werden unterstützt.

Options

  • --Blame

    Führt die Tests im blame-Modus aus. Diese Option ist hilfreich beim Isolieren der problematischen Tests, die zu einem Absturz des Testhosts führen. Es erstellt eine Ausgabedatei im aktuellen Verzeichnis als Sequence.xml , die die Reihenfolge der Testausführung vor dem Absturz erfasst.

  • --Collect:<DATA_COLLECTOR_NAME>

    Aktiviert einen Datensammler für die Testausführung. Sammelt z. B--Collect:"Code Coverage". Codeabdeckung mit dem integrierten Visual Studio Collector und --Collect:"XPlat Code Coverage" verwendet den plattformübergreifenden Coverlet-Sammler. Weitere Informationen finden Sie unter Monitor and analyze test run (Überwachen und Analysieren eines Testlaufs).

  • --Diag:<PATH_TO_LOG_FILE>

    Aktiviert ausführliche Protokolle für die Testplattform. Protokolle werden in die bereitgestellte Datei geschrieben.

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

    Legt den Wert einer Umgebungsvariable für den Testhostprozess fest. Erstellt die Variable, wenn sie nicht vorhanden ist, setzt sie außer Kraft, wenn dies der Fall ist. Die Verwendung dieser Option erzwingt die Ausführung der Tests in einem isolierten Prozess. Geben Sie die Option mehrmals an, um mehrere Variablen festzulegen.

  • --Framework:<FRAMEWORK>

    Zielversion von .NET Framework, die für die Testausführung verwendet wird. Ein Beispiel für einen gültigen Wert ist .NETFramework,Version=v7.0. Andere unterstützte Werte sind Framework40, , Framework45, FrameworkCore10und FrameworkUap10.

  • --InIsolation

    Führt die Tests in einem isolierten Prozess aus. Dadurch wird vstest.console.exe Prozess weniger wahrscheinlich bei einem Fehler in den Tests beendet, aber Tests können langsamer ausgeführt werden.

  • -lt|--ListTests:<FILE_NAME>

    Listet alle ermittelten Tests aus dem angegebenen Testcontainer auf.

  • --logger:<LOGGER_URI/FRIENDLY_NAME>

    Geben Sie einen Logger für Testergebnisse an.

    • Verwenden Sie den TfsPublisher Loggeranbieter, um Testergebnisse auf Team Foundation Server zu veröffentlichen:

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

    • Um Ergebnisse in einer Visual Studio Test Results File (TRX) zu protokollieren, verwenden Sie den trx Protokollieranbieter. Mit diesem Switch wird eine Datei im Testergebnisverzeichnis mit dem angegebenen Protokolldateinamen erstellt. Falls LogFileName nicht angegeben, wird ein eindeutiger Dateiname erstellt, um die Testergebnisse aufzunehmen.

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

  • --Parallel

    Mit dieser Option können Sie Tests parallel ausführen. Standardmäßig sind alle verfügbaren Kerne auf dem Computer zur Verwendung verfügbar. Geben Sie eine explizite Anzahl von Kernen an, indem Sie die MaxCpuCount Eigenschaft unter dem RunConfiguration Knoten in der Runsettings-Datei festlegen.

  • --Platform:<PLATFORM_TYPE>

    Zielplattformarchitektur, die für die Testausführung verwendet wird. Gültige Werte sind x86: , x64, ARM, ARM64, S390x, Ppc64leund RiscV64LoongArch64.

  • --ResultsDirectory:<PATH>

    Das Verzeichnis der Testergebnisse wird im angegebenen Pfad erstellt, falls nicht vorhanden.

  • --Settings:<SETTINGS_FILE>

    Einstellungen, die beim Ausführen von Tests verwendet werden sollen.

  • --TestAdapterPath:<PATH>

    Verwenden Sie benutzerdefinierte Testadapter aus einem bestimmten Pfad (sofern vorhanden) in der Testausführung.

  • --TestCaseFilter:<EXPRESSION>

    Führen Sie Tests aus, die dem angegebenen Ausdruck entsprechen. <EXPRESSION> ist des Formats <property>Operator<value>[|&<EXPRESSION>], wobei Operator eine von =, , !=oder ~. Der Operator ~ verfügt über 'contains'-Semantik und gilt für Zeichenfolgeneigenschaften wie DisplayName. Klammern () werden verwendet, um Unterausdrücke zu gruppieren. Weitere Informationen finden Sie im Testcase-Filter.

  • --Tests:<TEST_NAMES>

    Führen Sie Tests mit Namen aus, die den bereitgestellten Werten entsprechen. Trennen Sie die einzelnen Werte durch Kommata.

  • -?|--Help

    Druckt eine kurze Hilfe für den Befehl.

  • @<file>

    Liest die Antwortdatei für weitere Optionen.

  • args

    Gibt zusätzliche Argumente an, die an den Adapter übergeben werden sollen. Argumente werden als Name-Wert-Paare des Formulars <n>=<v>angegeben, wobei <n> es sich um den Argumentnamen und <v> den Argumentwert handelt. Trennt mehrere Argumente durch Leerzeichen.

Examples

Ausführen von Tests in mytestproject.dll:

dotnet vstest mytestproject.dll

Führen Sie Tests in mytestproject.dllaus, die in einen benutzerdefinierten Ordner mit benutzerdefiniertem Namen exportiert werden:

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

Ausführen von Tests in mytestproject.dll und myothertestproject.exe:

dotnet vstest mytestproject.dll myothertestproject.exe

Ausführen von TestMethod1 Tests:

dotnet vstest /Tests:TestMethod1

Ausführen TestMethod1 und TestMethod2 Tests:

dotnet vstest /Tests:TestMethod1,TestMethod2

Siehe auch

  • Last updated on