Conventions de mise en majuscules
La plupart des conventions d'affectation de noms sont liées à la casse des identificateurs. Il est important de noter que le Common Language Runtime (CLR) prend en charge des langages qui respectent ou non la casse. Les conventions de mise en majuscules décrites dans cette rubrique aident les développeurs à comprendre et à utiliser une bibliothèque.
Styles de casse
Les termes suivants décrivent plusieurs façons d'appliquer une casse à des identificateurs.
Casse Pascal
La première lettre de l'identificateur et la première lettre de chaque mot concaténé suivant sont en majuscules. Vous pouvez utiliser la casse Pascal pour les identificateurs comportant trois caractères ou plus. Par exemple :
BackColor
Casse mixte
La première lettre de l'identificateur est en minuscules et la première lettre de chaque mot concaténé suivant est en majuscules. Par exemple :
backColor
Majuscules
Toutes les lettres de l'identificateur sont en majuscules. Par exemple :
IO
Règles de mise en majuscules pour les identificateurs
Lorsqu'un identificateur se compose de plusieurs mots, n'utilisez pas de séparateurs, tels que les traits de soulignement (« _ ») ou les traits d'union (« - »), entre les mots. Utilisez plutôt la casse pour indiquer le début de chaque mot.
Les instructions suivantes fournissent les règles générales relatives aux identificateurs.
Utilisez la casse Pascal pour tous les noms d'espaces de noms, de types et de membres publics composés de plusieurs mots.
Notez que cette règle ne s'applique pas aux champs d'instance. Pour les raisons décrites dans Instructions de conception des membres, vous ne devez pas utiliser des champs d'instance publics.
Utilisez la casse mixte pour les noms de paramètres.
Le tableau suivant récapitule les règles de mise en majuscules et donne des exemples pour différents types d'identificateurs.
Identificateur |
Case |
Exemple |
|---|---|---|
Classe |
Pascal |
AppDomain |
Type énumération |
Pascal |
ErrorLevel |
Valeurs d'énumération |
Pascal |
FatalError |
Événement |
Pascal |
ValueChanged |
Classe d'exceptions |
Pascal |
WebException |
Champ statique en lecture seule |
Pascal |
RedValue |
Interface |
Pascal |
IDisposable |
Méthode |
Pascal |
ToString |
Espace de noms |
Pascal |
System.Drawing |
Paramètre |
Casse mixte |
typeName |
Propriété |
Pascal |
BackColor |
Règles de mise en majuscules pour les acronymes
Un acronyme est un mot composé de lettres de mots appartenant à une expression. Par exemple, HTML est l'acronyme de Hypertext Markup Language. Vous ne devez inclure des acronymes dans les identificateurs que dans le cas où ils sont connus et bien compris. Les acronymes diffèrent des abréviations en cela qu'une abréviation raccourcit un mot unique. Par exemple, ID est une abréviation de identifier. En général, les noms de bibliothèques ne doivent pas utiliser d'abréviations.
Notes
Les deux abréviations qui peuvent être utilisées dans les identificateurs sont ID et OK.Dans le cas d'identificateurs utilisant la casse Pascal, elles doivent se présenter sous la forme Id et Ok.Si elles sont utilisées comme premier mot dans un identificateur à casse mixte, elles doivent se présenter respectivement sous la forme id et ok.
La casse des acronymes dépend de la longueur de l'acronyme. Tous les acronymes comportent au moins deux caractères. Dans le cadre de ces instructions, si un acronyme comporte uniquement deux caractères, il est considéré comme un acronyme court et un acronyme de trois caractères ou plus comme un acronyme long.
Les instructions suivantes spécifient la casse adaptée aux acronymes courts et longs. Les règles de casse des identificateurs priment les règles de casse des acronymes.
Capitalisez les deux caractères des acronymes de deux caractères, sauf le premier mot d'un identificateur de casse mixte.
Une propriété nommée DBRate est un exemple d'acronyme court (DB) utilisé comme premier mot d'un identificateur à casse Pascal. Un paramètre nommé ioChannel est un exemple d'acronyme court (IO) utilisé comme premier mot d'un identificateur à casse mixte.
Capitalisez uniquement le premier caractère des acronymes de trois caractères ou plus, sauf le premier mot d'un identificateur à casse mixte.
Une classe nommée XmlWriter est un exemple d'acronyme long utilisé comme premier mot d'un identificateur à casse Pascal. Un paramètre nommé htmlReader est un exemple d'acronyme long utilisé comme premier mot d'un identificateur à casse mixte.
Ne capitalisez aucun caractère d'acronymes, quelle que soit leur longueur, au début d'un identificateur à casse mixte.
Un paramètre nommé xmlStream est un exemple d'acronyme long (xml) utilisé comme premier mot d'un identificateur à casse mixte. Un paramètre nommé dbServerName est un exemple d'acronyme court (db) utilisé comme premier mot d'un identificateur à casse mixte.
Règles de mise en majuscules pour les mots composés et les termes courants
Ne capitalisez pas chaque mot dans les mots composés fermés. Il s'agit de mots composés écrits comme un mot unique, par exemple « endpoint ».
Par exemple, hashtable est un mot composé fermé qui doit être considéré comme un mot unique et avoir une casse appropriée. Dans la casse Pascal, il est présent sous la forme Hashtable et dans la casse mixte, sous la forme hashtable Pour déterminer si un mot est un mot composé fermé, vérifiez un dictionnaire récent.
La liste suivante identifie quelques termes courants qui ne sont pas des mots composés fermés. Le mot est affiché avec une casse Pascal, suivi de sa forme à casse mixte entre parenthèses.
BitFlag (bitFlag)
FileName (fileName)
LogOff (logOff)
LogOn (logOn)
SignIn (signIn)
SignOut (signOut)
UserName (userName)
WhiteSpace (whiteSpace)
Respect de la casse
Les règles de mise en majuscules ont pour seul but de simplifier la lecture et l'identification des identificateurs. La casse ne peut pas être utilisée pour éviter des collisions de noms entre des éléments de bibliothèque.
Ne supposez pas que tous les langages de programmation respectent la casse. Ce n'est pas le cas. La casse seule ne permet pas de distinguer les noms.
Portions Copyright 2005 Microsoft Corporation. Tous droits réservés.
Portions Copyright Addison-Wesley Corporation. Tous droits réservés.
Pour plus d'informations sur les règles de conception, consultez « règles de conception d'infrastructure : Conventions idiomes et modèles carnet de bibliothèques réutilisables framework » Krzysztof Cwalina et Brad Abrams, publiés par Addison-Wesley, 2005.
Voir aussi
Autres ressources
Instructions de conception pour le développement de bibliothèques de classes