Remarque
L’accès à cette page requiert une autorisation. Vous pouvez essayer de vous connecter ou de modifier des répertoires.
L’accès à cette page requiert une autorisation. Vous pouvez essayer de modifier des répertoires.
Cet article s’applique à : ✔️ SDK .NET Core 6 et versions ultérieures
Nom
dotnet test - Pilote de test .NET utilisée pour exécuter des tests unitaires.
Descriptif
La commande dotnet test génère la solution et exécute les tests avec VSTest ou Microsoft Testing Platform (MTP). L’exécuteur de test que vous utilisez détermine les options et le comportement de ligne de commande disponibles.
Note
La sélection de l’exécuteur de test est disponible à partir du Kit de développement logiciel (SDK) .NET 10. Dans les versions antérieures de .NET, les tests sont toujours exécutés avec VSTest.
Choisir un exécuteur de tests
Avec le SDK .NET 10 et les versions ultérieures, sélectionnez Microsoft. Testing.Platform (MTP) dans le global.json fichier :
{
"test": {
"runner": "Microsoft.Testing.Platform"
}
}
Note
VSTest est une valeur valide pour l’exécuteur de test. Il s’agit de la valeur par défaut actuelle et peut être omise.
Important
L’expérience dotnet test pour MTP n’est prise en charge que dans la Microsoft.Testing.Platform version 1.7 et ultérieure.
À compter de .NET 11 Preview 6, définissez la DOTNET_TEST_RUNNER variable d’environnement pour sélectionner l’exécuteur sans modifier global.json. La variable d’environnement accepte VSTest ou Microsoft.Testing.Platform, en l’absence de cas, et remplace la global.json valeur :
$env:DOTNET_TEST_RUNNER = "Microsoft.Testing.Platform"
dotnet test
DOTNET_TEST_RUNNER=Microsoft.Testing.Platform dotnet test
Si la variable d’environnement est vide ou contient une valeur non reconnue, dotnet test utilise la global.json valeur. Si aucun paramètre ne sélectionne un exécuteur, dotnet test utilise VSTest.
Documentation sur l’exécuteur de test
Les options de ligne de commande, le comportement et les fonctionnalités disponibles diffèrent selon l’exécuteur de test que vous utilisez :
test dotnet avec VSTest - Plateforme de test traditionnelle, disponible dans le Kit de développement logiciel (SDK) .NET 6 et versions ultérieures. Il s’agit de l’exécuteur de test par défaut et uniquement dans les versions antérieures au SDK .NET 10. Fournit des fonctionnalités complètes de détection, de filtrage et de création de rapports de résultats.
test dotnet avec MTP - Plateforme de test moderne, disponible dans le Kit de développement logiciel (SDK) .NET 10 et versions ultérieures. Offre une exécution de test plus rapide et une sélection de module de test plus flexible.
Conseil / Astuce
Pour obtenir une documentation conceptuelle sur dotnet test, consultez Test avec dotnet test.