Partager via


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

System.Attribute

Collection

System.Collections.ICollection

System.Collections.IEnumerable

System.Collections.Queue

System.Collections.Stack

System.Collections.Generic.ICollection<T>

System.Data.DataSet

System.Data.DataTable

Dictionary

System.Collections.IDictionary

System.Collections.Generic.IDictionary<TKey, TValue>

EventArgs

System.EventArgs

EventHandler

Délégué de gestionnaire d'événements.

Exception

System.Exception

Permission

System.Security.IPermission

Queue

System.Collections.Queue

Stack

System.Collections.Stack

Stream

System.IO.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

Voir aussi

Concepts

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

Référence

Indications concernant l'utilisation des attributs