Notes
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de vous connecter ou de modifier des répertoires.
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de modifier des répertoires.
Remarque
Ce contenu est réimprimé avec l’autorisation de Pearson Education, Inc. tiré de Lignes directrices de conception de framework : Conventions, Idiomes et Modèles pour les bibliothèques .NET réutilisables, 2ème édition. Cette édition a été publiée en 2008, et le livre a été entièrement révisé dans la troisième édition. Certaines informations de cette page peuvent être obsolètes.
Les instructions de ce chapitre définissent une méthode simple pour l’utilisation de cas qui, lorsqu’elles sont appliquées de manière cohérente, rendent les identificateurs pour les types, les membres et les paramètres faciles à lire.
Règles de mise en majuscule pour les identificateurs
Pour différencier les mots d’un identificateur, mettez en majuscule la première lettre de chaque mot dans l’identificateur. N’utilisez pas de traits de soulignement pour différencier les mots, ou à ce sujet, n’importe où dans les identificateurs. Il existe deux façons appropriées de mettre en majuscule les identificateurs, en fonction de l’utilisation de l’identificateur :
PascalCasing
camelCasing
La convention PascalCasing, utilisée pour tous les identificateurs, à l’exception des noms de paramètres, met en majuscule le premier caractère de chaque mot (y compris les acronymes sur deux lettres de longueur), comme illustré dans les exemples suivants :
PropertyDescriptor
HtmlTag
Un cas spécial est fait pour les acronymes à deux lettres dans lesquels les deux lettres sont majuscules, comme indiqué dans l’identificateur suivant :
IOStream
La convention camelCasing, utilisée uniquement pour les noms de paramètres, met en majuscule le premier caractère de chaque mot à l’exception du premier mot, comme illustré dans les exemples suivants. Comme l’illustre également l’exemple, les acronymes à deux lettres qui commencent un identificateur en cas de chameau sont en minuscules.
propertyDescriptor
ioStream
htmlTag
✔️ Utilisez PascalCasing pour tous les noms de membres publics, de type et d’espace de noms composés de plusieurs mots.
✔️ Utilisez le camelCasing pour les noms de paramètres.
Le tableau suivant décrit les règles de mise en majuscule pour différents types d’identificateurs.
Identificateur | Casse | Exemple : |
---|---|---|
Namespace | Pascal | namespace System.Security { ... } |
Catégorie | Pascal | public class StreamReader { ... } |
Interface | Pascal | public interface IEnumerable { ... } |
Méthode | Pascal | public class Object { public virtual string ToString(); } |
Propriété | Pascal | public class String { public int Length { get; } } |
Événement | Pascal | public class Process { public event EventHandler Exited; } |
Terrain | Pascal | public class MessageQueue { public static readonly TimeSpan InfiniteTimeout; } public struct UInt32 { public const Min = 0; } |
Valeur d’énumération | Pascal | public enum FileMode { Append, ... } |
Paramètre | Chameau | public class Convert { public static int ToInt32(string value); } |
Capitalisation des mots composés et des termes communs
La plupart des termes composés sont traités comme des mots simples à des fins de mise en majuscules.
❌ NE PAS mettre en majuscule chaque mot dans les mots composés sous forme fermée.
Il s’agit de mots composés écrits sous la forme d’un mot unique, tel que le point de terminaison. Pour les instructions de casse, traitez un mot composé de forme fermée comme un mot unique. Utilisez un dictionnaire actuel pour déterminer si un mot composé est écrit sous forme fermée.
Pascal | Chameau | Non |
---|---|---|
BitFlag |
bitFlag |
Bitflag |
Callback |
callback |
CallBack |
Canceled |
canceled |
Cancelled |
DoNot |
doNot |
Don't |
Email |
email |
EMail |
Endpoint |
endpoint |
EndPoint |
FileName |
fileName |
Filename |
Gridline |
gridline |
GridLine |
Hashtable |
hashtable |
HashTable |
Id |
id |
ID |
Indexes |
indexes |
Indices |
LogOff |
logOff |
LogOut |
LogOn |
logOn |
LogIn |
Metadata |
metadata |
MetaData, metaData |
Multipanel |
multipanel |
MultiPanel |
Multiview |
multiview |
MultiView |
Namespace |
namespace |
NameSpace |
Ok |
ok |
OK |
Pi |
pi |
PI |
Placeholder |
placeholder |
PlaceHolder |
SignIn |
signIn |
SignOn |
SignOut |
signOut |
SignOff |
UserName |
userName |
Username |
WhiteSpace |
whiteSpace |
Whitespace |
Writable |
writable |
Writeable |
Respect de la casse
Les langues qui peuvent s’exécuter sur le CLR ne sont pas requises pour prendre en charge la confidentialité de la casse, bien que certaines le fassent. Même si votre langue la prend en charge, les autres langages susceptibles d’accéder à votre infrastructure ne le font pas. Les API accessibles en externe ne peuvent donc pas compter uniquement sur la casse pour faire la distinction entre deux noms dans le même contexte.
❌ NE SUPPOSEZ PAS que tous les langages de programmation respectent la casse. Ils ne le sont pas. Les noms ne peuvent pas différer par cas seul.
Portions © 2005, 2009 Microsoft Corporation. Tous les droits réservés.
Réimprimé par l’autorisation de Pearson Education, Inc. tiré de Framework Design Guidelines : Conventions, Idioms et Patterns pour les bibliothèques .NET réutilisables, 2e édition par Krzysztof Cwalina et Brad Abrams, publié le 22 octobre 2008 par Addison-Wesley Professional dans le cadre de la Série de développement Microsoft Windows.