Übersicht über das Ausführen von Tests

Um Tests mit TAEF auszuführen, geben Sie die Testdateien mit dem Befehl TE.EXE an, der sich in %:\Program Files (x86)\Windows Kits\10\Testing\Runtimes\TAEF befindet. Um zum Beispiel alle Tests innerhalb der CPP.Basic.Examples.dll-Testdatei auszuführen, führen Sie aus:

TE.exe CPP.Basic.Examples.dll

Sie können mehrere Testdateien angeben, auch wenn diese Tests enthalten, die auf unterschiedliche Weise gekennzeichnet sind. Der folgende Befehl führt beispielsweise alle Tests in den Dateien CPP.Basic.Examples.dll und CSharp.Basic.Examples.dll aus, auch wenn diese in unterschiedlichen Sprachen verfasst sind:

TE.exe CPP.Basic.Examples.dll CSharp.Basic.Examples.dll

Sie können auch Platzhalter für die Auswahl der auszuführenden Dateien verwenden:

TE.exe *.Examples.dll

Und Sie können auch relative Pfade angeben:

TE.exe Examples\*

Wenn an der Eingabeaufforderung eine Datei angegeben wird, die keine Tests enthält, dann meldet TE.exe eine Fehlermeldung.

Reihenfolge der Ausführung

Die an der Eingabeaufforderung angegebenen Testdateien werden in der Reihenfolge verarbeitet, in der sie angegeben wurden.

Ausführung außerhalb des Prozesses

Standardmäßig führt TAEF die Tests außerhalb des Prozesses aus. TAEF verwendet zum Ausführen von Tests den Prozess TE.ProcessHost.exe. Dies bietet die Möglichkeit, Tests voneinander zu isolieren und zu verhindern, dass sie von früheren Tests beeinflusst werden. Um Tests im Prozess TE.exe auszuführen, geben Sie die Option „/inproc“ für TE.exe an.

Auswählen von Tests

Sie können bestimmte Tests auswählen, indem Sie die Option „/select“ verwenden und eine „Auswahlabfrage“ angeben. Wenn Sie nur nach dem Namen des Tests auswählen möchten, verwenden Sie stattdessen die Option „/name“. Weitere Informationen darüber, wie Sie die Abfrage zur Auswahl bestimmter Tests verwenden, finden Sie unter Auswahl.

Angabe eines Teils des Befehls als Umgebungsvariable: te_cmd

Wenn einige Ihrer Befehlsoptionen für te.exe immer gleich sein werden, können Sie die Umgebungsvariable te_cmd nutzen. Der auf te_cmd festgelegte Wert wird an den Befehl für die Ausführung von te.exe angehängt. Mit „set te_cmd=/list“ sehen Sie immer eine Auflistung der Tests im Vergleich zur Ausführung für die Binardateien, die an der Eingabeaufforderung festgelegt wurden.

Auflisten von Tests

Wenn Sie die Befehlsoption „/list“ zusammen mit den Testdateien angeben, werden die Namen der Klassen und Testmethoden in den Testdateien auf der Konsole aufgelistet. Beachten Sie, dass dadurch nur die Namen der Binardateien, Klassen und Testmethoden für jede angegebene Binardatei aufgelistet werden und diese nicht ausgeführt werden. Wenn Sie mehr Details auflisten möchten, wie z. B. die Setup- und Cleanup-Methoden, die Metadaten oder Eigenschaften, die auf jeder Ebene angegeben sind, und im Falle von datengesteuerten Tests die bereitgestellten Daten, verwenden Sie stattdessen die Befehlsoption „/listproperties“.

Testergebnisse

Für jeden generischen Testfall hängt das Testergebnis davon ab, ob die durchgeführten Verify-Aufrufe erfolgreich waren oder nicht. Die verfügbaren APIs und weitere Details finden Sie unter „Verify“. Wenn während des Tests kein Verify-Aufruf erfolgt, lautet das Testergebnis standardmäßig „Passed“ (Bestanden) für die mit TAEF bereitgestellten Protokollteilnehmer. Sie können bei der Erstellung des Tests explizit ein „DefaultTestResult“ angeben. Weitere Informationen finden Sie unter Verfassen von Tests.

Hilfe – Befehlsoptionen

Hier finden Sie Erklärungen zu allen verfügbaren Befehlsoptionen, indem Sie die Option „/?“ für TE.exe angeben. Erweiterte Erklärungen finden Sie unter Te.exe-Befehlsoptionen.