Partager via

Utilisation des données de couverture du code fusionnées

  • Article

Mise à jour : novembre 2007

Comme décrit dans Comment : fusionner des données de couverture du code, vous pouvez fusionner les données de couverture du code obtenues via plusieurs séries de tests ou plusieurs testeurs. Vous pouvez également enregistrer le résultat de la fusion des données de couverture du code et le réimporter. Les sections suivantes décrivent certains aspects de l'utilisation des données de couverture du code.

Limitations de la fusion des résultats des tests

La liste suivante met en évidence les limitations que vous pouvez être le plus souvent amené à rencontrer lorsque vous fusionnez et importez des données de couverture :

  • Importation de données XML - Si vous importez des données de couverture du code à partir d'un fichier XML, vous ne pouvez consulter que les statistiques de la couverture de ligne et pas celles de la couverture de bloc. Pour plus d'informations, consultez Exportation et importation de résultats de tests fusionnés.

  • Fusion de données à partir de séries de tests - Si vous fusionnez les résultats des tests qui incluent des séries de tests ASP.NET, les données des artefacts ASP.NET sont affichées dans la fenêtre Résultats de la couverture du code, sous un nœud séparé avec un calcul distinct. Pour plus d'informations, consultez Fusion de données à partir de résultats des tests d'ASP.NET.

  • Recompilation du code entre des séries de tests - Si vous recompilez votre code de production entre des séries de tests et que vous tentez ensuite de fusionner les résultats, la fusion risque d'échouer. Pour plus d'informations, consultez Importation de fichiers de données de couverture du code.

Exportation et importation de résultats de tests fusionnés

Après avoir fusionné des résultats de tests, vous pouvez enregistrer les résultats de l'opération de fusion en les exportant comme un fichier XML. Pour plus d'informations sur l'exportation, consultez Comment : exporter des résultats de tests.

Ce fichier XML contient toutes les données de couverture du code fusionnées que vous pouvez voir si vous réimportez le fichier. Cela inclut des statistiques sur les lignes de code et sur les blocs de code.

Remarque :

Vous pouvez configurer les colonnes de la fenêtre Couverture du code pour afficher différentes données relatives aux lignes et blocs de code, telles que le pourcentage de lignes de code qui ont été couvertes, qui n'ont pas été couvertes et qui ont été partiellement couvertes pendant les tests.

Toutefois, si vous réimportez ce fichier XML, puis que vous le fusionniez avec des données de couverture du code supplémentaires, seules les statistiques sur la couverture des lignes sont conservées, et non celles sur la couverture des blocs.

Fusion de données à partir de résultats des tests d'ASP.NET

Vous pouvez fusionner des résultats qui incluent une ou plusieurs séries de tests ASP.NET, mais la fenêtre Résultats de la couverture du code affiche des données ASP.NET sous Résultats fusionnés dans des nœuds distincts, plutôt que dans un seul nœud fusionné. Autrement dit, bien que des données de toutes les séries de tests sélectionnées soient affichées, y compris celles incluant des tests ASP.NET, aucun calcul statistique n'est exécuté pour fusionner les données de couverture du code ASP.NET. Cela signifie que des données pour des tests ASP.NET sont affichées dans un nœud distinct pour chaque série de tests, et non fusionnées ensemble sous un nœud.

Cette limitation s'applique uniquement aux artefacts ASP.NET. Pendant les séries de tests ASP.NET, les données de couverture du code peuvent être rassemblées lorsque d'autres fichiers binaires sont testés, y compris les DLL que référence votre projet ASP.NET et les assemblys qui ont été ajoutés à votre projet ASP.NET. Dans ces cas, les données de couverture du code pour un fichier binaire particulier sont affichées dans un seul nœud fusionné sous Résultats fusionnés.

Importation de fichiers de données de couverture du code

Lorsque des données de couverture du code sont collectées, elles sont stockées dans leur format natif dans un fichier qui a l'extension .coverage. Lorsque vous consultez des données de couverture du code après une série de tests, Visual Studio les affiche en ouvrant le fichier .coverage obtenu. En outre, Visual Studio est associé à l'extension de nom de fichier .coverage, ce qui signifie que si vous double-cliquez sur un tel fichier dans l'Explorateur Windows, le fichier s'ouvre automatiquement dans Visual Studio.

Les données de résultat de tests, y compris les données de couverture du code, sont stockées au format XML uniquement lorsque vous les exportez de manière explicite. La seule raison d'exporter des données de couverture du code comme un fichier XML est d'enregistrer les résultats de la fusion de plusieurs résultats de couverture du code.

Vous pouvez importer un fichier .coverage, en utilisant le bouton Importer sur la barre d'outils de la fenêtre Résultats de la couverture du code. Si vous le faites, notez les éléments suivants :

  • Pour ouvrir un fichier .coverage, Visual Studio doit être en mesure de rechercher sur le disque les assemblys instrumentés et leurs fichiers de base de données de débogage de programme, qui ont l'extension .pdb.

  • Lors de l'importation de ce type de fichier, Visual Studio recherche le répertoire qui contient le fichier .coverage et le répertoire qui a contenu les assemblys lorsqu'ils ont été testés. Pour cela, Visual Studio utilise les variables _NT_SYMBOL_PATH et VSCOVER_BINPATH. Si la variable _NT_SYMBOL_PATH a pour valeur le répertoire qui contient des symboles et si la variable VSCOVER_BINPATH a pour valeur le répertoire qui contient les assemblys, Visual Studio peut trouver les fichiers et ouvrir le fichier .coverage. Mais si Visual Studio ne parvient pas à trouver les symboles ou les assemblys dans les chemins d'accès mentionnés, le fichier .coverage ne peut pas être ouvert. Il est préférable que vous connaissiez l'importance de ces chemins d'accès et de ces variables si vous essayez d'importer un fichier .coverage directement.

  • Les fichiers XML qui contiennent des résultats de tests ne présentent pas ce comportement. Le fichier XML est indépendant et ne requiert pas l'ouverture d'assemblys ou de fichiers .pdb.

  • Si vous importez plusieurs fichiers .coverage, vous serez en mesure de consulter des statistiques dans les blocs et les lignes. Toutefois, si vous importez des données de couverture du code dans les deux formats de fichiers (à savoir .coverage et XML), vous ne verrez que des statistiques de couverture de lignes, et non de blocs.

Voir aussi

Tâches

Comment : obtenir des données de couverture du code

Comment : fusionner des données de couverture du code

Comment : exporter des résultats de tests

Comment : importer des résultats de tests