Remarque
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de vous connecter ou de modifier des répertoires.
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de modifier des répertoires.
| Propriété | Valeur |
|---|---|
| Identificateur de la règle | MSTEST0076 |
| Titre | Éviter de muter la culture à l’échelle du processus dans un test parallélisé |
| Category | Usage |
| Le correctif a un effet disruptif ou non disruptif | Non-breaking |
| Activé par défaut | Yes |
| Sévérité par défaut | Informations |
| Introduit dans la version | 4.4.0 |
| Existe-t-il une correction de code | No |
Note
Cet analyseur s’active uniquement lorsque la parallélisation des assemblys est activée syntaxiquement, par exemple via [assembly: Parallelize] sans [assembly: DoNotParallelize] correspondant, ou lorsqu’un fichier .editorconfig définit mstest_parallel_safety_mode = always. L’analyseur ne peut pas détecter la parallélisation activée uniquement via .runsettings ou des propriétés MSBuild telles que MSTestParallelizeWorkers. Définissez l’option .editorconfig si vous configurez la parallélisation ainsi et souhaitez toujours exécuter cet analyseur.
Cause
Un test, ou une méthode de montage délimitée par une classe dans laquelle il s’exécute, attribue DefaultThreadCurrentCulture ou DefaultThreadCurrentUICulture sans correspondance [ResourceLock] ou [DoNotParallelize].
Description de la règle
CultureInfo.DefaultThreadCurrentCulture et DefaultThreadCurrentUICulture définissent la culture par défaut de l’ensemble du processus, de sorte que chaque test exécuté simultanément subit ce changement, et le formatage ou l’analyse peuvent être faussés. Les formes par thread et ambiantes, Thread.CurrentThread.CurrentCulture/CurrentUICulture et CultureInfo.CurrentCulture/CurrentUICulture, ne sont pas signalées : dans les versions modernes de .NET, elles attribuent une valeur basée sur AsyncLocal qui se propage avec le contexte d’exécution ; elles ne corrompent donc pas les tests parallèles.
[TestMethod]
public void SetsCulture()
{
CultureInfo.DefaultThreadCurrentCulture = CultureInfo.InvariantCulture; // Violation
}
Étant donné que les setters avec indicateur sont à l’échelle du processus, la restauration de la valeur précédente dans un finally bloc n’aide pas : l’exécution simultanée de tests observe toujours la culture modifiée pendant la durée de la mutation.
Comment corriger les violations
Ajoutez [DoNotParallelize] au test, ou évitez de modifier la culture du processus entier et utilisez plutôt les propriétés de culture propres à chaque thread ou les propriétés de culture ambiante.
[DoNotParallelize]
[TestMethod]
public void SetsCulture()
{
CultureInfo.DefaultThreadCurrentCulture = CultureInfo.InvariantCulture;
}
Aucune clé connue [ResourceLock] n’existe pour la culture, donc une déclaration [ResourceLock] de n’importe quel type est traitée comme un accusé de réception que vous avez coordonné l’accès à la culture, et cette règle reste silencieuse.
Quand supprimer les avertissements
Ne supprimez pas les avertissements de cette règle sans désactiver la parallélisation ou passer aux propriétés de culture propres à chaque thread, car cela crée une concurrence silencieuse entre la mutation et les tests exécutés simultanément.
Supprimer un avertissement
Si vous voulez supprimer une seule violation, ajoutez des directives de préprocesseur à votre fichier source pour désactiver et réactiver la règle.
#pragma warning disable MSTEST0076
// The code that's violating the rule is on this line.
#pragma warning restore MSTEST0076
Pour désactiver la règle sur un fichier, un dossier ou un projet, définissez sa gravité sur none dans le fichier de configuration.
[*.{cs,vb}]
dotnet_diagnostic.MSTEST0076.severity = none
Pour plus d’informations, consultez Comment supprimer les avertissements d’analyse du code.