Ausführen von Komponententests mithilfe des Test-Explorers

Verwenden Sie Test-Explorer, um Komponententests aus Visual Studio- oder Komponententestprojekten von Drittanbietern auszuführen. Im Test-Explorer können Sie Tests in Kategorien gruppieren, die Testliste filtern und Wiedergabelisten von Tests erstellen, speichern und ausführen. Sie können auch den Test-Explorer verwenden, um Komponententests zu debuggen und in Visual Studio Enterprise Code Coverage zu analysieren.

Der Test-Explorer kann Tests aus mehreren Testprojekten in einer Lösung und aus Testklassen ausführen, die Teil des Produktionscodes sind. Testprojekte können verschiedene Komponententestframeworks verwenden. Wenn der Testcode für .NET geschrieben wird, kann das Testprojekt in jeder Sprache geschrieben werden, die auch auf .NET ausgerichtet ist, unabhängig von der Sprache des Zielcodes. Sie müssen systemeigene C- und C++-Codeprojekte mit einem C++-Komponententestframework testen.

Erstellen Des Testprojekts

Wenn Sie noch kein Testprojekt in Ihrer Visual Studio-Projektmappe eingerichtet haben, müssen Sie zuerst ein Testprojekt erstellen und kompilieren. Verwenden Sie die folgenden Ressourcen:

• Erste Schritte mit Komponententests (.NET)
• Schreiben von Komponententests für C/C++-

Visual Studio enthält die Microsoft-Komponententestframeworks für verwalteten und systemeigenen Code. Der Test-Explorer kann jedoch auch jedes Komponententestframework ausführen, das einen Test-Explorer-Adapter implementiert hat. Weitere Informationen zum Installieren von Komponententestframeworks von Drittanbietern finden Sie unter Installieren von Komponententestframeworks.

Ausführen von Tests im Test-Explorer

Wenn Sie das Testprojekt erstellen, werden die Tests im Test-Explorer angezeigt. Wenn der Test-Explorer nicht sichtbar ist, wählen Sie Test- im Visual Studio-Menü aus, und wählen Sie dann Test-Explorer (oder STRG+E, T) aus.

Während Sie Ihre Tests ausführen, schreiben und erneut ausführen, zeigt der Test-Explorer die Ergebnisse in einer Standardgruppierung von Project, Namespace-und Classan. Sie können die Art und Weise ändern, wie Test-Explorer Ihre Tests gruppiert.

Sie können einen Großteil der Arbeit zum Suchen, Organisieren und Ausführen von Tests über die Symbolleiste Test-Explorer ausführen.

Ausführen von Tests

Wählen Sie eine der folgenden Optionen für die Ausführung von Tests aus:

• Um alle Tests in einer Lösung auszuführen, wählen Sie das Symbol Alle Tests ausführen (oder STRG+R, V).

• Wenn Sie alle Tests in einer Standardgruppe ausführen möchten, wählen Sie das Symbol Ausführen aus, und wählen Sie dann die Gruppe im Menü aus.

• Wenn Sie einzelne Tests ausführen möchten, wählen Sie einen oder mehrere Tests aus, klicken Sie mit der rechten Maustaste auf eine beliebige Stelle im Bereich, und wählen Sie dann "Ausgewählte Tests ausführen" aus (oder drücken Sie STRG+R, T).

  Wenn einzelne Tests keine Abhängigkeiten aufweisen, die verhindern, dass sie in einer beliebigen Reihenfolge ausgeführt werden, aktivieren Sie die parallele Testausführung im Menü "Einstellungen" der Symbolleiste. Diese Aktion kann die Zeit für die Ausführung aller Tests reduzieren.

Anmerkung

Informationen zum Konfigurieren der Zielplattform (Prozessarchitektur) für die Ausführung von Komponententests finden Sie unter Konfigurieren der Prozessarchitektur für einen Komponententest.

Ausführen von Tests nach jedem Build

Wenn Sie die Komponententests nach jedem lokalen Build ausführen möchten, wählen Sie auf der Symbolleiste "Test-Explorer" das Symbol "Einstellungen" aus, und wählen Sie dann "Tests nach Buildausführen" aus.

Anzeigen von Testergebnissen

Während Sie Ihre Tests ausführen, schreiben und erneut ausführen, zeigt der Test-Explorer die Ergebnisse in Gruppen von fehlgeschlagenen Tests, bestandenen Tests, übersprungenen Testsund nicht ausgeführten Tests. Der Detailbereich unten oder seitlich im Test-Explorer zeigt eine Zusammenfassung der Testausführung an.

Anzeigen von Testdetails

Um die Details eines einzelnen Tests anzuzeigen, wählen Sie den Test aus.

Der Bereich für Testdetails zeigt Folgendes an:

• Der Name der Quelldatei und die Zeilennummer der Testmethode.

• Der Status des Tests.

• Die verstrichene Zeit, die die Testmethode für die Ausführung benötigte.

Wenn der Test fehlschlägt, zeigt der Detailbereich auch Folgendes an:

• Die Meldung, die das Unit-Test-Framework für den Test zurückgibt.

• Stapelüberwachung zum Zeitpunkt des Testfehlers

Anzeigen des Quellcodes einer Testmethode

Wenn Sie den Quellcode für eine Testmethode im Visual Studio-Editor anzeigen möchten, klicken Sie mit der rechten Maustaste auf den Test, und wählen Sie dann "Test öffnen" aus (oder wählen Sie die F12-Taste aus).

Gruppieren und Filtern der Testliste

Im Test-Explorer können Sie Ihre Tests in vordefinierte Kategorien gruppieren. Mit den meisten Komponententestframeworks, die im Test-Explorer ausgeführt werden, können Sie ihre eigenen Kategorien und Kategorie-Wert-Paare definieren, um Ihre Tests zu gruppieren. Sie können die Testliste auch durch das Vergleichen von Zeichenfolgen mit Testeigenschaften filtern.

Gruppieren von Tests in der Testliste

Mit dem Test-Explorer können Sie Ihre Tests in eine Hierarchie gruppieren. Die Standardmäßige Hierarchiegruppierung ist Project, Namespace-und dann Class. Um die Organisation von Tests zu ändern, wählen Sie die Schaltfläche Gruppieren nach () und anschließend ein neues Gruppierungskriterium aus.

Sie können Ihre eigenen Hierarchieebenen wie die Gruppierung nach Status und anschließend Klassen definieren, indem Sie Gruppieren nach in Ihrer bevorzugten Reihenfolge auswählen.

Test-Explorer-Gruppen

Gruppe	Beschreibung
Dauer	Gruppentests nach Ausführungszeit: Fast, Mittlere, Langsame.
Zustand	Gruppiert Tests nach Ausführungsergebnissen: Fehlgeschlagene Tests, Übersprungene Tests, bestandene Tests, Nicht ausführen.
Zielframework	Gruppiert Tests nach dem Zielframework der Projekte
Namespace	Gruppiert Tests nach dem zugehörigen Namespace.
Projekt	Gruppiert Tests nach dem enthaltenden Projekt
Klasse	Gruppiert Tests nach der enthaltenden Klasse.

Charakterzüge

Ein Merkmal ist in der Regel ein Kategoriename/Wertpaar, kann aber auch eine einzelne Kategorie sein. Eigenschaften können Methoden zugewiesen werden, die vom Komponententestframework als Testmethoden identifiziert werden.

Ein Komponententestframework kann Traitkategorien definieren. Außerdem können Sie den Merkmalskategorien Werte hinzufügen, um eigene Kategoriename/Wert-Paare zu definieren. Das Komponententestframework definiert die Syntax zum Angeben von Eigenschaftskategorien und -werten.

Eigenschaften im Microsoft Unit Testing Framework für verwalteten Code

Im Microsoft Unit Testing Framework für verwalteten Code definieren Sie ein Eigenschaftsnamen-Wert-Paar in einem TestPropertyAttribute-Attribut. Das Testframework enthält auch diese vordefinierten Merkmale:

Charakterzug	Beschreibung
OwnerAttribute	Die Owner-Kategorie wird vom Unit-Test-Framework definiert und erfordert, dass Sie einen Zeichenkettenwert des Besitzers angeben.
PriorityAttribute	Die Priority Kategorie wird vom Komponententestframework definiert und erfordert, dass Sie einen ganzzahligen Wert der Priorität angeben.
TestCategoryAttribute	Mit dem attribut TestCategory können Sie die Kategorie eines Komponententests angeben.
TestPropertyAttribute	Mit dem Attribut TestProperty können Sie ein Kategorie-Wert-Paar definieren.

Merkmale im Microsoft Unit Testing Framework für C++

Siehe Verwenden des Microsoft Unit Testing Framework für C++ in Visual Studio.

Erstellen benutzerdefinierter Wiedergabelisten

Sie können eine Liste der Tests erstellen und speichern, die Sie als Gruppe ausführen oder anzeigen möchten. Wenn Sie eine Wiedergabeliste auswählen, werden die Tests in der Liste auf einer neuen Registerkarte "Test-Explorer" angezeigt. Sie können einem Test mehrere Wiedergabelisten hinzufügen.

So erstellen Sie eine Wiedergabeliste:

1. Wählen Sie einen oder mehrere Tests im Test-Explorer aus.
2. Klicken Sie im Bereich mit der rechten Maustaste auf eine beliebige Stelle, zeigen Sie auf Zu Wiedergabeliste hinzufügen, und wählen Sie dann Neue Wiedergabeliste aus.

Die Wiedergabeliste wird auf einer neuen Registerkarte "Test-Explorer" geöffnet. Sie können diese Wiedergabeliste einmal verwenden und dann verwerfen. Alternativ können Sie auf der Symbolleiste des Wiedergabelistenfensters die Schaltfläche speichern auswählen und dann einen Namen und speicherort auswählen, um die Wiedergabeliste zu speichern.

So öffnen Sie eine Wiedergabeliste:

1. Wählen Sie auf der Visual Studio-Symbolleiste das Wiedergabelistensymbol aus.
2. Wählen Sie im Menü eine zuvor gespeicherte Wiedergabelistendatei aus.

Verwenden Sie zum Bearbeiten einer Wiedergabeliste eine der folgenden Optionen:

• Klicken Sie mit der rechten Maustaste auf einen beliebigen Test, und verwenden Sie dann die Menübefehle, um ihn einer Wiedergabeliste hinzuzufügen oder daraus zu entfernen.

• Wählen Sie auf der Symbolleiste die Schaltfläche Wiedergabeliste bearbeiten aus. Kontrollkästchen, die neben Ihren Tests angezeigt werden, zeigen, welche Tests in der Wiedergabeliste enthalten und ausgeschlossen sind. Bearbeiten Sie Gruppen nach Bedarf. Diese Funktion wurde in Visual Studio 2019, Version 16.7, gestartet.

  

Sie können auch die Felder für die übergeordneten Gruppen in der Hierarchie auswählen oder löschen. Diese Aktion erstellt eine dynamische Wiedergabeliste, die die Wiedergabeliste basierend auf den Tests in dieser Gruppe immer aktualisiert.

Wenn Sie beispielsweise ein Kontrollkästchen neben einer Klasse aktivieren, wird jeder test, der dieser Klasse hinzugefügt wurde, Teil dieser Wiedergabeliste. Wenn Sie einen Test aus dieser Klasse löschen, wird er aus der Wiedergabeliste entfernt.

Weitere Informationen zu den Regeln finden Sie, indem Sie die Playlist über die Schaltfläche Speichern auf der Symbolleiste speichern und dann die .playlist XML-Datei öffnen, die auf dem Datenträger erstellt wird. Diese Datei listet alle Regeln und einzelnen Tests auf, aus denen eine Wiedergabeliste besteht.

Wenn Sie eine Wiedergabeliste für Merkmale erstellen möchten, verwenden Sie das folgende Format für das MSTest-Framework:

<Playlist Version="2.0">
  <Rule Name="Includes" Match="Any">
    <Property Name="Trait" Value="SchemaUpdateBasic" />
  </Rule>
</Playlist>

Verwenden Sie das folgende Format für das xUnit-Framework. Stellen Sie sicher, dass zwischen ihrem TestCategory Namen und dem [Value] Wert ein Leerzeichen vorhanden ist.

<Playlist Version="2.0">
  <Rule Name="Includes" Match="Any">
    <Rule Match="All">
      <Property Name="Solution" />
        <Rule Match="Any">
            <Property Name="Trait" Value="TestCategory [Value]" />
        </Rule>
    </Rule>
  </Rule>
</Playlist>

Test-Explorer-Spalten

Gruppen sind im Test-Explorer außerdem als Spalten zusammen mit Eigenschaften, Stapelüberwachung, Fehlermeldung und Vollqualifizierter Name verfügbar. Die meisten Spalten sind standardmäßig nicht sichtbar. Sie können anpassen, welche Spalten angezeigt werden.

Spalten können gefiltert, neu angeordnet und sortiert werden:

• Um nach bestimmten Merkmalen zu filtern, wählen Sie oben in der Spalte Eigenschaften das Filtersymbol aus.

  

• Wenn Sie die Reihenfolge der Spalten ändern möchten, wählen Sie eine Spaltenüberschrift aus, und ziehen Sie sie nach links oder rechts.

• Um eine Spalte zu sortieren, wählen Sie die Spaltenüberschrift aus. Nicht alle Spalten können sortiert werden. Sie können auch nach einer sekundären Spalte sortieren, indem Sie die UMSCHALTTASTE gedrückt halten und eine zusätzliche Spaltenüberschrift auswählen.

  

Suchen und Filtern der Testliste

Sie können auch Test-Explorer-Suchfilter verwenden, um die Testmethoden in Ihren Projekten einzuschränken, die Sie anzeigen und ausführen.

Wenn Sie im Suchfeld Test-Explorer eine Zeichenfolge eingeben und die EINGABETASTE auswählen, wird die Testliste so gefiltert, dass nur Tests angezeigt werden, deren vollqualifizierte Namen die Zeichenfolge enthalten.

So filtern Sie nach einem anderen Kriterium:

1. Öffnen Sie die Dropdownliste rechts neben dem Suchfeld.

2. Wählen Sie ein neues Kriterium aus.

3. Geben Sie den Filterwert zwischen den Anführungszeichen ein. Wenn Sie nach einer exakte Übereinstimmung für die Zeichenfolge anstatt einer enthaltenden Entsprechung suchen möchten, verwenden Sie das Gleichheitszeichen (=) anstelle des Doppelpunkts (:).

Anmerkung

Bei Suchvorgängen wird die Groß-/Kleinschreibung nicht beachtet, und die angegebene Zeichenfolge wird einem beliebigen Teil des Kriteriumswerts zugeordnet.

Qualifizierer	Beschreibung
Zustand	Durchsucht die Test-Explorer-Kategorienamen nach Übereinstimmungen: Tests mit Fehlern, Übersprungene Testsund Bestandene Tests
Merkmale	Durchsucht Kategorien und Werte nach Übereinstimmungen Das Komponententestframework definiert die Syntax zum Angeben von Eigenschaftskategorien und -werten.
Vollqualifizierter Name	Durchsucht die vollqualifizierten Namen von Testnamespaces, Klassen und Methoden nach Übereinstimmungen
Projekt	Durchsucht die Namen des Testprojekts nach Übereinstimmungen.
Zielframework	Durchsucht die Testframeworks nach Übereinstimmungen
Namespace	Durchsucht die Testnamespaces nach Übereinstimmungen.
Klasse	Durchsucht die Testklassennamen nach Übereinstimmungen

Verwenden Sie die folgende Syntax, um eine Teilmenge der Ergebnisse eines Filters auszuschließen:

FilterName:"Criteria" -FilterName:"SubsetCriteria"

Beispielsweise gibt FullName:"MyClass" - FullName:"PerfTest" alle Tests zurück, die "MyClass" in ihren Namen einschließen, mit Ausnahme von Tests, die auch "PerfTest" in ihrem Namen enthalten.

Analysieren der Code Coverage für Komponententests

Sie können die Menge des Produktcodes ermitteln, den Ihre Komponententests tatsächlich testen, indem Sie das Visual Studio Code-Abdeckungstool verwenden, das in Visual Studio Enterprise verfügbar ist. Sie können die Codeabdeckung für ausgewählte Tests oder für alle Tests in einer Lösung ausführen.

So führen Sie die Codeabdeckung für Testmethoden in einer Lösung aus:

• Klicken Sie im Test-Explorer mit der rechten Maustaste, und wählen Sie anschließend Code Coverage für ausgewählte Tests analysieren aus.

Im Fenster Code Coverage-Ergebnisse wird der Prozentsatz der durchlaufenen Produktcodeblöcke nach Zeile, Funktion, Klasse, Namespace und Modul angezeigt.

Weitere Informationen finden Sie unter Verwenden von Code Coverage zum Bestimmen des Umfangs des zu testenden Codes.

Tastenkombinationen für Tests

Sie können Tests im Test-Explorer entweder ausführen:

• Klicken Sie im Code-Editor mit der rechten Maustaste auf einen Test, und wählen Sie dann Test ausführen
• Verwenden der standardmäßigen Test-Explorer-Tastenkombinationen in Visual Studio

Einige der Tastenkombinationen sind kontextbasiert. Sie führen Tests zum Debuggen oder Profilen basierend auf der Position des Cursors im Code-Editor aus. Wenn sich der Cursor in einer Testmethode befindet, wird diese Testmethode ausgeführt. Wenn sich der Cursor auf Klassenebene befindet, werden alle Tests in dieser Klasse ausgeführt. Das gleiche Verhalten gilt für die Namespaceebene.

Häufige Befehle	Tastenkombinationen
TestExplorer.DebugAllTestsInContext	STRG+R, STRG+T
TestExplorer.RunAllTestsInContext	STRG+R, T
TestExplorer.RunAllTests	STRG+R, A
TestExplorer.RepeatLastRun	STRG+R, L

Anmerkung

Sie können keinen Test in einer abstrakten Klasse ausführen, da Tests nur in abstrakten Klassen definiert und nicht instanziiert werden. Um Tests in abstrakten Klassen auszuführen, erstellen Sie eine Klasse, die von der abstrakten Klasse abgeleitet wird.

Einrichten von Audiohinweisen

Der Test-Explorer kann einen der folgenden Sounds wiedergeben, wenn eine Testausführung abgeschlossen ist:

• Ein Ton, der anzeigt, dass der Testrun mit allen bestandenen Tests erfolgreich war
• Ein Sound, der angibt, dass die Testausführung mit mindestens einem fehlerhaften Test abgeschlossen wurde

Sie können diese Sounds im Standardmäßigen Windows 11 Sound Dialogfeld einrichten. Dieses Feature ist ab Visual Studio 2019 Update 16.9 Preview 3 verfügbar.

1. Öffnen Sie das Standarddialogfeld Sound von Windows 11.
2. Wechseln Sie zur Registerkarte Sounds.
3. Suchen Sie die Kategorie Microsoft Visual Studio. Wählen Sie die vordefinierten Sounds Testlauf erfolgreich oder Fehler beim Testlauf aus, oder navigieren Sie zu Ihrer eigenen Audiodatei.

Verwandte Inhalte

• Ausführen von Komponententests für Code
• Debuggen von Komponententests mit dem Test-Explorer
• Ausführen eines Komponententests als 64-Bit-Prozess
• Test-Explorer – Häufig gestellte Fragen