Arbeiten mit zusammengeführten Codeabdeckungsdaten
Wie unter Gewusst wie: Zusammenführen von Codeabdeckungsdaten erläutert, können Sie die Codeabdeckungsdaten aus mehreren Testläufen bzw. von mehreren Testern zusammenführen. Sie können auch das Ergebnis des Zusammenführens von Codeabdeckungsdaten speichern und erneut importieren. In den folgenden Abschnitten werden Aspekte der Verwendung von Codeabdeckungsdaten beschrieben.
Einschränkungen beim Zusammenführen von Testergebnissen
In der folgenden Liste sind die häufigsten Einschränkungen hervorgehoben, die beim Zusammenführen und Importieren von Abdeckungsdaten auftreten können:
Importieren von XML-Daten - Wenn sie Codeabdeckungsdaten aus einer XML-Datei importieren, können Sie nur Zeilenabdeckungsstatistiken und keine Blockabdeckungsstatistiken anzeigen. Weitere Informationen erhalten Sie unter Exportieren und Importieren von zusammengeführten Testergebnissen.
Zusammenführen von Daten aus Testläufen - Wenn zu den Testläufen, deren Ergebnisse Sie zusammenführen, ASP.NET-Testläufe zählen, werden die Daten für ASP.NET-Artefakte in dem Fenster für Codeabdeckungsergebnisse als separater Knoten angezeigt, der eine eigene Berechnung enthält. Weitere Informationen erhalten Sie unter Zusammenführen von Daten aus ASP.NET-Testergebnissen.
Erneute Codekompilierung zwischen den Testläufen - Wenn Sie ihren Produktionscode zwischen den Testläufen erneut kompilieren und danach versuchen, die Testergebnisse zusammenzuführen, schlägt die Zusammenführung möglicherweise fehl. Weitere Informationen erhalten Sie unter Importieren von Dateien mit Codeabdeckungsdaten.
Exportieren und Importieren von zusammengeführten Testergebnissen
Wenn Testergebnisse zusammengeführt wurden, können Sie die Ergebnisse des Zusammenführungsvorgangs speichern, indem Sie sie als XML-Datei exportieren. Weitere Informationen zum Exportieren finden Sie unter SO WIRD'S GEMACHT: Exportieren von Testergebnissen.
In dieser XML-Datei sind alle zusammengeführten Codeabdeckungsdaten enthalten. Sie können dies überprüfen, indem Sie die Datei erneut importieren. Dies schließt Codezeilen- und Codeblockstatistiken ein.
Tipp
Sie können die Spalten im Fenster Codeabdeckung konfigurieren, um verschiedene Daten über Codezeilen und -blöcke anzuzeigen, z. B. den Prozentsatz der im Testlauf abgedeckten, nicht abgedeckten sowie teilweise abgedeckten Codezeilen.
Wenn Sie diese XML-Datei jedoch erneut importieren und mit weiteren Codeabdeckungsdaten zusammenführen, werden nur die Zeilenabdeckungsstatistiken beibehalten, nicht die Blockabdeckungsstatistiken.
Zusammenführen von Daten aus ASP.NET-Testergebnissen
Sie können Ergebnisse zusammenführen, in denen ein oder mehrere ASP.NET-Testläufe enthalten sind. ASP.NET-Daten werden jedoch im Fenster Codeabdeckungsergebnisse unter Zusammengeführte Ergebnisse als separate Knoten und nicht in einem einzelnen, zusammengeführten Knoten angezeigt. Obwohl Daten aus allen ausgewählten Testläufen angezeigt werden, einschließlich den Testläufen mit ASP.NET-Tests, werden keine statistischen Berechnungen zum Zusammenführen von ASP.NET-Codeabdeckungsdaten durchgeführt. Daten aus ASP.NET-Tests werden daher in einem separaten Knoten für jeden Testlauf und nicht zusammengeführt unter einem Knoten angezeigt.
Diese Einschränkung gilt nur für ASP.NET-Artefakte. In ASP.NET-Testläufen können Codeabdeckungsdaten beim Testen anderer Binärdateien gesammelt werden, einschließlich DLLs, auf die im ASP.NET-Projekt verwiesen wird, und dem ASP.NET-Projekt hinzugefügte Assemblys. Hierbei werden die Codeabdeckungsdaten für die einzelnen Binärdateien unter Zusammengeführte Ergebnisse in einem einzelnen, zusammengeführten Knoten angezeigt.
Importieren von Dateien mit Codeabdeckungsdaten
Beim Sammeln von Codeabdeckungsdaten werden diese im systemeigenen Format in einer Datei mit der Erweiterung COVERAGE gespeichert. Nach einem Testlauf werden die Codeabdeckungsdaten von Visual Studio angezeigt, indem die COVERAGE-Datei mit den Ergebnissen geöffnet wird. Visual Studio ist zudem der Dateinamenerweiterung .coverage zugeordnet. Wenn Sie in Windows-Explorer auf eine solche Datei doppelklicken, wird diese daher automatisch in Visual Studio geöffnet.
Testergebnisdaten einschließlich Codeabdeckungsdaten werden nur im XML-Format gespeichert, wenn Sie die Daten explizit exportieren. Der einzige Grund für das Exportieren von Codeabdeckungsdaten als XML-Datei ist, die Ergebnisse des Zusammenführens mehrerer Codeabdeckungsergebnisse zu speichern.
Sie können COVERAGE-Dateien importieren, indem Sie auf der Symbolleiste des Fensters Codeabdeckungsergebnisse die Schaltfläche Importieren verwenden. Beachten Sie hierbei Folgendes:
Zum Öffnen einer COVERAGE-Datei muss Visual Studio die instrumentierten Assemblys und deren Programmdebug-Datenbankdateien auf dem Datenträger finden können. Diese Dateien weisen die Erweiterung PDB auf.
Beim Importieren dieses Dateityps wird das Verzeichnis mit der COVERAGE-Datei sowie das Verzeichnis, in dem die Assemblys während des Testlaufs enthalten waren, von Visual Studio durchsucht. Bei diesem Vorgang verwendet Visual Studio die Variablen _NT_SYMBOL_PATH und VSCOVER_BINPATH. Wenn die _NT_SYMBOL_PATH-Variable auf das Symbole enthaltende Verzeichnis und die VSCOVER_BINPATH-Variable auf das Verzeichnis mit den Assemblys festgelegt werden, kann Visual Studio die Dateien finden und die COVERAGE-Datei öffnen. Wenn die Symbole oder Assemblys von Visual Studio nicht unter den angegebenen Pfaden gefunden werden, kann die COVERAGE-Datei nicht geöffnet werden. Ein Verständnis der Bedeutung dieser Pfade und Variablen ist beim direkten Importieren einer COVERAGE-Datei hilfreich.
XML-Dateien mit Testergebnissen weisen dieses Verhalten nicht auf. Die XML-Datei ist in sich geschlossen und kann ohne gleichzeitiges Öffnen von Assemblys oder PDB-Dateien geöffnet werden.
Wenn Sie mehrere COVERAGE-Dateien importieren, werden sowohl Block- als auch Zeilenstatistiken angezeigt. Wenn Sie jedoch Codeabdeckungsdaten importieren, die sowohl im COVERAGE- als auch im XML-Format vorliegen, werden nur Zeilenabdeckungsstatistiken und keine Blockabdeckungsstatistiken angezeigt.
Siehe auch
Aufgaben
Gewusst wie: Erfassen von Codeabdeckungsdaten
Gewusst wie: Zusammenführen von Codeabdeckungsdaten