CA1702 : La casse des mots composés doit être correcte

  • Article
Élément Valeur
ID de la règle CA1702
Category Microsoft.Naming
Modification avec rupture Cassant : lorsqu’il est déclenché sur des assemblys.

Non cassant : lorsqu’il est déclenché sur les paramètres de type.

Cause

Le nom d'un identificateur contient plusieurs mots et au moins l'un des mots semble être un mot composé qui ne présente pas une casse correcte.

Remarque

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

Description de la règle

Le nom de l’identificateur est divisé en mots en se basant sur la casse. Chaque combinaison de deux mots contiguë est vérifiée par la bibliothèque du correcteur orthographique Microsoft. S’il est reconnu, l’identificateur 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 ce cas, « ToolBar » et « FileName »).

Les conventions d’affectation de noms fournissent une recherche courante 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 nom de façon à ce que la casse soit correcte.

Langage

Actuellement, le vérificateur orthographique effectue uniquement la vérification par rapport aux dictionnaires de culture basée sur l’anglais. Vous pouvez modifier la culture de votre projet dans le fichier projet en ajoutant l’élément CodeAnalysisCulture.

Par exemple :

<Project ...>
  <PropertyGroup>
    <CodeAnalysisCulture>en-AU</CodeAnalysisCulture>

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.

Voir aussi