Partager via

CA1701 : La casse des mots composés de la chaîne de ressources doit être correcte

  • Article
Élément Valeur
ID de la règle CA1701
Category Microsoft.Naming
Modification avec rupture Sans rupture

Cause

Une chaîne de ressource contient un mot composé qui ne semble pas avoir la casse correcte.

Notes

Cette règle est déconseillée. Pour plus d’informations, consultez Règles dépréciées.

Description de la règle

Chaque mot dans la chaîne de ressource est fractionné en jetons qui sont basés sur la casse. Chaque combinaison de deux jetons contiguë est vérifiée par la bibliothèque du correcteur orthographique Microsoft. S'il est reconnu, le mot produit une violation de la règle. Les exemples de mots composés qui provoquent une violation sont « CheckSum » et « MultiPart », qui doivent avoir la casse suivante : « Checksum » et « Multipart ». En raison d’une utilisation courante, plusieurs exceptions sont intégrées à la règle, et plusieurs mots uniques sont marqués, tels que « Toolbar » et « Filename », qui doivent avoir la casse de deux mots séparés. Dans cet exemple, « ToolBar » et « FileName » sont marqués.

Les conventions de nommage fournissent une recherche commune pour les bibliothèques qui ciblent le common language runtime. Cette cohérence réduit la courbe d’apprentissage requise pour les nouvelles bibliothèques de logiciels et augmente la confiance des clients en ce qui concerne le développement de la bibliothèque par une personne qui a une expertise dans le développement de code managé.

Comment corriger les violations

Modifiez le mot de façon à ce que la casse soit correcte.

Modifier la langue du dictionnaire

Par défaut, la version anglaise (en) du vérificateur d’orthographe est utilisée. Si vous souhaitez modifier la langue du vérificateur d’orthographe, vous pouvez le faire en ajoutant l’un des attributs suivants à votre fichier AssemblyInfo.cs ou AssemblyInfo.vb :

Important

Si vous définissez la culture sur quelque chose d’autre qu’une culture basée sur l’anglais, cette règle d’analyse du code est désactivée en mode silencieux.

Quand supprimer les avertissements

Il est sûr de supprimer un avertissement de cette règle si les deux parties du mot composé sont reconnues par le dictionnaire orthographique et que l’intention est d’utiliser deux mots.

Vous pouvez également ajouter des mots composés à un dictionnaire personnalisé pour le vérificateur d’orthographe. Les mots du dictionnaire personnalisé ne génèrent pas de violations. Pour plus d’informations, consultez Guide pratique pour personnaliser le dictionnaire d’analyse du code.

Voir aussi