Configurer l’analyse du code en direct pour .NET

Visual Studio analyse le code de plusieurs façons pendant que vous modifiez des fichiers sources dans l’éditeur. Cette analyse est appelée analyse en arrière-plan. Ces analyses peuvent être classées comme suit, en fonction des fonctionnalités suivantes :

• Calcul en arrière-plan des diagnostics : Ce type d’analyse calcule les erreurs, les avertissements et les suggestions dans les fichiers sources. Ces diagnostics s’affichent sous forme d’entrées dans la fenêtre Liste d’erreurs et sont marqués avec des lignes éculées dans l’éditeur de code. Ils peuvent être classés dans les catégories suivantes :

  • Diagnostics du compilateur C# et Visual Basic
  • Diagnostics de l’analyseur Roslyn, notamment :
    • Analyseurs IDE intégrés pour les suggestions de style de code
    • Analyseurs d’autorité de certification intégrés pour les suggestions de qualité du code
    • Packages d’analyseur externe installés pour les projets dans la solution actuelle

• Autres analyses en arrière-plan : Ce type d’analyse améliore la réactivité et l’interaction de Visual Studio pour les fonctionnalités de l’IDE. Voici quelques exemples d’analyses :

  • Analyse en arrière-plan des fichiers ouverts
  • Compilation en arrière-plan de projets avec des fichiers ouverts pour réaliser des symboles pour améliorer la réactivité des fonctionnalités de l’IDE
  • Création de caches de syntaxe et de symboles
  • Détection de l’association du concepteur pour les fichiers sources, tels que les formulaires et les contrôles

Étendue d’analyse par défaut

Par défaut, les diagnostics du compilateur s’exécutent sur tous les documents ouverts. Dans Visual Studio 2022 et versions ultérieures, les diagnostics de l’analyseur Roslyn s’exécutent uniquement sur le document actif. Les autres analyses en arrière-plan s’exécutent pour tous les projets qui ont au moins un fichier ouvert. Certaines analyses en arrière-plan s’exécutent pour l’ensemble de la solution.

Étendue d’analyse personnalisée

L’étendue par défaut de chaque analyse en arrière-plan est paramétrée pour optimiser l’expérience utilisateur, les fonctionnalités et les performances pour la plupart des scénarios et solutions clients. Toutefois, il existe des cas où les clients peuvent souhaiter personnaliser cette étendue pour diminuer ou augmenter l’analyse en arrière-plan. Par exemple:

• Mode d’économie d’alimentation

  Si votre ordinateur fonctionne sur la batterie de l’ordinateur portable, vous pouvez réduire la consommation d’énergie pour prolonger l'autonomie de la batterie. Dans ce scénario, vous souhaitez réduire l’analyse en arrière-plan.

• Analyse du code à la demande

  Si vous préférez désactiver l’exécution de l’analyseur en direct et exécuter manuellement l’analyse du code lorsque nécessaire, vous devez réduire l’analyse en arrière-plan. Pour plus d’informations, consultez Exécuter manuellement l’analyse du code pour .NET.

• Analyse complète de la solution

  Si vous souhaitez afficher tous les diagnostics dans tous les fichiers de la solution, qu’ils soient ouverts dans l’éditeur ou non, vous pouvez maximiser l’étendue d'analyse en arrière-plan pour l’ensemble de la solution.

À compter de Visual Studio 2019, vous pouvez personnaliser explicitement l’étendue de toutes les analyses de code en direct, y compris le calcul des diagnostics, pour les projets C# et Visual Basic. Les étendues d’analyse disponibles sont les suivantes :

Scope	Descriptif
Aucun	Tous les analyseurs et correctifs de code correspondants sont désactivés. Les diagnostics du compilateur et les correctifs de code correspondants sont activés sur tous les documents ouverts .
Document actif (valeur par défaut)	Tous les analyseurs s’exécutent uniquement sur le document actif. Les diagnostics du compilateur sont activés sur tous les documents ouverts .
Ouvrir des documents	Tous les analyseurs et diagnostics du compilateur sont activés sur tous les documents ouverts .
Solution entière	Tous les analyseurs et diagnostics du compilateur sont activés sur tous les documents de la solution, qu’ils soient ouverts ou fermés.

Vous pouvez choisir l’une des étendues d’analyse personnalisées dans Options en procédant comme suit :

1. Pour ouvrir la boîte de dialogue Options, dans la barre de menus de Visual Studio, choisissez Options outils>.

2. Dans la boîte de dialogue Options, choisissez Éditeur> de texteC# (ou Visual Basic) >Avancé.

1. Sélectionnez l'étendue de l'analyse du code d'arrière-plan à partir de la liste déroulante Exécuter l'analyse de code en arrière-plan pour : afin de personnaliser la portée de l'analyse. Choisissez OK lorsque vous avez terminé.

   

Note

Avant Visual Studio 2019, vous pouvez personnaliser l'étendue de l'analyse pour le calcul des diagnostics sur l'ensemble de la solution en utilisant la case à cocher Activer l'analyse complète de la solution du menu Outils>Options>Éditeur de texte pour > (ou Visual Basic) >. Il n’existe aucune prise en charge pour réduire l'étendue de l'analyse en arrière-plan dans les versions antérieures de Visual Studio.

Réduire automatiquement l’étendue d’analyse du code en direct

Si Visual Studio détecte que 200 Mo ou moins de mémoire système sont disponibles, il réduit automatiquement l’étendue d’analyse du code en direct au document actuel. Lorsque cette situation se produit, une alerte s’affiche vous informant que Visual Studio désactive certaines fonctionnalités. Pour plus d’informations, consultez Suspension automatique des fonctionnalités.

Contenu connexe

• Suspension automatique des fonctionnalités
• Demande de la fonction du mode économie d'énergie