Partager via

Conventions de mise en majuscules

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.

Voir aussi