Partager via


CA1711 : Les identificateurs ne doivent pas porter un suffixe incorrect

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

Attribut

Attribute

Collection

ICollection

IEnumerable

Queue

Stack

ICollection

DataSet

DataTable

Dictionary

IDictionary

IDictionary

EventArgs

EventArgs

EventHandler

Délégué de gestionnaires d'événements

Exception

Exception

Autorisation

IPermission

Queue

Queue

Stack

Stack

Stream

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 pas d'avertissement pour cette règle à moins que le suffixe n'ait une signification non équivoque dans le domaine de l'application.

Règles connexes

CA1710 : Les identificateurs doivent être dotés d'un suffixe correct

Voir aussi

Autres ressources

Attribute Usage Guidelines

Événements et délégués