Activer ou installer des analyseurs .NET internes

Les analyseurs .NET Compiler Platform (Roslyn) inspectent la qualité et les problèmes de styles de code de votre code C# ou Visual Basic. Les analyseurs .NET internes sont indépendants de la plateforme cible. Autrement dit, votre projet n’a pas besoin de cibler une plateforme .NET spécifique. Les analyseurs fonctionnent pour les projets qui ciblent net5.0 et les versions antérieures de .NET telles que netcoreapp, netstandard et net472.

Vous pouvez activer ou installer les analyseurs .NET internes de l’une des manières suivantes :

  • Activer à partir du SDK .NET : À partir de Visual Studio 2019 version 16.8 et .NET 5.0, ces analyseurs sont inclus dans le SDK .NET qui est compris avec Visual Studio. L’analyse est activée par défaut pour les projets ciblant .NET 5.0 (ou version ultérieure). Vous pouvez activer l’analyse du code sur les projets ciblant des versions antérieures de .NET en affectant à la propriété MSBUILD EnableNETAnalyzers la valeur true. Vous pouvez aussi désactiver l’analyse du code pour votre projet en affectant à EnableNETAnalyzers la valeur false.

  • Installer comme package NuGet : Si vous ne souhaitez pas passer au SDK .NET 5 (ou version ultérieure) ou si vous préférez un modèle basé sur un package NuGet, les analyseurs sont également disponibles dans le Microsoft.CodeAnalysis.NetAnalyzers package NuGet sur Visual Studio 2019. Vous préférerez peut-être un modèle basé sur un package pour les mises à jour de version à la demande. Si vous utilisez Visual Studio 2017, installez plutôt la dernière version 2.9.x du package Microsoft.CodeAnalysis.FxCopAnalyzers NuGet.

Notes

Il est recommandé d’activer les analyseurs à partir du Kit SDK .NET au lieu d’installer le Microsoft.CodeAnalysis.NetAnalyzers package NuGet, dans la mesure du possible. En activant les analyseurs à partir du SDK .NET, vous avez la certitude d’obtenir automatiquement les correctifs de bogue des analyseurs et les nouveaux analyseurs dès que vous mettez à jour le SDK. Dans le modèle NuGet, vous devez mettre à jour le package NuGet chaque fois que vous souhaitez obtenir les derniers correctifs de bogue. Le package NuGet est mis à jour plus fréquemment.

Migrer vers les analyseurs .NET

Si vous utilisez des analyseurs FxCop ou FxCop hérités et vous souhaitez utiliser les analyseurs .NET, suivez les instructions dans les articles suivants :