Noms de membres de type
Mise à jour : novembre 2007
Les types contiennent les catégories de membres suivantes :
Méthodes
Propriétés
Champs
Événements
Les instructions de cette section aident les concepteurs de bibliothèques de classes à sélectionner des noms de membres cohérents avec le .NET Framework.
Noms des méthodes
Attribuez aux méthodes des noms représentant des verbes ou des syntagmes verbaux.
Puisqu'en général les méthodes agissent sur les données, l'utilisation d'un verbe décrivant l'action de la méthode permet aux développeurs de comprendre plus facilement le rôle de la méthode. Lorsque vous définissez l'action exécutée par la méthode, veillez à sélectionner un nom clair et sans ambiguïté du point de vue du développeur. Ne sélectionnez pas un verbe expliquant comment la méthode effectue l'action requise ; en d'autres termes, n'utilisez pas de détails d'implémentation dans votre nom de méthode.
Noms des propriétés
Nommez des propriétés à l'aide d'un nom, d'un syntagme nominal ou d'un adjectif.
Les syntagmes nominaux ou les adjectifs conviennent dans le cas des propriétés car celles-ci contiennent des données.
N'utilisez pas de propriétés qui correspondent aux noms des méthodes Get.
Par exemple, n'attribuez pas le nom EmployeeRecord à une propriété et le nom GetEmployeeRecord à une méthode. Les développeurs ne sauront pas quel membre utiliser pour accomplir leur tâche de programmation.
Envisagez d'attribuer à une propriété le même nom que son type.
Dans le cas d'une propriété fortement typée en énumération, le nom de la propriété peut être identique à celui de l'énumération. Si, par exemple, vous avez une énumération nommée CacheLevel, une propriété qui retourne l'une de ses valeurs peut être également nommée CacheLevel.
Noms des événements
Utilisez deux paramètres nommés sender et e dans les signatures de gestionnaire d'événements.
Le paramètre sender doit être de type Object, et le paramètre e doit être une instance de EventArgs ou hériter de celui-ci.
Noms des champs
Les instructions concernant les noms de champs s'appliquent aux champs protégés et publics statiques. Vous ne devez pas définir de champs d'instance publics ou protégés. Pour plus d'informations, consultez Conception de champs.
N'utilisez pas de préfixe dans les noms de champs. Par exemple, n'utilisez pas g_ ou s_ pour distinguer des champs statiques et non statiques.
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 instructions de conception, consultez le livre « Framework Design Guidelines: Conventions, Idioms, and Patterns for Reusable .NET Libraries » de Krzysztof Cwalina et Brad Abrams, publié par Addison-Wesley, 2005.
Voir aussi
Autres ressources
Instructions de conception pour le développement de bibliothèques de classes