Conventions de mise en majusculesCapitalization Conventions

Les lignes directrices de ce chapitre présentent une méthode simple d'utilisation des cas qui, lorsqu'ils sont appliqués de façon uniforme, rendent les identificateurs pour les types, les membres et les paramètres faciles à lire.The guidelines in this chapter lay out a simple method for using case that, when applied consistently, make identifiers for types, members, and parameters easy to read.

Règles de casse des identificateursCapitalization Rules for Identifiers

Afin de distinguer les mots dans un identificateur, il faut y mettre en majuscule la première lettre de chaque mot.To differentiate words in an identifier, capitalize the first letter of each word in the identifier. N’utilisez pas de traits de soulignement pour différencier des mots, ni ailleurs à cette fin dans les identificateurs.Do not use underscores to differentiate words, or for that matter, anywhere in identifiers. Il existe deux façons appropriées d’utiliser des majuscules pour les identificateurs, en fonction de son utilisation :There are two appropriate ways to capitalize identifiers, depending on the use of the identifier:

  • PascalCasingPascalCasing

  • casseCamelcamelCasing

La convention CassePascal, 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 d’une longueur de deux lettres), comme indiqué dans les exemples suivants :The PascalCasing convention, used for all identifiers except parameter names, capitalizes the first character of each word (including acronyms over two letters in length), as shown in the following examples:

PropertyDescriptor
HtmlTag

Un cas particulier concerne des acronymes de deux lettres dans lequel les deux lettres sont en majuscules, comme indiqué dans l’identificateur suivant :A special case is made for two-letter acronyms in which both letters are capitalized, as shown in the following identifier:

IOStream

La convention casseCamel, utilisée uniquement pour les noms de paramètres, met en majuscule le premier caractère de chaque mot, sauf le premier mot, comme indiqué dans les exemples suivants.The camelCasing convention, used only for parameter names, capitalizes the first character of each word except the first word, as shown in the following examples. Comme le montre également l’exemple, les acronymes de deux lettres qui sont au début d’un identificateur à casse mixte sont tout en minuscules.As the example also shows, two-letter acronyms that begin a camel-cased identifier are both lowercase.

propertyDescriptor
ioStream
htmlTag

✓ UTILISEZ la convention CassePascal pour tous les noms de membres, de types et d’espaces de noms publics constitué de plusieurs mots.✓ DO use PascalCasing for all public member, type, and namespace names consisting of multiple words.

✓ UTILISEZ la convention casseCamel pour les noms de paramètre.✓ DO use camelCasing for parameter names.

Le tableau suivant décrit les règles de mise en majuscules pour différents types d’identificateurs.The following table describes the capitalization rules for different types of identifiers.

IdentificateurIdentifier CasseCasing ExempleExample
Espace de nomsNamespace PascalPascal namespace System.Security { ... }
TypeType PascalPascal public class StreamReader { ... }
InterfaceInterface PascalPascal public interface IEnumerable { ... }
MéthodeMethod PascalPascal public class Object {
public virtual string ToString();
}
PropriétéProperty PascalPascal public class String {
public int Length { get; }
}
ÉvénementEvent PascalPascal public class Process {
public event EventHandler Exited;
}
ChampField PascalPascal public class MessageQueue {
public static readonly TimeSpan
InfiniteTimeout;
}
public struct UInt32 {
public const Min = 0;
}
Valeur enumEnum value PascalPascal public enum FileMode {
Append,
...
}
ParamètreParameter CamelCamel public class Convert {
public static int ToInt32(string value);
}

Tirant partis de la casse des mots composés et les termes courantsCapitalizing Compound Words and Common Terms

La plupart des termes composés sont considérés comme des termes uniques à des fins de mise en majuscules.Most compound terms are treated as single words for purposes of capitalization.

X N’UTILISEZ PAS DE MAJUSCULE au début de chaque mot dans les mots composés dits fermés.X DO NOT capitalize each word in so-called closed-form compound words.

Il s’agit des mots composés écrites sous la forme d’un mot unique, comme point de terminaison.These are compound words written as a single word, such as endpoint. Pour les besoins de recommandations de la casse, traiter un fermeture mot composé comme un mot unique.For the purpose of casing guidelines, treat a closed-form compound word as a single word. Utiliser un dictionnaire en cours pour déterminer si un mot composé est écrit dans une forme fermée.Use a current dictionary to determine if a compound word is written in closed form.

PascalPascal CamelCamel Ne convient pasNot
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 casseCase Sensitivity

Les langages qui peuvent s’exécuter sur le CLR n’ont pas l’obligation de prendre en charge le respect de la casse, bien que certains le fassent.Languages that can run on the CLR are not required to support case-sensitivity, although some do. Même si votre langage le prend en charge, d'autres langages qui pourraient accéder à votre framework ne le font pas.Even if your language supports it, other languages that might access your framework do not. Les API qui sont accessibles de l'extérieur ne peuvent donc pas se fier uniquement à la casse pour distinguer deux noms dans le même contexte.Any APIs that are externally accessible, therefore, cannot rely on case alone to distinguish between two names in the same context.

X NE SUPPOSEZ PAS que tous les langages de programmation respectent la casse.X DO NOT assume that all programming languages are case sensitive. Ce n’est pas le cas.They are not. Les noms ne peuvent pas différer seulement par la casse.Names cannot differ by case alone.

Portions © 2005, 2009 Microsoft Corporation. Tous droits réservés.Portions © 2005, 2009 Microsoft Corporation. All rights reserved.

Réimprimé avec l’autorisation de Pearson éducation, Inc. à partir de instructions de conception Framework : Conventions, les idiomes et les modèles pour les bibliothèques .NET réutilisable, 2nd Edition Krzysztof Cwalina et Brad Abrams, publié le 22 octobre 2008 par Addison-Wesley Professional dans le cadre de la série de développement de Microsoft Windows.Reprinted by permission of Pearson Education, Inc. from Framework Design Guidelines: Conventions, Idioms, and Patterns for Reusable .NET Libraries, 2nd Edition by Krzysztof Cwalina and Brad Abrams, published Oct 22, 2008 by Addison-Wesley Professional as part of the Microsoft Windows Development Series.

Voir aussiSee also