Les identificateurs ne doivent pas porter un suffixe incorrect
Mise à jour : novembre 2007
TypeName |
IdentifiersShouldNotHaveIncorrectSuffix |
CheckId |
CA1711 |
Catégorie |
Microsoft.Naming |
Modification avec rupture |
Oui |
Cause
Le suffixe d'un identificateur est inexact.
Description de la règle
Par convention, seuls les noms des types qui étendent certains types de base ou qui implémentent certaines interfaces, ou les types dérivés de ces types, doivent se terminer par des suffixes réservés spécifiques. Les autres noms de types ne doivent pas utiliser ces suffixes réservés.
Le tableau suivant répertorie les suffixes réservés et les types et interfaces de base auxquels ils sont associés.
Suffixe |
Type de base/interface |
---|---|
Attribute |
|
Collection |
System.Collections.ICollection System.Collections.IEnumerable |
Dictionary |
|
EventArgs |
|
EventHandler |
Délégué de gestionnaire d'événements. |
Exception |
|
Permission |
|
Queue |
|
Stack |
|
Stream |
De plus, les suffixes suivants ne doivent pas être utilisés :
Délégué
Enum
Impl - utiliser 'Principal' à la place
Ex ou suffixe semblable pour le distinguer d'une version antérieure du même type
Les conventions d'affectation des noms confèrent un aspect commun aux bibliothèques qui ciblent le Common Language Runtime. Elles réduisent ainsi la durée de l'apprentissage requis par les nouvelles bibliothèques de logiciels et confirment au client que la bibliothèque a été développée par une personne compétente en matière de développement de code managé.
Comment corriger les violations
Supprimez le suffixe du nom du type.
Quand supprimer les avertissements
Ne supprimez aucun avertissement de cette règle.
Règles connexes
Les identificateurs doivent être dotés d'un suffixe correct